Conectar um bot ao Facebook

  • Artigo

Você pode configurar seu bot para se comunicar com as pessoas por meio do Facebook Messenger ou do Facebook Empresa. Este artigo descreve como criar um aplicativo do Facebook usando o site Meta for Developers, conectar seu bot ao seu aplicativo do Facebook no Azure e testar seu bot no Facebook.

Este artigo mostra como adicionar o canal do Facebook ao seu bot por meio do portal do Azure. Para obter informações sobre como usar um adaptador de canal personalizado, confira Informações adicionais.

Pré-requisitos

  • Uma assinatura do Azure. Se ainda não tiver uma, crie uma conta gratuita antes de começar.
  • Um bot publicado no Azure que você deseja conectar ao Facebook.
  • Uma conta do Facebook para Desenvolvedores. Se não tiver uma conta, poderá criar uma no developers.facebook.com.
  • Uma página do Facebook a partir da qual os usuários acessarão seu bot. Se não tiver uma, acesse Criar uma página.
  • Para usar o Facebook Empresa com o bot, é necessário criar uma conta da empresa e uma integração personalizada para conectar o bot.

Criar um aplicativo do Facebook

Os usuários acessarão seu bot a partir de uma página do Facebook. Para conectar o bot, você habilitará o Facebook Messenger na página do Facebook e, em seguida, conectará o bot à página.

Criar o aplicativo

  1. Inicie sessão na sua conta Meta for Developers.
  2. Acesse Criar um aplicativo do Facebook.
  3. Na página Selecionar um tipo de aplicativo, selecione Negócios e Avançar.
  4. Na página Fornecer informações básicas, insira um nome para seu aplicativo e selecione Criar aplicativo.
    • Se solicitado, digite sua senha e selecione Enviar para criar seu aplicativo.
    • Depois que seu aplicativo é criado, o site vai para uma página de seu aplicativo.
  5. Expanda Configurações e selecione Básico.
    1. Copie e salve a ID do aplicativo e o Segredo do aplicativo.
  6. Em Configurações, selecione Configurações avançadas.
    1. No painel resultante, scroll down até as configurações de segurança e habilite Permitir à API acesso às configurações do aplicativo.
    2. Selecione Salvar alterações.

Habilite o Messenger

  1. Selecione Painel.
  2. No painel resultante, scroll down até o bloco do Messenger e selecione Configurar.
  3. O site adiciona configurações do Messenger ao seu aplicativo e exibe a página de configurações.

Adicionar páginas e gerar tokens

  1. Em Messenger, selecione Configurações.

  2. Scroll down até Tokens de acesso e selecione Adicionar ou remover páginas.

    1. Quando for solicitada a associação da identidade ao Messenger, continue com sua conta atual ou entre em outra.
    2. Quando for solicitada a indicação das páginas que você deseja usar com seu aplicativo, selecione as páginas e, em seguida, Avançar.
    3. Se for solicitado a enviar a solicitação de Revisão de login, revise as informações e selecione Concluído.
    4. Havendo exito, o site exibe uma página de sucesso. Selecione OK para continuar.

  3. A Página adicionada agora aparece na lista de Páginas.

    Copie e salve a ID da página para mais tarde.

  4. Selecione Gerar token para a Página.

    1. O site exibe informações de segurança e dá a você a chance de copiar o token.
    2. Leia e reconheça o aviso.
    3. Copie o token e selecione Concluído.

Agora você tem as informações do aplicativo e um token para a próxima etapa. Deixe as etapas de configuração do Facebook pendentes. Você as atualizará mais tarde.

Configure seu bot no Azure

Para permitir que o seu bot envie mensagens e outros eventos ao Facebook Messenger, você precisa habilitar a integração de webhooks.

  1. Em uma nova janela do navegador, acesse o portal do Azure.
  2. Kudu a folha do recurso de Bot do Azure para o seu bot.
  3. Abra Canais e selecione Facebook.
  4. Em Configurar canal do Facebook, insira as informações do Facebook copiadas nas etapas anteriores.
    1. Insira sua ID do aplicativo do Facebook e o Segredo do aplicativo do Facebook.
    2. Insira sua ID de Página e o Token de Acesso.
    3. Copie a URL de Retorno de Chamada gerada e verifique os valores do Token.
    4. Selecione Adicionar.

