Integración de Dialogflow con Google Chat

Al integrar Dialogflow con Google Chat, puedes aprovechar las funciones de ambos servicios:

  • Google Chat. Proporciona una plataforma de mensajería con una interfaz de usuario de frontend para conversaciones individuales y espacios de chat. Con Google Chat, puedes mejorar las interfaces de usuario creando tarjetas que incluyan iconos, imágenes, botones, campos de entrada de texto o aplicaciones como Google Maps.
  • Dialogflow. Proporciona una plataforma de comprensión del lenguaje natural para conversaciones automatizadas y respuestas dinámicas. Con Dialogflow, puedes interpretar y satisfacer las intenciones de los usuarios, por ejemplo, para concertar citas o procesar compras.

Aunque también puedes usar Google Chat para responder a las solicitudes de los usuarios, Dialogflow permite que los usuarios expresen sus solicitudes mediante una conversación normal.

Cómo funciona

Una vez que hayas creado una aplicación de Google Chat con Dialogflow, podrás ponerla a disposición de los siguientes usuarios:

  • Público en general. Los usuarios con licencia de Google Workspace pueden descargar tu aplicación a través de Google Workspace Marketplace.
  • Dominio de Google Workspace. Un administrador de Google Workspace puede especificar qué aplicaciones pueden añadir los usuarios a Google Chat.
  • Testers de aplicaciones. Mientras pruebas tu aplicación, puedes restringir el acceso a ella.

En Google Chat, los usuarios pueden mantener una conversación directa con tu aplicación o invocarla desde un espacio. Esto es lo que ocurre:

  1. Un usuario envía un mensaje a una aplicación de Chat.
  2. Google Chat envía una solicitud JSON a la aplicación de Chat, que podría estar alojada en Cloud Functions.
  3. La aplicación Chat recibe la solicitud JSON y la analiza. Durante este análisis, la aplicación de Chat invoca a Dialogflow.
  4. La aplicación de chat envía una solicitud a Dialogflow que incluye el texto del mensaje en lenguaje natural del usuario.
  5. Dialogflow interpreta el texto del usuario y envía una respuesta a la aplicación de chat.
  6. La aplicación Chat analiza la respuesta de Dialogflow y envía una respuesta JSON a Google Chat.
  7. Google Chat recibe la respuesta JSON de la aplicación de chat y muestra una respuesta en forma de mensaje de texto, mensaje de tarjeta o mensaje de diálogo en la interfaz de usuario.
  8. Google Chat comparte esta respuesta tal cual o presenta una respuesta enriquecida mediante una interfaz de usuario basada en tarjetas.

En esta página se describe cómo integrar Dialogflow con Google Chat y configurar respuestas de chat enriquecidas.

Limitaciones

Con las integraciones de Google Chat, un agente de Dialogflow solo puede usar el idioma predeterminado del agente.

Antes de empezar

Solo los usuarios de Google Workspace con licencia pueden usar las aplicaciones de Google Chat. Tu administrador de Google Workspace debe hacer lo siguiente:

Crear un agente de Dialogflow

Si aún no has creado un agente de Dialogflow, pero quieres ver cómo interactúa un agente con Google Chat, sigue esta guía de inicio rápido para crear un agente sencillo. Sin embargo, no elimines el agente. A continuación, configuramos el agente con una interfaz de Google Chat.

Configurar Google Chat

Para configurar tu agente de Dialogflow con Google Chat, puedes usar cualquiera de las siguientes opciones:

Configurar Google Chat mediante la consola de Dialogflow

Para integrar Google Chat mediante la consola de Dialogflow, sigue estos pasos:

  1. Ve a la consola de Dialogflow ES.
  2. En el menú de la izquierda, selecciona un proyecto de Dialogflow.
  3. Haz clic en Integrations (Integraciones).
  4. Haz clic en Google Chat. Si Google Chat no es una de las opciones, consulta la sección Solucionar problemas.
  5. Selecciona quién puede acceder a la aplicación.
  6. [Opcional] Selecciona un entorno para ejecutar el agente.
  7. Haz clic en Empezar.

Tu aplicación Google Chat ya está disponible para los usuarios que has seleccionado.

Para configurar la aplicación, vuelve a hacer clic en Google Chat y, a continuación, en CONFIGURAR DETALLES DEL BOT. Se muestra la Google Cloud página de la consola de la API Google Chat, donde puedes configurar parámetros de la aplicación como el avatar de la aplicación.

Configurar Google Chat mediante la Google Cloud consola

