Usando a integração do Dialogflow Meta Messenger, é possível 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 do Dialogflow e o app Meta para que eles se comuniquem entre si.
- A integração com o Dialogflow envia mensagens para o usuário final usando a API Meta Messenger.
- A integração com o Dialogflow recebe mensagens do usuário final atuando como Webhooks meta para a plataforma Messenger.
Configuração
Para configurar a integração:
Siga as etapas para criar um app Meta: Desenvolvimento de apps da Meta.
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 Meta.
- Inscrever seu app em uma metapágina. Verifique se
messages
emessaging_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.
Configure a integração no Console do Dialogflow:
- Acesse o Console do Dialogflow CX.
- Clique na guia Gerenciar no painel à esquerda.
- Clique em Integrations no menu da barra lateral à esquerda.
- Clique no botão Conectar no bloco Meta Messenger.
Uma caixa de diálogo de configuração é aberta.
Chave secreta do app: insira a chave secreta do app em Configurações básicas do Painel de apps.
Verificar token: você pode inserir qualquer token privado. Copie esse valor. Ele vai ser 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 Meta app acima.
Ativar o botão de primeiros passos: consulte a seção Botão Primeiros passos.
Webhook URL: copie esse valor. Ele vai ser usado para configurar o Webhook do Meta Messenger.
Iniciar: clique para iniciar esse serviço de integração para o agente.
Conclua a configuração e teste o Meta app. Siga as etapas na documentação Meta Webhooks para a plataforma Messenger para fazer o seguinte:
- Configure o webhook de meta para seu aplicativo. Use os valores de URL do Webhook e Verificar token que você copiou acima. Ative
messages
emessaging_postbacks
na assinatura da página. - Testar o aplicativo.
- Configure o webhook de meta para seu aplicativo. Use os valores de URL do Webhook e Verificar token que você copiou acima. Ative
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 agora" 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 "Get Started do Meta Messenger:
Ative o botão de primeiros passos ao ativar o serviço de integração.
Este serviço de integração vai 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}"
Crie um manipulador de eventos personalizados para o evento
FACEBOOK_WELCOME
.
Para testar:
Exclua a conversa anterior com sua metapágina (se aplicável).
- O botão Primeiros passos só aparece em novas conversas.
Inicie uma nova conversa com sua Metapágina.
Clique no botão Primeiros passos e verifique a resposta do manipulador de eventos personalizado.
Você pode chamar a API Messenger Profile quando quiser para gerenciar o botão Get Started. 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 Enviar objeto de mensagem de parâmetros de API para ver 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
Quando configuradas, as respostas específicas do canal com o canal DF_CX_FB_MESSENGER
serão usadas automaticamente quando o agente responder a mensagens no Meta Messenger.