Adicionar bot ao Facebook

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Você pode adicionar seu bot ao Facebook Messenger e usar a experiência do Facebook para se envolver com seus usuários finais.

O Facebook Messenger e serviços relacionados estão sujeitos aos próprios termos e condições do Facebook. Para obter suporte relacionado ao Facebook Messenger, entre em contato diretamente com o Facebook.

Importante

Este artigo é destinado a profissionais de TI experientes que gerenciam a página do Facebook da sua organização.

Observação

Ao publicar seu bot em uma página do Facebook, alguns dos dados, como conteúdo do bot e conteúdo da conversa com o usuário final, serão compartilhados com o Facebook (o que significa que seus dados sairão dos limites geográficos ou regionais e de conformidade da sua organização).
Para obter mais informações, consulte as Políticas da Plataforma do Facebook.

Pré-requisitos

Adicionar bot ao Facebook Messenger

Você precisa de um aplicativo Facebook e uma conta de desenvolvedor associada para conectar seu bot do Power Virtual Agents ao Facebook Messenger nas suas páginas do Facebook.

Estas são as etapas do processo:

  1. Configure as configurações do aplicativo Facebook: recupere as informações do aplicativo Facebook, habilite o acesso à API, adicione o Facebook Messenger ao seu aplicativo e configure as páginas do Facebook nas quais seu aplicativo deve aparecer.

  2. Configure o canal de publicação do Facebook no Power Virtual Agents.

  3. Conecte seu aplicativo Facebook ao Power Virtual Agents (usando webhooks).

Você precisará enviar seu aplicativo para análise do Facebook para poder publicá-lo e torná-lo público.

Configurações do aplicativo Facebook

Recuperar as informações do aplicativo Facebook:

  1. Faça login no aplicativo Facebook ao qual você deseja adicionar seu bot em Facebook for Developers.

  2. Em Configurações no painel lateral do menu, selecione Básicas.

  3. Copie o ID do aplicativo e o Segredo do aplicativo. Você precisará dessas informações quando configurar o canal do Facebook no Power Virtual Agents.

    Obter o ID e o segredo do aplicativo Facebook

Ativar o acesso à API para seu aplicativo Facebook:

  1. Faça login no aplicativo Facebook ao qual você deseja adicionar seu bot em Facebook for Developers.

  2. Em Configurações no painel lateral do menu, selecione Avançadas.

  3. Verifique se a opção Permitir acesso da API às configurações do aplicativo está configurada como Sim.

  4. Selecione Salvar alterações para confirmar as alterações.

    Permitir acesso da API às configurações do aplicativo

Adicionar o Facebook Messenger ao seu aplicativo:

  1. Faça login no aplicativo Facebook ao qual você deseja adicionar seu bot em Facebook for Developers.

  2. Acesse o Painel. Na seção Adicionar um produto, selecione Configuração no bloco Messenger.

    Adicionar o produto Messenger

Configurar as páginas do Facebook:

  1. Faça login no aplicativo Facebook ao qual você deseja adicionar seu bot em Facebook for Developers.

  2. Selecione Configurações em Produtos e Messenger no painel lateral do menu.

  3. Adicione as páginas às quais você deseja adicionar o bot selecionando Adicionar ou remover páginas na seção Tokens de acesso. Você também pode criar uma nova página selecionando Criar nova página.

    Adicionar uma página do Facebook ao aplicativo Facebook

  4. Ao adicionar páginas, verifique se a opção Gerenciar e acessar conversas da página no Messenger está configurada como Sim.

    Permissão do Messenger para a página

  5. Copie o ID da página e o Token de cada página à qual você deseja adicionar o bot. Você precisará selecionar Gerar token para cada página. Você precisará dessas informações quando configurar o canal do Facebook no Power Virtual Agents.

    Obter ID da página e token