Para integrar Google Chat mediante la consola Google Cloud , sigue estos pasos:

  1. Selecciona el proyecto de Dialogflow.

    Ir al selector de proyectos

  2. Haz clic en .

  3. Haz clic en APIs y servicios y, a continuación, en Biblioteca.

  4. Busca API de Google Chat y haz clic en ella.

  5. Haz clic en Enable (Habilitar).

  6. Haz clic en la pestaña Configuration (Configuración).

  7. Configura la aplicación.

  8. En el panel Visibilidad, selecciona quién puede acceder a la aplicación:

    • Testers de aplicaciones. Selecciona Hacer que esta conversación esté disponible para personas concretas e introduce sus direcciones de correo.
    • Dominio público general o de Google Workspace Enterprise. Publica la aplicación.

  9. Haz clic en Guardar. Tu aplicación Google Chat ya está disponible para los usuarios que hayas seleccionado.

Prueba

Antes de probar tu aplicación de Chat, asegúrate de que la has iniciado, tal como se describe en el artículo Configurar Google Chat.

Puedes probar tu aplicación con cualquiera de estos métodos:

Chatear directamente con la aplicación

  1. Abre Google Chat.
  2. En el panel Chat, haz clic en + y selecciona Buscar aplicaciones.
  3. Busca y selecciona tu aplicación. Si Google Chat no muestra tu aplicación, consulta la sección Solucionar problemas.
  4. Haz clic en Chat.
  5. En el campo de entrada del chat, escribe una frase en lenguaje natural para probar la aplicación.

Invocar la aplicación desde un espacio

  1. Abre Google Chat.
  2. En el panel Espacios, haz clic en + y selecciona Crear un espacio.
  3. Escribe el nombre del espacio Prueba.
  4. Haz clic en Crear.
  5. En el campo de entrada del chat, escribe @ y selecciona la aplicación para autocompletar el nombre.
  6. Después del nombre de la aplicación que se ha autocompletado, introduce una frase en lenguaje natural para probar la aplicación.

Solucionar problemas

Error Solución
En la página Integraciones de la consola de Dialogflow ES, Google Chat no aparece como opción. Prueba a actualizar la página: en el menú de la izquierda, haz clic en Intenciones y, a continuación, en Integraciones.
Google Chat no muestra tu aplicación como disponible. Asegúrate de que tu administrador de Google Workspace haya añadido una cuenta de Google Workspace para ti y haya permitido que los usuarios instalen aplicaciones de Chat. Después, asegúrate de que has iniciado la aplicación Chat, tal como se describe en Configurar Google Chat.

Mensajes de respuesta enriquecidos

Esta integración traduce algunos mensajes de respuesta enriquecida a formatos de mensajes de Google Chat.

Respuestas de texto

Las respuestas de texto se envían a Google Chat como mensajes de texto. Con este formato, puedes poner texto en negrita o cursiva envolviéndolo en determinados símbolos (Markdown ligero).

La respuesta de mensaje de texto tiene el mismo aspecto que la respuesta de texto predeterminada en la consola de Dialogflow. Sin embargo, la respuesta de la API sin procesar tendrá un aspecto ligeramente diferente. También define la configuración de la plataforma como GOOGLE_HANGOUTS, lo que puede ser útil al crear agentes para varias integraciones.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

Tarjetas

Las respuestas de tarjetas se envían a Google Chat como mensajes de tarjetas.

Imágenes

Las respuestas con imágenes se envían a Google Chat como widgets de imágenes de Google Chat.

Carga útil personalizada

Para enviar otros tipos de mensajes de Google Chat, puedes usar una carga útil personalizada.

Google Chat Custom Payload te permite crear tarjetas más avanzadas. Una tarjeta puede tener una o varias secciones. Cada sección puede tener un encabezado. Puedes consultar la guía de referencia de tarjetas de formatos de mensajes de Google Chat para ver algunas de las combinaciones que puedes crear con esta función. Sin embargo, si usas cargas útiles personalizadas, tendrás que proporcionar el formato JSON.

A continuación, se muestra un ejemplo de carga útil personalizada con el formato Cards v1:

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "pizzadelivery@example.com",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - I could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}

Detener la aplicación Chat

Para que la aplicación Google Chat deje de estar disponible, puedes hacer lo siguiente:

Detener la aplicación Chat con la consola de Dialogflow

  1. Ve a la consola de Dialogflow ES.
  2. En el menú de la izquierda, selecciona un proyecto de Dialogflow.
  3. Haz clic en Integrations (Integraciones).
  4. Haz clic en Google Chat. Si Google Chat no es una de las opciones, consulta la sección Solucionar problemas.
  5. Haz clic en Detener.

Detener la aplicación Chat con la consola Google Cloud

  1. Selecciona el proyecto de Dialogflow en la Google Cloud consola.

    Ir al selector de proyectos

  2. Haz clic en .

  3. Haz clic en APIs y servicios y, a continuación, en Biblioteca.

  4. Busca API de Google Chat y haz clic en ella.

  5. Haz clic en Gestionar.

  6. Haz clic en la pestaña Configuration (Configuración).

  7. En el campo Estado de la aplicación, selecciona INHABILITADA.

Más información

Para obtener más información sobre cómo usar Google Chat, consulta los siguientes artículos: