Messenger da Meta

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

Como funciona

A integração funciona assim:

  • Você cria um app Meta que usa a plataforma Meta Messenger.
  • Você configura a integração dos agentes de conversação (Dialogflow CX) e o app Meta para que eles se comuniquem entre si.
  • A integração com os agentes de conversação (Dialogflow CX) envia mensagens ao usuário final usando a API Meta Messenger.
  • A integração com os agentes de conversação (Dialogflow CX) recebe mensagens do usuário final agindo como os webhooks do Meta para a plataforma Messenger.

Configuração

Para configurar a integração:

  1. Siga as etapas para criar um app Meta: Desenvolvimento de apps Meta.

  2. Configure o app Meta para usar a plataforma Meta Messenger. Siga as etapas na documentação Meta Webhooks para a plataforma Messenger para fazer o seguinte:

    • Adicione a plataforma do Messenger ao seu app do Meta.
    • Inscreva seu app em uma página do Meta. 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 é usado para configurar a integração do console de agentes de conversa (Dialogflow CX).
    • Não configure o webhook nem teste sua integração ainda.

  3. Configure a integração no console dos agentes de conversação (Dialogflow CX):

    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 Meta Messenger.

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

      • Secret do app: insira o secret do app nas Configurações básicas do painel de apps.

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

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

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

      • Webhook URL: copie esse valor. Isso é usado para configurar o webhook do Meta Messenger.

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

  4. Conclua a configuração do app Meta e teste-o. Siga as etapas na documentação Meta Webhooks para a plataforma Messenger para fazer o seguinte:

    • Configure o webhook do Meta para seu app. 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 Meta Messenger.
FACEBOOK_MEDIA Acionado quando a mensagem de um usuário final contém anexos (por exemplo, áudio, imagem, vídeo etc.).

Botão "Primeiros passos"

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

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

    • Esse serviço de integração ativa o botão para você 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 personalizados para o evento FACEBOOK_WELCOME.

Para testar:

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

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

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

  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 dos parâmetros da API 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"
    }
  }
}

Respostas específicas do canal

Depois de configurar as respostas específicas do canal, o canal DF_CX_FB_MESSENGER é usado automaticamente quando o agente responde às mensagens do Meta Messenger.