Google Chat

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

Limitações

Configurar o Google Chat

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

Ativar a API Google Chat

Antes de usar as APIs do Google, é preciso 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 a API Google Chat e a API Dialogflow.
  2. Verifique se você está ativando as APIs no projeto correto na nuvem e clique em Próxima.
  3. Verifique se você está ativando as APIs corretas e clique em Ativar.

Configurar no Dialogflow CX

  1. Acesse o console do Dialogflow CX.
  2. Selecionar o projeto Google Cloud .
  3. Selecione seu agente.
  4. Acesse a guia Gerenciar no menu de navegação.
  5. Selecione Integrações.
  6. Clique em Conectar no Google Chat.
  7. Preencha as seguintes informações necessárias:
    • Nome:o nome mostrado para quem interage ou consome 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.
    • Ambiente:o ambiente ao qual se conectar. Selecione um Ambiente, conforme aplicável.
  8. Insira endereços de e-mail para disponibilizar o app do Chat para pessoas e grupos específicos, conforme aplicável.
  9. Clique em Iniciar.

Teste

Para testar o app configurado, mencione-o em um espaço do Google Chat ou envie uma mensagem direta.

Exemplo:

  1. Abra o Google Chat.
  2. Clique em Novo Chat.
  3. No campo Adicionar uma ou mais pessoas, digite o nome do app do Chat.
  4. Selecione o app do Chat nos resultados. Uma mensagem direta é aberta.

Mensagens de resposta avançadas

É possível oferecer suporte a mensagens de resposta avançadas usando o payload personalizado no fulfillment. Consulte a API de mensagens do Google Chat para saber mais sobre o formato de mensagens.

Mensagem de texto

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

{
  "text": "Hello, world"
}

Se você estiver usando um complemento do Chat, o payload personalizado a seguir fornecerá uma mensagem de texto do Google Chat:

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

Mensagem do cartão

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 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:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "cardsV2": [
            {
              "cardId": "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 às mensagens do Google Chat.