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 (opcional) 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:
- Leia os conceitos básicos de fluxo.
- Execute as etapas de configuração .
- Realize 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, você pode fazer o download do agente e restaurá-lo.
Configuração
Para configurar o acesso não autenticado ao agente do Dialogflow CX Messenger:
- Acesse o console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Manage.
- Clique em Integrations no menu da barra lateral à esquerda.
- Clique em Connect no Dialogflow CX Messenger.
- Uma caixa de diálogo de configuração é aberta.
- 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 foi autenticado ou não autenticado, clique no botão Disable... na parte de baixo da caixa de diálogo para reconfigurar as definições na próxima etapa.
- Selecione um Ambiente.
- Selecione Unauthenticated API.
- Selecione um estilo.
- Opcionalmente, restrinja o acesso ao domínio.
- Clique em Habilitar a API não autenticada.
- A caixa de diálogo vai mostrar o código HTML incorporável que pode ser incorporado ao seu site. Copie esse código.
- 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 o ID do cliente OAuth. E, se quiser usar as identidades dos usuários finais para autenticação
de ferramentas,
defina o atributo access-token-name com qualquer nome que quiser.
Em seguida, use o token de portador com o valor $session.params.ACCESS_TOKEN_NAME
para autenticação de ferramentas.
Atualize todos os outros atributos que precisam ser atualizados.
Para permitir layouts responsivos,
adicione também o seguinte elemento <head>:
<meta name="viewport" content="width=device-width, initial-scale=1">
Depois de incorporado, você pode interagir com o agente na página da Web clicando no ícone de chat no canto inferior direito.
Personalizar
Você pode personalizar a aparência e o comportamento dessa interface de usuário de várias maneiras. Consulte a documentação do Dialogflow CX Messenger para mais informações.