A integração do Google Chat dos agentes de conversação (Dialogflow CX) permite-lhe criar apps do Google Chat com compreensão de linguagem natural baseada na tecnologia de agentes de conversação (Dialogflow CX).
Limitações
- Apenas a entrada de texto no idioma predefinido do agente é suportada por esta integração.
Configure o Google Chat
Para configurar a integração do Google Chat para o seu agente, precisa do seguinte:
- Uma conta do Google Workspace com acesso ao Google Chat.
- Um Google Cloud projeto.
Ative a API Google Chat
Antes de usar as APIs Google, tem de as ativar num Google Cloud projeto. Pode ativar uma ou mais APIs num único Google Cloud projeto.
Na Google Cloud consola, ative a API Google Chat e a API Dialogflow.
Confirme que está a ativar as APIs no projeto do Google Cloud correto e, de seguida, clique em Seguinte.
Confirme que está a ativar as APIs corretas e, de seguida, clique em Ativar.
Configuração a partir de agentes de conversação (Dialogflow CX)
- Aceda à consola Dialogflow CX.
- Escolha o seu projeto do Google Cloud .
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Integrações no menu da barra lateral esquerda.
- Clique em Associar no Google Chat.
- Preencha as seguintes informações necessárias:
- Nome: o nome apresentado aos utilizadores que interagem com o conteúdo criado por esta app ou o consomem, como em mensagens, pesquisas e @menções. Por exemplo,
Conversational Agents (Dialogflow CX) App
. - URL do avatar: a imagem do avatar apresentada aos utilizadores que interagem com a app. Especifique um URL HTTPS que aloje uma imagem PNG quadrada (formato 1:1). Tamanho mínimo recomendado: 256 x 256 píxeis. Por exemplo,
https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
. - Descrição: uma descrição da app. Por exemplo,
A helpful bot that responds to real human conversation
.
- Nome: o nome apresentado aos utilizadores que interagem com o conteúdo criado por esta app ou o consomem, como em mensagens, pesquisas e @menções. Por exemplo,
- Escolha um ambiente, conforme aplicável.
- Introduza endereços de email para disponibilizar esta app do Chat a pessoas e grupos específicos, conforme aplicável.
- Clique em Iniciar.
Testes
Para testar a app configurada, mencione-a num espaço do Google Chat ou envie-lhe uma MD. Por exemplo,
- Abra o Google Chat.
- Clique em Novo chat.
- No campo Adicionar 1 ou mais pessoas, introduza o nome da sua app Chat.
- Selecione a app Chat nos resultados. É aberta uma mensagem direta.
Mensagens de resposta avançadas
As mensagens de resposta avançada são suportadas através de Custom Payload no Fulfillment. Consulte a API Google Chat message para ver o formato das mensagens.
Mensagem de texto
A seguinte carga útil personalizada fornece uma mensagem de texto do Google Chat:
{ "text": "Hello, world" }
Mensagem do cartão
A seguinte carga útil personalizada fornece uma mensagem de cartão 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
são usadas automaticamente quando o agente responde a mensagens do Google Chat.