Google Chat

A integração do Google Chat com os agentes de conversação (Dialogflow CX) permite criar apps do Google Chat com compreensão de linguagem natural com base na tecnologia dos agentes de conversação (Dialogflow CX).

Limitações

Configurar o Google Chat

Para configurar a integração do agente com o Google Chat, é necessário o seguinte:

Ativar a API Google Chat

Antes de usar as APIs do Google, você precisa ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.

  1. No console do Google Cloud, ative a API Google Chat e a API Dialogflow.

  2. Confirme que você está ativando as APIs no projeto do Cloud correto e clique em Next.

  3. Confirme se você está ativando as APIs corretas e clique em Ativar.

Configurar usando agentes de conversação (Dialogflow CX)

  1. Acesse o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Manage.
  5. Clique em Integrations no menu da barra lateral à esquerda.
  6. Clique em Conectar no Google Chat.
  7. Preencha as seguintes informações obrigatórias:
    • Nome: o nome mostrado para usuários que interagem ou consomem conteúdo criado por esse app, como mensagens, pesquisa e @menções. Por exemplo, Conversational Agents (Dialogflow CX) App.
    • URL do avatar: a imagem do avatar que aparece para os 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.
  8. Escolha um ambiente conforme aplicável.
  9. Insira os endereços de e-mail para disponibilizar o app de chat a pessoas e grupos específicos, conforme aplicável.
  10. 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,

  1. Abra o Google Chat.
  2. Clique em Novo chat.
  3. No campo Adicionar uma ou mais pessoas, digite o nome do seu app de chat.
  4. Selecione o app Chat nos resultados. Uma mensagem direta é 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 Message do Google Chat para conferir 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 são usadas automaticamente quando o agente responde às mensagens do Google Chat.