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 princípios básicos de fluxo.
- Execute as etapas de configuração.
- 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, baixe-o e restaure-o.
Configuração
Para configurar o acesso não autenticado ao seu agente do Dialogflow CX Messenger:
- Acesse o console do Dialogflow CX.
- Escolha seu projeto Google Cloud.
- Selecione seu agente.
- Selecione a guia Manage.
- Clique em Integrations no menu da barra lateral à esquerda.
- Clique em Conectar no Dialogflow CX Messenger.
- Uma caixa de diálogo de configuração é aberta.
- Se a integração já tiver sido configurada para esse agente, um código HTML incorporável vai aparecer. Independente de você querer o que foi autenticado ou não autenticado, clique no botão Desativar... na parte de baixo da caixa de diálogo, para reconfigurar as configurações na próxima etapa.
- Selecione um Ambiente.
- Selecione API não autenticada.
- Selecione um estilo.
- Se quiser, restrinja o acesso ao domínio.
- Clique em Ativar 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 seu ID do cliente OAuth. 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 do portador com o valor $session.params.ACCESS_TOKEN_NAME
para autenticação da ferramenta.
Atualize outros atributos que precisem de atualização.
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 na 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 de várias maneiras. Consulte a documentação do Messenger do Dialogflow CX para mais informações.