Mensajes de respuesta enriquecida

Muchas de las plataformas de integración admiten mensajes de respuesta enriquecida específicos de las plataformas. Estos mensajes se pueden usar para proporcionar al usuario final más que solo respuestas de texto. Existe una variedad de tipos de respuestas para elegir. Por ejemplo, puedes mostrar imágenes, reproducir audio o proporcionar botones. Cada plataforma admite un subconjunto de los tipos de respuesta disponibles.

Dónde encontrar estos datos

Cuando compilas un agente, es más común usar la consola de Dialogflow ES (consulta la documentación, abre consola). En las instrucciones que se detallan a continuación, nos enfocaremos en el uso de la consola. Para acceder a los datos de respuesta del intent, sigue estos pasos:

  1. Ve a la consola de Dialogflow ES.
  2. Selecciona un agente.
  3. En el menú de la barra lateral izquierda, selecciona Intents.
  4. Selecciona un intent.
  5. Desplázate hacia abajo hasta la sección Respuestas.

Si compilas un agente con la API en lugar de la consola, consulta la referencia de los intents. Los nombres de los campos de la API son similares a los de la consola. En las instrucciones que se detallan continuación, se resaltan las diferencias importantes entre la consola y la API.

Agrega mensajes de respuesta enriquecida

La sección Responses (Respuestas) tiene pestañas para cada plataforma, entre las que se incluye una default (predeterminada). Puedes definir respuestas para la plataforma predeterminada, que se pueden usar en todas las plataformas.

Captura de pantalla de la adición de mensajes enriquecidos

Puedes definir respuestas para las pestañas específicas de las plataformas, que solo funcionan en las plataformas correspondientes. También puedes usar las respuestas predeterminadas de una plataforma específica, para que no tengas que crear respuestas de texto duplicadas en todas las plataformas.

Captura de pantalla de la adición de mensajes enriquecidos

Sigue estos pasos para agregar mensajes de respuesta enriquecida:

  1. Selecciona la pestaña de la plataforma que deseas. Si no se muestra la pestaña de la plataforma deseada, haz clic en el botón agregar  y selecciónala.
  2. Haz clic en el botón Add Responses (Agregar respuestas). Aparecerá un menú desplegable en el que se muestran los tipos de respuestas que admite la plataforma.
  3. Elige el tipo de respuesta. Estos se describen a continuación.
  4. Ingresa los campos para el tipo de respuesta seleccionado.
  5. Agrega más respuestas y pestañas de plataforma, según sea necesario. Puedes agregar hasta 10 mensajes ordenados en cada pestaña.
  6. Haz clic en Guardar.

Puedes usar las referencias de parámetros en las respuestas para hacer referencia a los parámetros proporcionados por el usuario final o los eventos del entorno de ejecución.

Respuestas de texto

De forma predeterminada, las respuestas de texto le envían una respuesta en forma de texto al usuario final.

Si el texto a voz está habilitado para un agente o lo piden las solicitudes de intents de detección, el texto proporcionado se usa a fin de sintetizar la voz y reproducir el audio. En este caso, en el texto proporcionado, se puede usar el lenguaje de marcación de síntesis de voz (SSML) de forma opcional.

Los campos son los siguientes:

  • Lista de texto o entradas SSML

Cuando ingreses una respuesta, presiona Mayúsculas + Intro para ingresar una línea nueva o solo Intro para ingresar otra respuesta de texto.

Se aplica la siguiente limitación:

  • Máximo de 300 entradas de texto por respuesta de texto

Respuestas de imagen

Las respuestas de imagen envían una imagen al usuario final. Tienen los siguientes campos:

  • URL de acceso público de la imagen

Respuestas con tarjeta

Las respuestas con tarjeta le envían al usuario final una imagen, un título y un subtítulo de tarjeta, y botones interactivos. El estilo de la tarjeta varía según la plataforma.

Puedes configurar botones a fin de dirigir al usuario final a una URL o para enviar texto preconfigurado a Dialogflow, como si el usuario final proporcionase una expresión.

