Google Chat

La integración de Google Chat de 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 Google Cloud proyecto. Puedes activar una o más APIs en un solo Google Cloud proyecto.

  1. En la https://console.cloud.google.com/, habilita la API de Google Chat y la API de Dialogflow.

  2. Confirma que estás habilitando las APIs en el proyecto de Cloud correcto y, luego, haz clic en Siguiente.

  3. Confirma 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. Elige tu Google Cloud proyecto.
  3. Selecciona el agente.
  4. Selecciona la pestaña Administrar.
  5. Haz clic en Integrations , en el menú de la barra lateral izquierda.
  6. Haz clic en Conectar en Google Chat.
  7. Completa la siguiente información obligatoria:
    • Nombre: El nombre que se muestra a los usuarios que interactúan o consumen el contenido creado por esta app, como mensajes, búsquedas y menciones comenzadas con @. Por ejemplo, Dialogflow CX App.
    • URL del avatar: 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: Una descripción de la app. Por ejemplo, A helpful bot that responds to real human conversation.
  8. Elige un entorno , según corresponda.
  9. Ingresa las direcciones de correo electrónico para que esta app de Chat esté disponible para personas y grupos específicos, según corresponda.
  10. Haz clic en Iniciar.

Prueba

Para probar la app configurada, menciónala en un espacio de Google Chat o envíale un MD. Por ejemplo:

  1. Abre Google Chat.
  2. Haz clic en Nuevo chat.
  3. En el campo Agregar 1 o más personas, escribe 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

Los mensajes de respuesta enriquecida se admiten con carga útil personalizada en Entregas. Consulta la API de mensajes de Google Chat para ver el formato del mensaje.

Mensaje de texto

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

{
  "text": "Hello, world"
}

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

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

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

{
  "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"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

Respuestas específicas del canal

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