Google Chat

La integración de Google Chat de Conversational Agents (Dialogflow CX) te permite crear aplicaciones de Google Chat con comprensión del lenguaje natural basadas en la tecnología de Conversational Agents (Dialogflow CX).

Limitaciones

Configurar Google Chat

Para configurar la integración de Google Chat en tu agente, necesitas lo siguiente:

Habilitar la API de Google Chat

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

  1. En la Google Cloud consola, habilita la API de Google Chat y la API de Dialogflow.

  2. Confirma que vas a habilitar las APIs en el proyecto de Cloud correcto y, a continuación, haz clic en Siguiente.

  3. Comprueba que estés habilitando las APIs correctas y, a continuación, haz clic en Habilitar.

Configuración de Conversational Agents (Dialogflow CX)

  1. Ve a la consola de Dialogflow CX.
  2. Elige tu proyecto de Google Cloud .
  3. Selecciona tu agente.
  4. Selecciona la pestaña Gestionar.
  5. En el menú de la barra lateral de la izquierda, haz clic en Integraciones.
  6. Haz clic en Conectar en Google Chat.
  7. Rellena la siguiente información obligatoria:
    • Nombre: el nombre que se muestra a los usuarios que interactúan con el contenido creado por esta aplicación o lo consumen, como en mensajes, búsquedas y menciones con @. Por ejemplo, Conversational Agents (Dialogflow CX) App.
    • URL del avatar: imagen del avatar que se muestra a los usuarios que interactúan con la aplicación. Especifica una URL HTTPS que aloje una imagen PNG cuadrada (relación de aspecto de 1:1). Se recomienda que las imágenes tengan unas dimensiones mínimas de 256 x 256 píxeles. Por ejemplo, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    • Descripción: una descripción de la aplicación. Por ejemplo, A helpful bot that responds to real human conversation.
  8. Elige un entorno según corresponda.
  9. Introduce las direcciones de correo para que esta aplicación de Chat esté disponible para personas y grupos específicos, según corresponda.
  10. Haz clic en Empezar.

Pruebas

Para probar la aplicación que has configurado, menciónala en un espacio de Google Chat o envíale un mensaje directo. Por ejemplo,

  1. Abre Google Chat.
  2. Haz clic en Nuevo chat.
  3. En el campo Añadir 1 o más personas, escribe el nombre de tu aplicación de Chat.
  4. Selecciona tu aplicación de Chat en los resultados. Se abrirá un mensaje directo.

Mensajes de respuesta enriquecidos

Los mensajes de respuesta enriquecida se admiten mediante Custom Payload (Carga útil personalizada) en Fulfillment (Cumplimiento). Consulta el formato de los mensajes en la API de mensajes de Google Chat.

Mensaje de texto

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

{
  "text": "Hello, world"
}

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

Respuestas específicas de un canal

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