Conectar um bot ao FacebookConnect a bot to Facebook

Seu bot pode ser conectado ao Facebook Messenger e ao Workplace do Facebook, para que ele possa se comunicar com usuários nas duas plataformas.Your bot can be connected to both Facebook Messenger and Facebook Workplace, so that it can communicate with users on both platforms. O tutorial a seguir mostra como conectar um bot a esses dois canais.The following tutorial shows how to connect a bot to these two channels.

Observação

A interface do usuário do Facebook pode parecer ligeiramente diferente de acordo com a versão que está sendo usada.The Facebook UI may appear slightly different depending on which version you are using.

Conectar um bot ao Facebook MessengerConnect a bot to Facebook Messenger

Para saber mais sobre o desenvolvimento para o Facebook Messenger, confira a documentação da plataforma Messenger.To learn more about developing for Facebook Messenger, see the Messenger platform documentation. Talvez você deseje examinar as diretrizes de pré-lançamento, o início rápido e o guia de instalação do Facebook.You may wish to review Facebook's pre-launch guidelines, quick start, and setup guide.

Para configurar um bot para se comunicar usando o Facebook Messenger, habilite o Facebook Messenger em uma página do Facebook e, em seguida, conecte o bot.To configure a bot to communicate using Facebook Messenger, enable Facebook Messenger on a Facebook page and then connect the bot.

Copiar a ID da PáginaCopy the Page ID

O bot é acessado por meio de uma Página do Facebook.The bot is accessed through a Facebook Page.

  1. Crie uma Página do Facebook ou acesse uma página existente.Create a new Facebook Page or go to an existing Page.

  2. Abra a página Sobre da Página do Facebook e, em seguida, copie e salve a ID da Página.Open the Facebook Page's About page and then copy and save the Page ID.

Criar um aplicativo do FacebookCreate a Facebook app

  1. No navegador, navegue para Criar um novo aplicativo do Facebook.In your browser, navigate to Create a new Facebook App.

  2. Insira o nome do aplicativo e clique no botão Criar ID do Aplicativo do Facebook.Enter the name of your app and click the Create New Facebook App ID button.

    Criar aplicativo

  3. Na caixa de diálogo exibida, insira o endereço de email e clique no botão Criar ID do Aplicativo.In the displayed dialog, enter your email address and click the Create App ID button.

    Criar uma ID do Aplicativo

  4. Realize as etapas do assistente.Go through the wizard steps.

  5. Insira as informações de verificação necessárias e clique no botão Ignorar Início Rápido no canto superior direito.Enter the required check information, then click the Skip Quick Start button in the upper right.

  6. No painel esquerdo da próxima janela exibida, expanda Configurações e clique em Básico.In the left pane of the next displayed window, expand Settings and click Basic.

  7. No painel à direita, copie e salve a ID do Aplicativo e o Segredo do Aplicativo.In the right pane, copy and save the App ID and App Secret.

    Copiar a ID do Aplicativo e Segredo do Aplicativo

  8. No painel esquerdo, em Configurações, clique em Avançado.In the left pane, under Settings, click Advanced.

  9. No painel direito, defina o controle deslizante Permitir Acesso da API às Configurações do Aplicativo como Sim.In the right pane, set Allow API Access to App Settings slider to Yes.

    Copiar a ID do Aplicativo e Segredo do Aplicativo

  10. Na parte inferior direita da página, clique no botão Salvar Alterações.In the page bottom right, click the Save Changes button.

Habilitar o MessengerEnable messenger

  1. No painel esquerdo, clique em Dashboard.In the left pane, click Dashboard.

  2. No painel direito, role para baixo e, na caixa Messenger, clique no botão Configurar.In the right pane, scroll down and in the Messenger box, click the Set Up button. A entrada do Messenger é exibida na seção PRODUTOS no painel esquerdo.The Messenger entry is displayed under the PRODUCTS section in the left pane.

    Habilitar o Messenger

Gerar um Token de Acesso da PáginaGenerate a Page Access Token

  1. No painel esquerdo, na entrada do Messenger, clique em Configurações.In the left pane, under the Messenger entry, click Settings.

  2. No painel direito, role para baixo e, na seção Geração de Token, selecione a página de destino.In the right pane, scroll down and in the Token Generation section, select the target page.

    Habilitar o Messenger

  3. Clique no botão Editar Permissões para conceder pages_messaging ao aplicativo para gerar um token de acesso.Click the Edit Permissions button to grant the app pages_messaging in order to generate an access token.

  4. Siga as etapas do assistente.Follow the wizard steps. Na última etapa, aceite as configurações padrão e clique no botão Concluído.In the last step accept the default settings and click the Done button. No final, um token de acesso à página é gerado.At the end a page access token is generated.

    Permissões do Messenger

  5. Copie e salve o Token de Acesso da Página.Copy and save the Page Access Token.

Habilitar webhooksEnable webhooks

