Hangouts Chat

La integración de Hangouts de Dialogflow 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.

Configuración

Para configurar y habilitar la integración de Hangouts 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 Iniciar.

Configura tu bot

Una vez que tu bot de Hangouts Chat haya sido creado, puedes cambiar los detalles si haces clic en el botón CONFIGURAR LOS DETALLES DEL BOT en la ventana emergente de integración. Esto te llevará a la página de Google Cloud Platform Console para la API de Hangouts Chat.

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

Habilita y configura con Google Cloud Platform Console

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

  1. En Google Cloud Platform Console, haz clic en el ícono de menú () de 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 “Hangouts Chat”.
  5. Haz clic en el mosaico de la API de Hangouts Chat.
  6. Haz 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 Hangouts Chat para configurar y publicar tu bot.

Realiza una 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. Ve a Hangouts 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 a tu administrador de G Suite 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 Hangouts Chat.

Respuestas de texto

Las respuestas de texto se envían a Hangouts 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 Hangouts como widgets de imágenes de Hangouts.

Tarjetas

Las respuestas de la tarjeta se envían a Hangouts como tarjetas de Hangouts.

Carga útil personalizada

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

La Carga útil personalizada de Hangouts 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 Hangouts 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/..."
              }
            }
          }
        }]
      }]
    }]
  }
}