Google Chat

La integración de Google Chat para Dialogflow CX te permite crear apps de Google Chat con comprensión del lenguaje natural basada en la tecnología de Dialogflow CX.

Limitaciones

Configura Google Chat

Para configurar la integración de Google Chat para tu agente, necesitarás lo siguiente:

Habilita la API de Google Chat

Antes de usar las APIs de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más APIs en un solo proyecto de Google Cloud.

  1. En la https://console.cloud.google.com/, habilita la API de Google Chat y la API de Dialogflow.
  2. Verifica que estés habilitando las APIs en el proyecto de Cloud correcto y, luego, haz clic en Siguiente.
  3. Verifica que estés habilitando las APIs correctas y, luego, haz clic en Habilitar.

Configura desde Dialogflow CX

  1. Ve a la consola de Dialogflow CX.
  2. Seleccionar tu Google Cloud proyecto.
  3. Selecciona el agente.
  4. Ve a la pestaña Administrar en el menú de navegación.
  5. Selecciona Integraciones.
  6. Haz clic en Conectar en Google Chat.
  7. Completa la siguiente información obligatoria:
    • Nombre: Es el nombre que se muestra a los usuarios que interactúan con el contenido creado por esta app o que lo consumen, como en mensajes, búsquedas y @menciones. Por ejemplo, Dialogflow CX App.
    • URL del avatar: Es la imagen de avatar que se muestra a los usuarios que interactúan con la app. Especifica una URL HTTPS que aloje una imagen PNG cuadrada (con una relación de aspecto de 1:1). Tamaño mínimo recomendado: 256 por 256 píxeles. Por ejemplo, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    • Descripción: Es una descripción de la app, por ejemplo, A helpful bot that responds to real human conversation.
    • Entorno: Es el entorno al que se conectará. Selecciona un entorno según corresponda.
  8. Ingresa direcciones de correo electrónico para que esta app de Chat esté disponible para personas y grupos específicos, según corresponda.
  9. Haz clic en Iniciar.

Pruebas

Para probar la app configurada, menciónala en un espacio de Google Chat o envía un mensaje directo.

Por ejemplo:

  1. Abre Google Chat.
  2. Haz clic en Nuevo chat.
  3. En el campo Agrega 1 o más personas, ingresa el nombre de tu app de Chat.
  4. Selecciona tu app de Chat en los resultados. Se abrirá un mensaje directo.

Mensajes de respuesta enriquecida

Puedes admitir mensajes de respuesta enriquecidos con la carga útil personalizada en Fulfillment. Consulta la API de mensajes de Google Chat para obtener información sobre el formato de los mensajes.

Mensaje de texto

La siguiente carga útil personalizada proporciona un mensaje de texto de Google Chat:

{
  "text": "Hello, world"
}

Si usas un complemento de Chat, la siguiente carga útil personalizada proporciona un mensaje de texto de Google Chat:

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

Mensaje de la tarjeta

La siguiente carga útil personalizada proporciona un mensaje de tarjeta de 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"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

La siguiente carga útil personalizada proporciona un mensaje de tarjeta de Google Chat si usas un complemento de 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"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

Respuestas específicas del canal

Cuando se configuran, las respuestas específicas del canal con el canal DF_CX_GOOGLE_CHAT se usan automáticamente cuando el agente responde a los mensajes de Google Chat.