La integración de Google Chat de los agentes conversacionales (Dialogflow CX) te permite crear apps de Google Chat con comprensión del lenguaje natural basada en la tecnología de agentes conversacionales (Dialogflow CX).
Limitaciones
- Esta integración solo admite la entrada de texto en el idioma predeterminado del agente.
Configura Google Chat
Para configurar la integración de Google Chat para tu agente, necesitarás lo siguiente:
- Una cuenta de Google Workspace con acceso a Google Chat
- Un proyecto de Google Cloud
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.
En la consola de Google Cloud, habilita la API de Google Chat y la API de Dialogflow.
Confirma que estás habilitando las APIs en el proyecto de Cloud correcto y, luego, haz clic en Siguiente.
Confirma que estás habilitando las APIs correctas y, luego, haz clic en Habilitar.
Configuración desde agentes conversacionales (Dialogflow CX)
- Ve a la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la pestaña Administrar.
- Haz clic en Integrations, en el menú de la barra lateral izquierda.
- Haz clic en Conectar en Google Chat.
- Completa la siguiente información obligatoria:
- Nombre: Es 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,
Conversational Agents (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
.
- Nombre: Es 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,
- Elige un entorno según corresponda.
- Ingresa direcciones de correo electrónico para que esta app de Chat esté disponible para personas y grupos específicos según corresponda.
- 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:
- Abre Google Chat.
- Haz clic en Nuevo chat.
- En el campo Agregar 1 o más personas, escribe el nombre de tu app de Chat.
- Selecciona tu app de Chat en los resultados. Se abrirá un mensaje directo.
Mensajes de respuesta enriquecida
Los mensajes de respuesta enriquecida son compatibles con la carga útil personalizada en Entregas. Consulta la API de mensajes de Google Chat para ver el formato de los mensajes.
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 del canal
Cuando se configuren, 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.