Google Chat

A integração do Dialogflow CX com o Google Chat permite criar apps do Google Chat com compreensão de linguagem natural com base na tecnologia do Dialogflow CX.

Limitações

  • Essa integração oferece suporte apenas a entrada de texto no idioma padrão do agente é compatível com esta integração.

Configurar o Google Chat

Para configurar a integração do Google Chat para seu agente, você precisa do seguinte:

Ativar a API Google Chat

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

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

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

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

Configurar no Dialogflow CX

  1. Acesse o console do Dialogflow CX.
  2. Escolha o 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 Connect em Google Chat.
  7. Preencha as seguintes informações obrigatórias:
    • Nome: o nome mostrado aos usuários que interagem ou consomem conteúdo criado por esse app, como mensagens, pesquisa e @menções. Por exemplo, 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 esse 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 1 ou mais pessoas, digite o nome do app de chat.
  4. Selecione o 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 de chat 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 message:

{
  "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 de ficha de informações

O payload personalizado a seguir fornece uma mensagem de cartão do Google Chat card message:

{
  'cardsV2': [{
    'cardId': 'createCardMessage',
    'card': {
      'header': {
        'title': 'A card message!',
        'subtitle': 'Sent from 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 ficha de informações 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 a mensagens do Google Chat.