Para enviar mensagens e outros eventos do bot para o Facebook Messenger, você precisa habilitar a integração de webhooks.In order to send messages and other events from your bot to Facebook Messenger, you must enable webhooks integration. Neste momento, vamos deixar as etapas de configuração do Facebook pendentes. Trataremos delas depois.At this point, let's leave the Facebook setting steps pending; will come back to them.

  1. No navegador, abra uma nova janela e navegue até o portal do Azure.In your browser open a new window and navigate to the Azure portal.

  2. Na lista Recurso, clique no registro do recurso de bot e, na folha relacionada, clique em Canais.In the Resource list, click on the bot resource registration and in the related blade click Channels.

  3. No painel direito, clique no ícone do Facebook.In the right pane, click the Facebook icon.

  4. No assistente, insira as informações do Facebook armazenadas nas etapas anteriores.In the wizard enter the Facebook information stored in the previous steps. Se as informações estiverem corretas, na parte inferior do assistente, você deverá ver a URL de retorno de chamada e o token de verificação.If the information is correct, at the bottom of the wizard, you should see the callback URL and the verify token. Copie-os e armazene-os.Copy and store them.

    configuração de canal do fb messenger

  5. Clique no botão Salvar .Click the Save button.

  6. Vamos voltar às configurações do Facebook.Let's go back to the Facebook settings. No painel direito, role para baixo e, na seção Webhooks, clique no botão Assinar Eventos.In the right pane, scroll down and in the Webhooks section, click the Subscribe To Events button. Isso é para encaminhar eventos de mensagens do Facebook Messenger para o bot.This is to forward messaging events from Facebook Messenger to the bot.

    Habilitar webhooks

  7. Na caixa de diálogo exibida, insira os valores de URL de Retorno de Chamada e Token de Verificação armazenados anteriormente.In the displayed dialog, enter the Callback URL and Verify Token values stored previously. Em Campos de Assinatura, selecione mensagem_entregas, mensagens, mensagens_opções, e mensagens_postbacks.Under Subscription Fields, select message_deliveries, messages, messaging_optins, and messaging_postbacks.

    Configurar webhooks

  8. Clique no botão Verificar e Salvar.Click the Verify and Save button.

  9. Selecione a página do Facebook para assinar o webhook.Select the Facebook page to subscribe the webhook. Clique no botão Assinar.Click the Subscribe button.

    Página Configurar webhooks

Enviar para revisãoSubmit for review

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.Facebook requires a Privacy Policy URL and Terms of Service URL on its basic app settings page. 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.The Code of Conduct page contains third party resource links to help create a privacy policy. 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.The Terms of Use page contains sample terms to help create an appropriate Terms of Service document.

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.After the bot is finished, Facebook has its own review process for apps that are published to Messenger. O bot será testado para garantir que está em conformidade com as Políticas de Plataforma do Facebook.The bot will be tested to ensure it is compliant with Facebook's Platform Policies.

Tornar o Aplicativo público e publicar a PáginaMake the App public and publish the Page

Observação

Enquanto um aplicativo não é publicado, ele fica no Modo de Desenvolvimento.Until an app is published, it is in Development Mode. A funcionalidade de API e de plug-in só funcionará para administradores, desenvolvedores e testadores.Plugin and API functionality will only work for admins, developers, and testers.

Depois que a análise for bem-sucedida, no Painel de Aplicativos em Revisão do Aplicativo, defina o aplicativo como Público.After the review is successful, in the App Dashboard under App Review, set the app to Public. Garanta que a Página do Facebook associada a esse bot seja publicada.Ensure that the Facebook Page associated with this bot is published. O status é exibido nas configurações de Páginas.Status appears in Pages settings.

Conectar um bot ao Workplace do FacebookConnect a bot to Facebook Workplace

O Workplace do Facebook é uma versão do Facebook voltada para os negócios, que permite aos funcionários se conectar e colaborar com facilidade.Facebook Workplace is a business-oriented version of Facebook, which allows employees to easily connect and collaborate. Ele contém vídeos ao vivo, feeds de notícias, grupos, mensageiro, reações, pesquisa e postagens de tendências.It contains live videos, news feeds, groups, messenger, reactions, search, and trending posts. Também dá suporte a:It also supports:

  • Análise e integrações.Analytics and integrations. Um painel com análise, integração, logon único e provedores de identidade que as empresas usam para integrar o Workplace aos seus sistemas de TI existentes.A dashboard with analytics, integration, single sign-on, and identity providers that companies use to integrate Workplace with their existing IT systems.
  • Grupos de várias empresas.Multi-company groups. Espaços compartilhados nos quais funcionários de diferentes organizações podem trabalhar juntos e colaborar.Shared spaces in which employees from different organizations can work together and collaborate.

Consulte a Central de Ajuda do Workplace para saber mais sobre o Workplace do Facebook e a Documentação para desenvolvedor do Workplace para obter diretrizes sobre como desenvolver para Workplace do Facebook.See the Workplace Help Center to learn more about Facebook Workplace and Workplace Developer Documentation for guidelines about developing for Facebook Workplace.