Configurar o canal do Facebook no Power Virtual Agents

  1. No Power Virtual Agents, selecione Gerenciar no painel de navegação lateral e, em seguida, acesse a guia Canais.

  2. Selecione o bloco Facebook para abrir a janela de configuração.

    Canal do Facebook

  3. Cole o ID do aplicativo, o Segredo do Aplicativo, o ID da página e o Token recuperados anteriormente em seus respectivos campos.

    Fornecer informações da página e aplicativo Facebook

  4. Pelo menos uma página é necessária, mas você pode selecionar Adicionar Página para adicionar mais páginas.

    Fornecer informações de várias páginas do Facebook

  5. Selecione Adicionar e aguarde a mensagem de confirmação. Quando a operação for bem-sucedida, copie a URL de retorno de chamada e Verificar token. Você precisará deles quando conectar seu aplicativo Facebook ao Power Virtual Agents.

    Obter informações de retorno de chamada para o Facebook

Conectar seu aplicativo Facebook ao Power Virtual Agents

  1. Faça login no aplicativo Facebook ao qual você deseja adicionar seu bot em Facebook for Developers.

  2. Selecione Configurações em Produtos e Messenger no painel lateral do menu.

  3. Na seção Webhooks, selecione Adicionar URL de retorno de chamada.

    Configurar webhooks para o aplicativo Facebook

  4. Forneça a URL de retorno de chamada e Verificar token da seção Configurar o canal do Facebook no Power Virtual Agents e selecione Verificar e salvar.

    Adicionar URL de retorno de chamada e Verificar token

  5. Selecione Adicionar assinaturas para cada página à qual você deseja adicionar o bot.

    Adicionar assinatura de webhook

  6. Selecione os seguintes campos:

    • messages
    • messaging_postbacks
    • messaging_optins
    • message_deliveries
  7. Selecione Salvar.

    Adicionar campos de assinatura de webhook

Enviar para análise do Facebook

Você precisará enviar seu aplicativo para análise do Facebook para torná-lo público. O Facebook exige uma URL de Política de privacidade e uma de Termos de serviço. Você precisa fornecê-las na página de configurações básicas do aplicativo Facebook. (Depois de fazer login no seu aplicativo no Facebook for Developers, selecione Básicas em Configurações no painel lateral do menu.)

A página de Código de conduta contém recursos de terceiros para ajudar a criar uma política de privacidade. A página de Termos de serviço contém exemplos de termos para ajudar a criar um documento apropriado de Termos de serviço.

O Facebook tem o seu próprio processo de análise para aplicativos publicados no Messenger. Você pode aprender mais sobre isso em Envios de exemplos e Motivos comuns de rejeição. Seu bot será testado para garantir que seja compatível com as Políticas da Plataforma do Facebook antes de ser aprovado pelo Facebook para se tornar público.

Tornar o aplicativo público e publicar a página

Até ser publicado, o aplicativo está no Modo de desenvolvimento. O bot não será público e funcionará apenas para administradores, desenvolvedores e testadores.

Após a análise ser bem-sucedida, no Painel do aplicativo, em Análise do aplicativo, defina o aplicativo como Público. Verifique se a página do Facebook associada ao bot é publicada. O status aparece nas configurações de Páginas.

Remover seu bot do Facebook Messenger

Quando não quiser que o bot esteja acessível no Facebook Messenger, você poderá removê-lo do Facebook.

  1. No Power Virtual Agents, selecione Gerenciar no painel de navegação lateral e, em seguida, acesse a guia Canais.

  2. Selecione o bloco Facebook e, em seguida, Excluir.

    Excluir canal do Facebook

Como atualizar conteúdo do bot para conversas existentes no Facebook

Para evitar interrupções durante uma conversa entre um usuário e o bot, as conversas existentes não serão atualizadas para o conteúdo mais recente do bot imediatamente após uma nova publicação. Em vez disso, o conteúdo será atualizado após a conversa ficar inativa por 30 minutos.

Novas conversas entre usuário e bot terão o conteúdo do bot mais recente publicado.

Limitações conhecidas

  • Você precisará criar um novo bot se a pesquisa de satisfação do cliente (CSAT) aparecer como uma imagem de cartão não interativa para um bot criado durante a versão preliminar pública para acessar o conteúdo mais recente da CSAT.
  • Pode levar alguns minutos para que o bot se torne acessível para usuários nas páginas do Facebook após a adição do canal do Facebook.
  • Após a remoção de um canal do Facebook, pode levar alguns minutos para que o bot seja removido completamente e se torne inacessível no Facebook Messenger.
  • Após a remoção de uma página do Facebook, pode levar alguns minutos para que o bot se torne inacessível para visitantes da página removida por meio do Facebook Messenger.