Dica

  • Se não tiver uma cópia de suas informações das etapas anteriores, poderá recuperá-las no site Meta for Developers.
  • Se precisar, crie outro token da Web para a página. Para obter instruções, confira Adicionar páginas e gerar tokens.

Habilitar webhooks

Volte para as configurações do Facebook para concluir o processo de configuração.

  1. No site Meta for Developers, volte para a página de configurações do Messenger de seu aplicativo.
  2. No painel resultante, scroll down até a seção Webhooks e selecione Adicionar URL de retorno de chamada.
  3. Na página Editar URL de Retorno de Chamada:
    1. Insira a URL de retorno de chamada e verifique os valores do geração de tokens que você copiou do portal do Azure.
    2. Selecione Verificar e salvar.
  4. A Página adicionada agora aparece na lista de. Páginas em Webhooks.
  5. Selecione Adicionar assinaturas da página.
    1. Na página Editar assinaturas de página, selecione os seguintes campos de assinatura:
      • messages
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. Selecione Salvar.
  6. O site exibe os campos de assinatura adicionados ao lado da Página do seu bot.

Torne o seu aplicativo público

Até que um aplicativo seja publicado, ele fica no Modo de Desenvolvimento. A funcionalidade de API e de plug-in só funcionará para administradores, desenvolvedores e testadores.

Somente o criador (a conta de desenvolvimento do Facebook que criou a página e o bot) pode obter uma resposta do bot. Usuários normais do Facebook não conseguem ver a página ou o bot. Dê funções de desenvolvimento ou teste aos usuários-alvo, para que eles também possam conversar com o bot.

Os usuários a serem adicionados às funções de testador devem primeiro se registrar no site Meta for Developers. A função de testador não está disponível para usuários do Facebook que não têm uma conta Meta for Developers. Para obter mais informações sobre funções de aplicativo e usuários de teste, confira a Documentação de desenvolvedor do Meta for Developers.

Enviar para revisão

O Facebook exige uma URL da Política de Privacidade e uma URL dos Termos de Serviço na página de configurações básicas do aplicativo. A página Código de Conduta contém links de recursos de terceiros para ajudar na criação de uma política de privacidade. A página Termos de Uso contém termos de exemplo para ajudar na criação de um documento de Termos de Serviço apropriado.

Após a conclusão do bot, o Facebook tem seu próprio processo de revisão para aplicativos que são publicados no Messenger. O bot será testado para garantir que esteja em conformidade com as Políticas de Plataforma do Facebook.

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

Depois que a análise for bem-sucedida, no Painel de Aplicativos em Revisão do Aplicativo, defina o aplicativo como Público. Garanta que a Página do Facebook associada a esse bot seja publicada. O status é exibido nas configurações de Páginas.

Defina a versão de API

Se você receber uma notificação do Facebook sobre a substituição de uma determinada versão da API do Graph:

  1. Acesse Meta for Developers.
  2. Acesse o aplicativo que você criou para seu bot.
  3. Em Configurações, selecione Configurações avançadas.
  4. Selecione Atualizar versão da API e alterne Atualizar todas as chamadas para a versão 4.0.

Teste a conexão seguindo as etapas descritas na seção Testar seu bot no Facebook.

Testar seu bot no Facebook

Agora você pode testar se seu bot está conectado ao Facebook corretamente enviando uma mensagem pela Página do Facebook que você associou ao seu novo aplicativo do Facebook.

  1. Acesse o Facebook e mude para o perfil da sua página.
  2. Selecione mais ações (...) e, em seguida, Adicionar botão de ação.
    1. Na caixa de diálogo Personalizar o botão de ação, selecione Experimentar e siga as instruções.
    2. Na página Botão de Ação, em Fazer com que as pessoas entrem em contato com você, selecione Enviar Mensagem.
    3. Selecione Avançar, conclua a caixa de diálogo e salve as alterações.
  3. Volte para o seu perfil pessoal.
  4. Acesse sua página e selecione Mensagem para testar a conexão com o bot.

Você também pode testar esse recurso usando o exemplo de bot para o adaptador do Facebook preenchendo o arquivo appsettings.json com os mesmos valores descritos nas etapas acima.

Informações adicionais

Confira o exemplo de eventos do Facebook do Bot Framework C# para obter um bot de exemplo que ofereça suporte à comunicação do Facebook Messenger.

Para obter a documentação do Facebook Messenger, confira:

Para obter a documentação do Facebook Empresa, confira: