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 Workplace. 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 através do portal do Azure. Para obter informações sobre como usar um adaptador de canal personalizado, consulte Informações adicionais.

Pré-requisitos

  • Uma subscrição 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, pode criar uma no developers.facebook.com.
  • Uma página do Facebook a partir da qual os usuários acessarão seu bot. Se ainda não tiver uma, crie uma nova Página.
  • Para usar o Facebook Workplace com seu bot, você deve criar uma conta do Workplace e uma integração personalizada para conectar o bot.

Criar uma aplicação 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 a sua aplicação

  1. Inicie sessão na sua conta Meta for Developers .
  2. Vá para Criar um novo aplicativo do Facebook.
  3. Na página Selecione um tipo de aplicativo, selecione Empresa e, em seguida, 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 para seu aplicativo.
  5. Expanda Configurações e selecione Básico.
    1. Copie e salve a ID do aplicativo e o segredo do aplicativo.
  6. Agora, em Configurações, selecione Avançado.
    1. No painel resultante, role para baixo até as Configurações de segurança e habilite Permitir acesso à API nas configurações do aplicativo.
    2. Selecione Guardar Alterações.

Ativar o Messenger

  1. Selecione Dashboard.
  2. No painel resultante, role para baixo até o bloco Messenger e selecione Configurar.
  3. O site adiciona as 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. Role para baixo até Tokens de acesso e selecione Adicionar ou remover páginas.

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

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

    Copie e guarde o 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 confirme o aviso.
    3. Copie o token e selecione Concluído.

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

Configurar seu bot no Azure

Para permitir que seu bot envie mensagens e outros eventos para o Facebook Messenger, habilite a integração de webhooks.

  1. Em uma nova janela do navegador, vá para o portal do Azure.
  2. Abra a folha de recursos do Bot do Azure para seu bot.
  3. Abra Canais e selecione Facebook.
  4. Em Configurar Canal do Facebook, insira as informações do Facebook que você copiou nas etapas anteriores.
    1. Introduza o ID da Aplicação do Facebook e o Segredo da Aplicação do Facebook.
    2. Introduza o ID da 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.

Gorjeta

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

Ativar webhooks

Volte às 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 para seu aplicativo.
  2. No painel resultante, role para baixo 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 de token copiados do portal do Azure.
    2. Selecione Verificar e salvar.
  4. A Página que você adicionou agora aparece na lista Páginas em Webhooks.
  5. Selecione Adicionar subscrições para a Página.
    1. Na página Editar assinaturas da página, selecione os seguintes campos de assinatura:
      • mensagens
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. Selecione Guardar.
  6. O site exibe os campos de assinatura adicionados ao lado da Página do seu bot.

Tornar seu aplicativo público

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

Apenas o criador (a conta de desenvolvimento do Facebook que criou a página e o bot) pode obter uma resposta do bot. Os 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 tenham uma conta Meta for Developers. Para obter mais informações sobre funções de aplicativo e usuários de teste, consulte a documentação do desenvolvedor do Meta for Developers.

Submeter para revisão

O Facebook requer um URL da Política de Privacidade e um 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 a criar uma política de privacidade. A página Termos de Uso contém exemplos de termos para ajudar a criar um documento de Termos de Serviço apropriado.

Depois que o bot é concluído, 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 está em conformidade com as Políticas da Plataforma do Facebook.

Tornar a aplicação pública e publicar a Página

Depois que a revisão for bem-sucedida, no Painel do aplicativo, em Revisão do aplicativo, defina o aplicativo como Público. Certifique-se de que a Página do Facebook associada a este bot está publicada. O status aparece nas configurações do Pages.

Definir a versão da API

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

  1. Vá para Meta para desenvolvedores.
  2. Vá para o aplicativo que você criou para seu bot.
  3. Em Configurações, selecione Avançado.
  4. Selecione Atualizar versão da API e, em seguida, 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 .

Teste seu bot no Facebook

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

  1. Aceda ao Facebook e mude para o perfil da sua página.
  2. Selecione mais ações (...) e, em seguida, Botão Adicionar 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, preencha a caixa de diálogo e salve as alterações.
  3. Volte ao seu perfil pessoal.
  4. Vá para sua página e selecione Mensagem para testar a conexão com seu bot.

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

Informações adicionais

Consulte o Exemplo de eventos do Facebook do Bot Framework C# para obter um exemplo de bot que oferece suporte à comunicação do Facebook Messenger.

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

Para obter a documentação do Facebook Workplace, consulte: