A integração do Google Chat com o Dialogflow CX permite criar apps do Google Chat com processamento de linguagem natural baseado na tecnologia Dialogflow CX.
Limitações
- Somente a entrada de texto no idioma padrão do agente é compatível com essa integração.
Configurar o Google Chat
Para configurar a integração do agente com o Google Chat, é necessário o seguinte:
- Uma conta do Google Workspace com acesso ao Google Chat.
- um projeto do Google Cloud;
Ative a API Google Chat
Antes de usar as APIs do Google, é preciso ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.
No console do Google Cloud, ative a API Google Chat e a API Dialogflow.
Confirme se você está ativando as APIs no projeto correto do Cloud e clique em Próxima.
Confirme se você ativou as APIs corretas e clique em Ativar.
Configurar no Dialogflow CX
- 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 Conectar no Google Chat.
- Preencha as seguintes informações:
- Nome: o nome exibido aos usuários que interagem ou consomem conteúdo criado pelo app, como em mensagens, pesquisas e @menções. Por exemplo,
Dialogflow CX App
. - URL do avatar: é a imagem do avatar que é exibida aos usuários que interagem com o app. Especifique um URL HTTPS que hospede uma imagem PNG quadrada (proporção de 1:1). Tamanho mínimo recomendado: 256 por 256 pixels. Por exemplo,
https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
. - Descrição: uma descrição do app. Por exemplo,
A helpful bot that responds to real human conversation
.
- Nome: o nome exibido aos usuários que interagem ou consomem conteúdo criado pelo app, como em mensagens, pesquisas e @menções. Por exemplo,
- Escolha um Ambiente conforme aplicável.
- Digite endereços de e-mail para disponibilizar este app do Chat para pessoas e grupos específicos.
- Clique em Iniciar.
testes
Para testar o app configurado, mencione o app em um espaço do Google Chat ou envie uma mensagem direta. Por exemplo:
- Abra o Google Chat.
- Clique em Novo chat.
- No campo Adicionar uma ou mais pessoas, digite o nome do app do Chat.
- Selecione o app do Chat nos resultados. Uma mensagem direta vai aparecer.
Mensagens de resposta avançadas
As mensagens de resposta avançada são compatíveis com o uso do Payload personalizado em Fulfillment. Consulte o formato das mensagens em API de mensagens do Google Chat.
Mensagem de texto
O payload personalizado a seguir fornece uma mensagem de texto do Google Chat:
{ "text": "Hello, world" }
Mensagem do cartão
O payload personalizado a seguir fornece uma mensagem de cartão do chat do Google:
{ 'cardsV2': [{ 'cardId': 'createCardMessage', 'card': { 'header': { 'title': 'A card message!', 'subtitle': 'Sent from Dialogflow', 'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png', 'imageType': 'CIRCLE' }, 'sections': [ { 'widgets': [ { 'buttonList': { 'buttons': [ { 'text': 'Read the docs!', 'onClick': { 'openLink': { 'url': 'https://developers.google.com/workspace/chat' } } } ] } } ] } ] } }] }
Respostas específicas do canal
Quando configuradas, as respostas específicas do canal com o canal DF_CX_GOOGLE_CHAT
serão usadas automaticamente quando o agente responder a mensagens do Google Chat.