Google Chat

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

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, é necessário ativá-las em um projeto do Google Cloud . É possível ativar uma ou mais APIs em um único projeto do Google Cloud .

  1. No https://console.cloud.google.com/, ative as APIs Google Chat e Dialogflow.

  2. Confirme se você está ativando as APIs no projeto correto do Cloud e clique em Próxima.

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

Configurar em Agentes de conversação (Dialogflow CX)

  1. Acesse o console do Dialogflow CX.
  2. Escolha seu Google Cloud projeto.
  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 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.
  8. Escolha um ambiente, conforme aplicável.
  9. Insira endereços de e-mail para disponibilizar o app de chat para 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 app Chat.
  4. Selecione seu app de 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 de mensagens do Google Chat para o formato de mensagem.

Mensagem de texto

O payload personalizado a seguir fornece uma mensagem de texto do Google Chat:

{
  "text": "Hello, world"
}

O payload personalizado a seguir fornece uma mensagem de texto do Google Chat se você estiver usando um complemento do Chat:

        {
            hostAppDataAction: {
              chatDataAction: {
                createMessageAction: {
                  message: {
                    text: "Your pizza delivery is here!"
                  }
                }
              }
            }
        }

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'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

O payload personalizado a seguir fornece uma mensagem de card do Google Chat se você estiver usando um complemento do Chat:

{
  "host_app_data_action": {
    "chat_data_action": {
      "create_message_action": {
        "message": {
          "cardsV2": [
            {
              "card_id": "basic1",
              "card": {
                "header": {
                  "title": "This is a card!",
                  "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": "Open Google!",
                              "color": {
                                "red": 0.101960786,
                                "green": 0.4509804,
                                "blue": 0.9098039
                              },
                              "onClick": {
                                "openLink": {
                                  "url": "http://google.com"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

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.