Messenger do Facebook

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Usando a integração do Dialogflow com o Facebook Messenger, você pode criar um bot do Facebook Messenger para interagir com os usuários finais.

Observação: ao usar uma integração de terceiros, as solicitações e os dados do usuário final são enviados ao Google e ao terceiro. Os Termos de Serviço, o SLA, os preços e as cotas da edição do agente são aplicáveis ao processamento dessas solicitações pelo Google. Os Termos de Serviço, o SLA, os preços e as cotas de terceiros são aplicáveis ao processamento dessas solicitações por terceiros.

Como funciona

A integração funciona assim:

• Você cria um aplicativo do Facebook que usa a plataforma Facebook Messenger.
• Você configura a integração do Dialogflow e o aplicativo do Facebook para que eles se comuniquem entre si.
• A integração do Dialogflow envia mensagens para o usuário final usando a API Facebook Messenger.
• A integração do Dialogflow recebe mensagens do usuário final agindo como webhook do Facebook Messenger.

Instalação

Observação: verifique se o faturamento está ativado no projeto antes de testar a integração.

Para configurar a integração:

1. Siga as etapas para criar um aplicativo do Facebook: Desenvolvimento de aplicativos do Facebook.

2. Configure o aplicativo do Facebook para usar a plataforma do Facebook Messenger. Siga as etapas na documentação Como configurar seu aplicativo do Facebook para:

   • Adicionar a plataforma do Messenger ao seu aplicativo do Facebook.
   • Inscrever seu aplicativo em uma página do Facebook. Verifique se messages e messaging_postbacks estão ativados na assinatura da página.
   • Você receberá um token de acesso nessa etapa. Copie esse valor. Esse token será usado para configurar a integração do Console do Dialogflow.
   • Não configure o webhook nem teste sua integração ainda.

3. Configure a integração no Console do Dialogflow:

   1. Acesse o Console do Dialogflow CX.
   2. Clique na guia Gerenciar no painel à esquerda.
   3. Clique em Integrations no menu da barra lateral à esquerda.
   4. Clique no botão Conectar no bloco do Facebook Messenger.

   5. Uma caixa de diálogo de configuração é aberta.

      • Secret do app: insira a chave secreta do app nas Configurações básicas do painel de apps do Facebook.

      • Verificar token: você pode inserir qualquer token privado. Copie esse valor. Isso será usado para configurar o webhook do Facebook Messenger.

      • Token de acesso à página: digite o token de acesso que você copiou durante a configuração do app Facebook acima.

      • Ativar o botão de primeiros passos: consulte a seção Botão Primeiros passos.

      • Webhook URL: copie esse valor. Isso será usado para configurar o webhook do Facebook Messenger.

      • Iniciar: clique para iniciar esse serviço de integração para o agente.

4. Conclua a configuração do aplicativo do Facebook e teste-o. Siga as etapas na documentação Como configurar seu aplicativo do Facebook para:

   • Configurar o webhook do Facebook para seu aplicativo. Use os valores URL do webhook e Verificar token que você copiou acima. Ative messages e messaging_postbacks na assinatura da página.
   • Testar o aplicativo.

Eventos

Os eventos a seguir são invocados por esta integração: É possível criar manipuladores de eventos personalizados para definir o que fazer quando os eventos são acionados.

Evento	Descrição
FACEBOOK_WELCOME	Acionado quando um usuário final clica no botão de primeiros passos do Facebook Messenger.
FACEBOOK_MEDIA	Acionado quando a mensagem de um usuário final contém anexos (por exemplo, áudio, imagem, vídeo etc.).

Botão de primeiros passos

Para configurar o botão de primeiros passos do Facebook Messenger:

1. Ative o botão de primeiros passos ao ativar o serviço de integração.

   • Esse serviço vai ativar a botão para você chamando a API Facebook Messenger Profile.

     curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \
     "https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"
     

2. Crie um manipulador de eventos personalizados para o evento FACEBOOK_WELCOME.

Para testar:

1. Exclua a conversa anterior com sua página do Facebook (se aplicável).

   • O botão Primeiros passos só aparece em novas conversas.

2. Inicie uma nova conversa com sua página do Facebook.

3. Clique no botão Primeiros passos e verifique a resposta do manipulador de eventos personalizado.

Também é possível chamar a API Facebook Messenger Profile para gerenciar o botão Primeiros passos. Isso pode ser útil para testes.

Por exemplo, a solicitação a seguir verifica o status do botão Primeiros passos:

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

A solicitação a seguir desativa o botão Primeiros passos:

curl -X DELETE \
-H "Content-Type: application/json" \
-d '{"fields": ["get_started"]}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

Mensagens de resposta avançadas

As mensagens de resposta avançadas são compatíveis com o Payload personalizado em Fulfillment. Consulte Objeto de mensagem da API Facebook Messenger Send para saber o formato da mensagem.

Por exemplo, o payload personalizado a seguir fornece uma mensagem de texto simples:

{
  "text": "Hello, world"
}

O payload personalizado a seguir fornece uma mensagem de imagem:

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}