Para usar o Workplace do Facebook com o bot, é necessário criar uma conta do Workplace e uma integração personalizada para conectar o bot.To use Facebook Workplace with your bot, you must create a Workplace account and a custom integration to connect the bot.

Criar uma conta Premium do WorkplaceCreate a Workplace Premium account

  1. Envie um aplicativo ao Workplace em nome de sua empresa.Submit an application to workplace on behalf of your company.
  2. Depois que o aplicativo for aprovado, você receberá um email com um convite de participação.Once your application has been approved, you will receive an email inviting you to join. A resposta pode demorar um pouco.The response may take a while.
  3. No convite por email, clique em Começar.From the e-mail invitation, click Get Started.
  4. Insira as informações de seu perfil.Enter your profile information.

    Dica

    Defina-se como administrador do sistema.Set yourself as the system administrator. Lembre-se de que somente os administradores do sistema podem criar integrações personalizadas.Remember that only system administrators can create custom integrations.

  5. Clique em Prévia do perfil e verifique se as informações estão corretas.Click Preview Profile and verify the information is correct.
  6. Acesse Teste gratuito.Access Free Trial.
  7. Crie uma senha.Create password.
  8. Clique em Convidar colegas de trabalho para convidar os funcionários a entrar.Click Invite Coworkers to invite employees to sign-in. Os funcionários que você convidou se tornarão membros assim que entrarem.The employees you invited will become members as soon as they sign. Eles passarão por um processo de entrada semelhante, conforme descrito nestas etapas.They will go through a similar sign-in process as described in these steps.

Criar uma integração personalizadaCreate a custom integration

Crie uma integração personalizada para o Workplace executando as etapas descritas abaixo.Create a custom integration for your Workplace following the steps described below. Quando você cria uma integração personalizada, ocorre a criação de um aplicativo com permissões definidas e uma página do tipo 'Bot' visível apenas dentro de sua comunidade de Workplace.When you create a custom integration, an app with defined permissions and a page of type 'Bot' only visible within your Workplace community are created.

  1. No Painel de Administração, abra a guia Integrações.In the Admin Panel, open the Integrations tab.

  2. Clique no botão Criar seu próprio aplicativo personalizado.Click on the Create your own custom App button.

    Integração do Workplace

  3. Escolha um nome de exibição e uma foto de perfil para o aplicativo.Choose a display name and a profile picture for the app. Essas informações serão compartilhadas com a página do tipo 'Bot'.Such information will be shared with the page of type 'Bot'.

  4. Defina Permitir Acesso da API às Configurações do Aplicativo como "Sim".Set the Allow API Access to App Settings to "Yes".

  5. Copie e armazene com segurança a ID do Aplicativo, o Segredo do Aplicativo e o Token do Aplicativo mostrado para você.Copy and safely store the App ID, App Secret and App Token that's shown to you.

    Chaves do Workplace

  6. Agora você concluiu a criação de uma integração personalizada.Now you have finished creating a custom integration. Você pode encontrar a página do tipo 'Bot' em sua comunidade do Workplace, conforme mostrado abaixo.You can find the page of type 'Bot' in your Workplace community,as shown below.

    Página do Workplace

Fornecer as credenciais do FacebookProvide Facebook credentials

No portal do Azure, cole os valores de ID do Aplicativo do Facebook, Segredo do Aplicativo do Facebook, Token de Acesso da Página copiados anteriormente do Workplace do Facebook.In Azure portal, paste the Facebook App ID, Facebook App Secret and Page Access Token values copied from the Facebook Workplace previously. Em vez de uma pageID tradicional, use os números que seguem o nome de integrações em sua página Sobre.Instead of a traditional pageID, use the numbers following the integrations name on its About page. Semelhante a conexão a um bot para Facebook Messenger, os webhooks podem ser conectados com as credenciais mostradas no Azure.Similar to connecting a bot to Facebook Messenger, the webhooks can be connected with the credentials shown in Azure.

Enviar para revisãoSubmit for review

Consulte a seção Conectar um bot ao Facebook Messenger e Documentação de desenvolvedor do Workplace para obter detalhes.Please refer to the Connect a bot to Facebook Messenger section and Workplace Developer Documentation for details.

Tornar o Aplicativo público e publicar a PáginaMake the App public and publish the Page

Consulte a seção Conectar um bot ao Facebook Messenger para obter detalhes.Please refer to the Connect a bot to Facebook Messenger section for details.

Definir a versão da APISetting the API version

Se você receber uma notificação sobre a substituição de uma determinada versão da API do Graph do Facebook, vá para página de desenvolvedores do Facebook.If you receive a notification from Facebook about deprecation of a certain version of the Graph API, go to Facebook developers page. Navegue até as Configurações do aplicativo do seu bot e vá para Configurações > Avançadas > Atualizar versão de API, depois troque para Atualizar todas as chamadas 3.0.Navigate to your bot’s App Settings and go to Settings > Advanced > Upgrade API version, then switch Upgrade All Calls to 3.0.

Atualização de versão da API

Consulte tambémSee also