Integración de Google Chat en Dialogflow

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

La integración de Google Chat con Dialogflow te permite crear apps de Chat que puedas incluir en conversaciones individuales y en espacios de chat. Si desea obtener más información, consulte la documentación para desarrolladores de Google Chat.

Limitaciones

Esta integración solo admite el lenguaje de agente predeterminado.

Configurar

Para configurar y habilitar la integración de Google Chat, sigue estos pasos:

  1. Haz clic en Integraciones en el menú de la izquierda.
  2. Haz clic en Hangouts Chat.
  3. Selecciona una opción de acceso.
  4. Selecciona un entorno de agente (opcional).
  5. Haz clic en Start.

Configura tu app de Chat

Una vez que se crea la app de Google Chat, puedes cambiar los detalles haciendo clic en el botón CONFIGURAR DETALLES BOT en la ventana emergente de integración. Esto te llevará a la página de Google Cloud Console para la API de Google Chat.

Sigue las instrucciones de la guía de publicación de apps de la API de Google Chat para configurar y publicar tu app.

Configura tu avatar de la app de Chat

Hay dos alternativas para configurar el avatar de tu app:

  • Haz clic en el botón CONFIGURAR LOS DETALLES DEL BOT en la configuración de integración e ingresa una URL de avatar en el campo URL de avatar.
  • Ingresa una URL de avatar en el campo URI de avatar del agente en la configuración general del agente.

Habilita y configura con Google Cloud Console

La integración de Google Chat también se puede habilitar a través de Google Cloud Console mediante los siguientes pasos:

  1. En Google Cloud Console, haz clic en el ícono de menú en la esquina superior izquierda.
  2. Haz clic en API y servicios y luego en Panel.
  3. Haz clic en HABILITAR API Y SERVICIOS.
  4. Busca “API de Google Chat”.
  5. Haz clic en el mosaico de la API de Google Chat.
  6. Haga clic en Habilitar.
  7. Haz clic en Configuración en el menú de la barra lateral izquierda.
  8. Sigue las instrucciones de la guía de publicación de apps de la API de Google Chat para configurar y publicar tu app.

Probar

Antes de probar la aplicación de Chat, asegúrate de haberla iniciado (consulta la sección Configurar).

Para probar tu app, sigue estos pasos:

  1. Abre Google Chat.
    1. Para enviar un nuevo mensaje directo a la aplicación, haga clic en Iniciar un chat &Buscar aplicaciones.
    2. En la página Buscar aplicaciones, busca el nombre de la aplicación.
    3. Junto a tu app, haz clic en Chat.
    4. En el nuevo mensaje directo con la app, escribe Hello y presiona enter.

Soluciona problemas

Error Solución
Tu administrador te impidió hablar con apps en mensajes directos. Pídele al administrador de Google Workspace que permita que los usuarios instalen apps de Chat.

Mensajes de respuesta enriquecida

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

Respuestas de texto

Las respuestas de texto se envían a Google Chat como SimpleText. Con este formato, puede poner el texto en negrita o cursiva si lo ajustas con ciertos símbolos (Markdown ligero).

La respuesta de SimpleText tiene el mismo aspecto que la respuesta de texto predeterminada en la consola de Dialogflow. Sin embargo, la respuesta de la API sin procesar se verá un poco diferente. También establece la configuración de la plataforma en GOOGLE_HANGOUTS, que podría ser interesante cuando se compilan los agentes para varias integraciones.

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

Imágenes

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

Tarjetas

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

Carga útil personalizada

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

La carga útil personalizada de Google Chat 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 las tarjetas de formatos de mensajes de Google Chat para ver algunas de las combinaciones que puedes crear. Sin embargo, si usas cargas útiles personalizadas significa que tendrás que proporcionar el formato JSON.

A continuación, se muestra un ejemplo práctico:

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