Messenger da Meta

Pré-visualização

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Com a integração do Meta Messenger, pode criar um bot do Meta Messenger para interagir com os seus utilizadores finais.

Nota: quando usa uma integração de terceiros, os pedidos e os dados do utilizador final são enviados para a Google e para o terceiro. Os termos de utilização, o SLA, os preços e as quotas da sua edição de agente são aplicáveis ao processamento destas solicitações por parte da Google. Os termos de serviço, o SLA, os preços e as quotas do terceiro são aplicáveis ao processamento destes pedidos por parte do terceiro.

Como funciona

Nota: esta integração não suporta o Workplace from Meta.

Veja como funciona a integração:

• Cria uma app Meta que usa a plataforma Meta Messenger.
• Configura a integração dos agentes conversacionais (Dialogflow CX) e da app Meta para que comuniquem entre si.
• A integração de agentes conversacionais (Dialogflow CX) envia mensagens ao utilizador final através da API Meta Messenger.
• A integração de agentes conversacionais (Dialogflow CX) recebe mensagens do utilizador final atuando como os webhooks da Meta para a plataforma Messenger.

Configuração

Nota: certifique-se de que a faturação está ativada no seu projeto antes de testar a integração.

Para configurar a integração:

1. Siga os passos para criar uma app Meta: Desenvolvimento de apps Meta.

2. Configure a app Meta para usar a plataforma Meta Messenger. Siga os passos na documentação Webhooks da Meta para a plataforma Messenger para realizar o seguinte:

   • Adicione a plataforma Messenger à sua app Meta.
   • Associe a sua app a uma página do Meta. Certifique-se de que messages e messaging_postbacks estão ativados na subscrição da página.
   • Neste passo, é-lhe fornecido um token de acesso. Copie este valor. Este token é usado para configurar a integração a partir da consola de agentes conversacionais (Dialogflow CX).
   • Não configure o webhook nem teste a integração ainda.

3. Configure a integração a partir da consola de agentes conversacionais (Dialogflow CX):

   1. Aceda à consola Dialogflow CX.
   2. Clique no separador Gerir no painel esquerdo.
   3. Clique em Integrações no menu da barra lateral esquerda.
   4. Clique no botão Ligar no mosaico Meta Messenger.

   5. É aberta uma caixa de diálogo de configuração:

      • Segredo da app: introduza o segredo da app a partir das Definições básicas do painel de controlo da app.

      • Validar token: pode introduzir qualquer token privado que quiser. Copiar este valor. Esta opção é usada para configurar o webhook do Meta Messenger.

      • Chave de acesso da página: introduza a chave de acesso que copiou durante a configuração da app Meta acima.

      • Ativar botão Começar: consulte a secção Botão Começar.

      • URL do webhook: copie este valor. Esta opção é usada para configurar o webhook do Meta Messenger.

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

4. Conclua a configuração da app Meta e teste-a. Siga os passos na documentação Webhooks da Meta para a plataforma Messenger para realizar o seguinte:

   • Configure o webhook da Meta para a sua app. Use os valores URL do webhook e Validar token que copiou acima. Certifique-se de que ativa o messages e o messaging_postbacks na subscrição da página.
   • Teste a sua app.

Eventos

Os seguintes eventos são invocados por esta integração. Pode criar controladores de eventos personalizados para definir o que fazer quando os eventos são acionados.

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

Botão Iniciar

Para configurar o botão Começar do Meta Messenger:

1. Ative/desative a opção Ativar botão Começar quando ativar este serviço de integração.

   • Este serviço de integração ativa 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 controlador de eventos personalizado para o evento FACEBOOK_WELCOME.

Para testar:

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

   • O botão Começar só é apresentado em novas conversas.

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

3. Clique no botão Começar e valide a resposta do controlador de eventos personalizado.

Pode sempre chamar a API Messenger Profile para gerir o botão Começar. Isto pode ser útil para testar.

Por exemplo, o pedido seguinte verifica o estado do botão Começar:

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

O seguinte pedido desativa 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 suportadas através de carga útil personalizada no preenchimento. Consulte o artigo Objeto de mensagem de parâmetros da API de envio para ver o formato da mensagem.

Por exemplo, a seguinte carga útil personalizada fornece uma mensagem de texto simples:

{
  "text": "Hello, world"
}

O seguinte payload personalizado 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 a mensagens do Meta Messenger.