Algunos de los siguientes campos son opcionales, según la plataforma:

  • URL de acceso público para una imagen
  • Título de la tarjeta
  • Subtítulo de la tarjeta
  • Lista de botones con los siguientes campos:
    • Título del botón
    • Texto para enviar como expresión del usuario final o URL para abrir

Se aplican las siguientes limitaciones:

  • Un máximo de 10 tarjetas por plataforma y por idioma para un intent. Por ejemplo, si tu agente admite inglés, francés, la plataforma X y la plataforma Y, un intent puede tener 40 tarjetas como máximo:

    • 10 tarjetas en inglés para la plataforma X
    • 10 tarjetas en inglés para la plataforma Y
    • 10 tarjetas en francés para la plataforma X
    • 10 tarjetas en francés para la plataforma Y

Respuestas rápidas

Las respuestas rápidas le envían un botón al usuario final. Puedes configurar botones para enviar texto preconfigurado a Dialogflow, como si el usuario final proporcionase una expresión.

Los campos son los siguientes:

  • Título del botón
  • Lista de entradas de texto para enviar como expresiones del usuario final

Se aplican las siguientes limitaciones:

  • Máximo de una respuesta rápida por plataforma y por idioma para un intent. Por ejemplo, si tu agente admite inglés, francés, la plataforma X y la plataforma Y, un intent puede tener como máximo 4 respuestas rápidas:

    • 1 respuesta rápida en inglés para la plataforma X
    • 1 respuesta rápida en inglés para la plataforma Y
    • 1 respuesta rápida en francés para la plataforma X
    • 1 respuesta rápida en francés para la plataforma Y
  • Máximo de 10 entradas de texto por respuesta rápida

  • Máximo de 20 caracteres por entrada de texto

Respuestas de sintetizado de voz

Las respuestas Sintetizar la voz se usan para sintetizar la voz a partir de respuestas de texto y reproducir el audio. El texto proporcionado puede usar el lenguaje de marcación de sintetizado de voz (SSML) de forma opcional.

Los campos son los siguientes:

  • Texto o SSML

Se aplica la siguiente limitación:

Respuestas de reproducción de audio

Las respuestas de reproducción de voz se usan para reproducir archivos de audio. Los archivos de audio se proporcionan en un bucket de Cloud Storage.

El campo es el siguiente:

  • URI del objeto de Cloud Storage en formato gs://bucket-name/object-name

Se aplica la siguiente limitación:

  • Solo es compatible con la integración de Dialogflow Phone Gateway
  • Especificaciones del archivo de audio: un solo canal (mono) del audio PCM lineal (2 bytes por muestra) a 8 kHz
  • Máximo de 20 respuestas de reproducción de audio por intent

Respuestas de transferencia de llamadas

Las respuestas de transferencia de llamadas se usan a fin de transferir al emisor para generar una integración telefónica.

El campo es el siguiente:

  • El número de teléfono al que se realizará la transferencia

Se aplica la siguiente limitación:

Respuestas con carga útil personalizada

Algunas plataformas admiten una respuesta de carga útil personalizada para manejar respuestas avanzadas que no son estándar. Estas cargas útiles personalizadas se suministran en un formato JSON definido en la documentación de la plataforma.

También puedes enviar una carga útil personalizada a las integraciones que desarrollas. Dialogflow no se encargará del procesamiento, por lo que tendrás que manejarlo con tu propia lógica empresarial.

Puedes configurar una carga útil personalizada para varias plataformas. Para configurar esto, usa la plataforma predeterminada y un formato JSON similar al siguiente:

{
  "facebook": {
    "attachment": {
      "type": "",
      "payload": {}
    }
  },
  "slack": {
    "text": "",
    "attachments": []
  }
}

Tipos de respuesta del Asistente de Google

La integración del Asistente de Google proporciona muchos tipos de mensajes de respuesta. Para obtener más información, consulta la referencia sobre las respuestas del Asistente de Google.

Tipos de respuesta adicionales

Hay otros tipos de mensajes compatibles con varias plataformas. Puedes ver la lista completa en la documentación de referencia de REST sobre los mensajes de respuesta. Consulta la documentación sobre la integración de la plataforma para obtener más información.