Google Chat

A integração do Google Chat dos Conversational Agents (Dialogflow CX) permite-lhe criar apps do Google Chat com compreensão de linguagem natural baseada na tecnologia dos Conversational Agents (Dialogflow CX).

Limitações

Configure o Google Chat

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

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.

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

  2. Confirme que está a ativar as APIs no projeto do Google Cloud correto e, de seguida, clique em Seguinte.

  3. Confirme que está a ativar as APIs corretas e, de seguida, clique em Ativar.

Configuração a partir de agentes conversacionais (Dialogflow CX)

  1. Aceda à consola Dialogflow CX.
  2. Escolha o seu projeto do Google Cloud .
  3. Selecione o seu agente.
  4. Selecione o separador Gerir.
  5. Clique em Integrações no menu da barra lateral esquerda.
  6. Clique em Associar no Google Chat.
  7. 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.
  8. Escolha um ambiente, conforme aplicável.
  9. Introduza endereços de email para disponibilizar esta app do Chat a pessoas e grupos específicos, conforme aplicável.
  10. Clique em Iniciar.

Testes

Para testar a app configurada, mencione-a num espaço do Google Chat ou envie-lhe uma MD. Por exemplo,

  1. Abra o Google Chat.
  2. Clique em Novo chat.
  3. No campo Adicionar 1 ou mais pessoas, introduza o nome da sua app Chat.
  4. Selecione a sua 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 carga útil personalizada no preenchimento. 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"
}

A seguinte carga útil personalizada fornece uma mensagem de texto do Google Chat se estiver a usar um suplemento do Chat:

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

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

A seguinte carga útil personalizada fornece uma mensagem de cartão do Google Chat se estiver a usar um suplemento 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 são usadas automaticamente quando o agente responde a mensagens do Google Chat.