Workplace da Meta

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

Como funciona

A integração funciona assim:

  • Você cria uma integração do cliente que usa o Meta Workplace.
  • Você configura a integração dos agentes de conversação (Dialogflow CX) e a instância do Workplace 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 Send do Meta.
  • A integração com os agentes de conversação (Dialogflow CX) recebe mensagens do usuário final agindo como o webhook do Workplace da Meta.

Configuração

Para configurar a integração:

  1. Siga as etapas para criar uma integração personalizada do Meta Workplace: Criar uma integração personalizada do Meta Workplace.

    • Crie uma integração personalizada do Meta Workplace.
    • Você vai receber um segredo de app nesta etapa. Copie esse valor. Esse token será usado para configurar a integração do console de agentes de conversa (Dialogflow CX).
    • Crie ou redefina o token de acesso da integração. Copie esse valor. Esse token será usado para configurar a integração do console de agentes de conversa (Dialogflow CX).
    • Configure as permissões de integração personalizada. Confira se Message any member está ativado em "Permissões".
  2. 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 Workplace.
    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.

      • Token de acesso: insira o token de acesso que você copiou durante a configuração do app Meta acima.

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

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

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

  3. Conclua a configuração da integração personalizada do Meta Workplace e teste-a. Siga as etapas na documentação do Webhook para Meta Workplace para:

    • Configure o webhook do Meta para seu app. Use os valores URL do webhook e Verificar token que você copiou acima.
    • Inscreva sua integração nos tópicos de webhook. Ative messages e messaging_postbacks na assinatura da página.
    • Testar o aplicativo.

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

Quando configuradas, as respostas específicas do canal com o canal DF_CX_FB_MESSENGER são usadas automaticamente quando o agente responde às mensagens do Meta Messenger.