Com a integração do Google Chat aos agentes de conversação (Dialogflow CX), é possível criar apps do Google Chat com processamento de linguagem natural baseado na tecnologia dos agentes de conversação (Dialogflow CX).
Limitações
- Essa integração é compatível apenas com entrada de texto no idioma padrão do agente.
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 doGoogle Cloud .
Ativar a API Google Chat
Antes de usar as APIs do Google, é necessário ativá-las em um projeto Google Cloud . É possível ativar uma ou mais APIs em um único projeto do Google Cloud .
No console 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ê está ativando as APIs corretas e clique em Ativar.
Configurar em "Agentes de conversação (Dialogflow CX)"
- 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 Google Chat.
- Preencha as seguintes informações obrigatórias:
- Nome: o nome exibido para quem interage ou consome conteúdo criado por ele, como mensagens, pesquisa e @menções. Por exemplo,
Conversational Agents (Dialogflow CX) App
. - URL do avatar: a imagem do avatar mostrada 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 para quem interage ou consome conteúdo criado por ele, como mensagens, pesquisa e @menções. Por exemplo,
- Escolha um ambiente, conforme aplicável.
- Insira endereços de e-mail para disponibilizar o app de chat para pessoas e grupos específicos, conforme aplicável.
- Clique em Iniciar.
Teste
Para testar o app configurado, mencione-o 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 Chat.
- Selecione seu app de chat nos resultados. Uma mensagem direta será aberta.
Mensagens de resposta avançadas
As mensagens de resposta avançadas são compatíveis com o Payload personalizado em Fulfillment. Consulte a API de mensagens do Google Chat para o formato da mensagem.
Mensagem de texto
O payload personalizado a seguir fornece uma mensagem de texto do Google Chat:
{ "text": "Hello, world" }
Mensagem do card
O payload personalizado a seguir fornece uma mensagem de card do Google Chat:
{ 'cardsV2': [{ 'cardId': 'createCardMessage', 'card': { 'header': { 'title': 'A card message!', 'subtitle': 'Sent from Conversational Agents (Dialogflow CX)', '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 às mensagens do Google Chat.