Messenger da Meta

Visualizar

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de 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.

Com a integração do Meta Messenger, é possível criar um bot do Meta Messenger para interagir com os usuários.

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

Observação: essa integração não é compatível com o Workplace do Meta.

A integração funciona assim:

• Crie um app da Meta que use a plataforma do Meta Messenger.
• Configure a integração do Dialogflow CX e o app da Meta para que eles se comuniquem.
• A integração do Dialogflow CX envia mensagens aos usuários usando a API Meta Messenger.
• A integração do Dialogflow CX recebe mensagens dos usuários atuando como os webhooks da Meta para a plataforma do Messenger.

Configuração

Verifique se o faturamento está ativado no seu projeto antes de testar a integração.

Para configurar a integração:

1. Siga as etapas para criar um app da Meta: Desenvolvimento de apps da Meta.
2. Configure o app da Meta para usar a plataforma do Meta Messenger. Siga as etapas na documentação Webhooks da Meta para a Plataforma do Messenger para fazer o seguinte:
   • Adicione a Plataforma do Messenger ao seu app da Meta.
   • Inscreva seu app em uma página da Meta. Verifique se messages e messaging_postbacks estão ativados na assinatura da página.
   • Copie o token de acesso fornecido nesta etapa. Esse token é usado para configurar a integração no console do Dialogflow CX.
   • Não configure o webhook nem teste sua integração ainda.
3. Configure a integração no console do Dialogflow CX:
   1. Acesse o console do Dialogflow CX.
   2. Selecione a guia Gerenciar no menu de navegação.
   3. Selecione Integrações.
   4. Clique no botão Conectar no bloco Meta Messenger.
   5. Preencha os campos da caixa de diálogo de configuração:
      • Chave secreta do app:insira a chave secreta do app em Configurações básicas do painel do app.
      • Verificar token:insira qualquer token particular necessário. Copie esse valor. Isso é usado para configurar o webhook do Meta Messenger.
      • Token de acesso da página:insira o token de acesso que você copiou durante a configuração do app da Meta.
      • Ativar o botão "Começar":marque essa caixa de seleção para ativar o botão "Começar".
      • URL do webhook:copie esse valor. Isso é usado para configurar o webhook do Meta Messenger.
      • Iniciar:marque esta caixa de seleção para iniciar o serviço de integração do seu agente.
4. Conclua a configuração do app da Meta e teste-o. Siga as etapas na documentação Webhooks da Meta para a plataforma do Messenger para fazer o seguinte:
   • Configure o webhook da Meta para seu app. Use os valores de URL do webhook e Token de verificação que você copiou anteriormente. 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 "Começar" do Meta Messenger.
FACEBOOK_MEDIA	Acionado quando a mensagem de um usuário final contém anexos (por exemplo, áudio, imagem ou vídeo).

Botão Vamos começar

Configure o botão "Começar" do Meta Messenger:

1. Ative a opção Ativar botão "Começar" ao ativar esse serviço de integração.

   • Esse serviço de integração permite ativar o botão chamando a API 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 personalizado para o evento FACEBOOK_WELCOME.

Para testar:

1. Exclua a conversa anterior com sua página da Meta, se aplicável.
   • O botão Primeiros passos só aparece em novas conversas.
2. Inicie uma nova conversa com sua página da Meta.
3. Clique no botão Primeiros passos e verifique a resposta do manipulador de eventos personalizado.

Você pode chamar a API Messenger Profile para gerenciar o botão Começar. Isso pode ajudar nos testes.

Para verificar o status do botão Começar, use a seguinte solicitação:

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

Use a seguinte solicitação para desativar o botão Começar:

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çada são compatíveis com o uso de payload personalizado no fulfillment. Para mais informações, consulte a documentação do objeto de mensagem de parâmetros da API Send para o formato da mensagem.

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

{
  "text": "Hello, world"
}

O payload personalizado a seguir fornece uma mensagem de imagem:

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

Respostas específicas do canal

Depois de configurar as respostas específicas do canal, o agente usa automaticamente o canal DF_CX_FB_MESSENGER para responder às mensagens do Meta Messenger.