Interações com uma integração

Com uma integração, as interações do usuário final são processadas para você. Basta criar um agente, implementar um webhook (opcional) e configurar a integração.

Neste guia, mostramos como usar a integração do Dialogflow CX Messenger para fornecer uma interface do usuário de chat de texto simples 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 de 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

Observação :as etapas abaixo criam uma integração que permite o acesso não autenticado à consulta do agente. Consulte a documentação do Dialogflow CX Messenger para ver instruções sobre como criar uma integração autenticada.

Observação: verifique se o faturamento está ativado no projeto antes de testar a integração.

Para configurar o acesso não autenticado ao 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 já tiver sido configurada para esse agente, você vai encontrar um código HTML incorporável. Independentemente de você querer o que é autenticado ou não, clique no botão Desativar… na parte de baixo da caixa de diálogo para redefinir 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 que pode ser incorporado ao 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 para <df-messenger> como seu ID do cliente OAuth. Se você quiser usar as identidades dos usuários finais para a autenticação de ferramentas, defina o atributo access-token-name com o nome que preferir. 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 incorporado, você pode interagir com o agente pela página da Web clicando no ícone de chat no canto inferior direito.

Personalizar

É 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.