Workplace from 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 Workplace, pode criar um bot do Meta Workplace 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

Veja como funciona a integração:

• Cria uma integração de clientes que usa o Meta Workplace.
• Configura a integração dos agentes conversacionais (Dialogflow CX) e da instância do Workplace para que comuniquem entre si.
• A integração de agentes conversacionais (Dialogflow CX) envia mensagens ao utilizador final através da API Send da Meta.
• A integração de agentes conversacionais (Dialogflow CX) recebe mensagens do utilizador final atuando como o webhook do Workplace da Meta.

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 integração personalizada do Meta Workplace: Criar uma integração personalizada do Meta Workplace.

   • Crie uma integração personalizada do Meta Workplace.
   • Neste passo, é-lhe fornecido um segredo da app. Copie este valor. Este token vai ser usado para configurar a integração a partir da consola de agentes conversacionais (Dialogflow CX).
   • Crie ou reponha a chave de acesso da sua integração. Copie este valor. Este token vai ser usado para configurar a integração a partir da consola de agentes conversacionais (Dialogflow CX).
   • Configure as autorizações de integração personalizada. Certifique-se de que a opção Message any member está ativada em Autorizações.

2. 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 Associar no mosaico Meta Workplace.

   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.

      • Token de acesso: introduza o token de acesso que copiou durante a configuração da app Meta acima.

      • Validar token: pode introduzir qualquer token privado que quiser. Copiar este valor. Isto vai ser usado para configurar o webhook do Meta Workplace.

      • URL do webhook: copie este valor. Esta informação vai ser usada para configurar o webhook do Meta Workplace.

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

3. Conclua a configuração da integração personalizada do Meta Workplace e teste-a. Siga os passos na documentação Webhook para o Meta Workplace 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.
   • Subscreva a sua integração nos tópicos do webhook. Certifique-se de que ativa o messages e o messaging_postbacks na subscrição da página.
   • Teste a sua app.

Mensagens de resposta avançadas

As mensagens de resposta avançada são suportadas através de Custom Payload no Fulfillment. 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

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