Integración de Google Chat en Dialogflow

La integración de Hangouts de Google Chat te permite crear bots que puedes incluir en chats individuales y salas de chat. Para obtener más información, consulta la documentación de la API de Hangouts Chat.

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 bot

Puedes cambiar los detalles una vez que se haya creado el bot de Google Chat. Para ello, haz clic en el botón CONFIGURAR LOS DETALLES DEL BOT en la ventana de integración emergente. Esto te llevará a la página de Google Cloud Console para la API de Google Chat.

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

Configura tu avatar de bot

Hay dos alternativas para configurar tu avatar de bot:

  • 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 Cloud Console

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

  1. En 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 en la guía de publicación de bots de la API de Google Chat para configurar y publicar tu bot.

Prueba

Antes de probar el bot, asegúrate de haberlo iniciado (consulta la sección Configuración).

Para probar tu bot, sigue estos pasos:

  1. Ir a Google Chat
  2. Haz clic en el campo Buscar.
  3. Selecciona Buscar un bot.
  4. Selecciona el nombre del bot.
  5. Haz clic en Mensaje.

Soluciona problemas

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

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 Bot Customer Support",
      "subtitle": "pizzabot@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/..."
              }
            }
          }
        }]
      }]
    }]
  }
}