Interações com uma integração

Com uma integração, as interações do usuário final são processadas para você. Você só precisa criar um agente, implementar um webhook opcionalmente e configurar a integração.

Este guia mostra como usar a integração do Dialogflow CX Messenger para fornecer uma interface de usuário simples de chat para seu agente.

Antes de começar

Se você não planeja usar uma integração, pule este guia de início rápido.

Faça o seguinte antes de ler este guia:

  1. Leia os conceitos básicos do fluxo.
  2. Execute as etapas de configuração.
  3. Siga as etapas no guia de início rápido Criar um agente usando fluxos. As etapas abaixo continuam funcionando no mesmo agente. Se você não tiver mais esse agente, faça o download dele e restaure-o.

Configuração

Para configurar o acesso não autenticado ao seu agente do Dialogflow CX Messenger:

  1. Acesse o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Manage.
  5. Clique em Integrations no menu da barra lateral à esquerda.
  6. Clique em Conectar no Dialogflow CX Messenger.
  7. Uma caixa de diálogo de configuração é aberta.
  8. Se a integração tiver sido configurada anteriormente para esse agente, você vai encontrar o código HTML incorporável. Independentemente de você querer autenticar ou não, clique no botão Desativar... na parte de baixo da caixa de diálogo para reconfigurar as configurações na próxima etapa.
  9. Selecione um Ambiente.
  10. Selecione API não autenticada.
  11. Selecione um estilo.
  12. Opcionalmente, restrinja o acesso ao domínio.
  13. Clique em Ativar a API não autenticada.
  14. A caixa de diálogo vai mostrar o código HTML incorporável que pode ser incorporado no seu site. Copie esse código.
  15. Clique em Concluído.

Incorporar

Cole o código de incorporação que você copiou em uma página da Web do seu site. Os elementos HTML <script> e <df-messenger> devem estar no elemento <body> da sua página.

Se você estiver usando uma integração autenticada, defina o atributo oauth-client-id de <df-messenger> para o ID do cliente OAuth. Se você quiser usar as identidades dos usuários finais para autenticar a ferramenta, defina o atributo access-token-name com qualquer nome. Em seguida, use o token do portador com o valor $session.params.ACCESS_TOKEN_NAME para autenticação da ferramenta.

Atualize todos os outros atributos que precisam ser atualizados.

Para permitir layouts responsivos, adicione também o seguinte ao elemento <head>:

<meta name="viewport" content="width=device-width, initial-scale=1">

Depois de fazer a incorporação, é possível interagir com o agente pela página da Web clicando no ícone de chat no canto inferior direito.

Captura de tela da interface do Messenger

Customize

É possível personalizar a aparência e o comportamento dessa interface do usuário de várias maneiras. Consulte a documentação do Dialogflow CX Messenger para mais informações.