Saltar al contenido
Documentación

Respuestas enriquecidas: tablas, tarjetas y respuestas rápidas en el chat

Deja que el agente responda con una tabla para comparar opciones, una fila de tarjetas entre las que elegir o botones de respuesta rápida para el siguiente paso, junto a su texto. Descubre cuándo los usa, los límites, cómo se ven en el widget y dónde más aparecen.

Con Rich replies activado, el agente puede mostrar contenido estructurado dentro del chat, debajo de su texto:

  • una tabla, para comparar varias cosas en los mismos puntos, como planes, productos u horarios de apertura;
  • tarjetas, una fila de opciones entre las que elegir, cada una con un título y, opcionalmente, una imagen, un precio y botones;
  • respuestas rápidas, botones cortos para siguientes pasos claros. Al pulsar uno, su texto se envía como mensaje del visitante.

El agente siempre escribe también una respuesta de texto. Las respuestas enriquecidas van debajo, como las tarjetas de producto y los horarios de reserva.

Activarlas o desactivarlas

Abre tu agente, selecciona la pestaña Appearance y busca el interruptor Rich replies, junto a Suggest follow-up questions y Show sources under replies. Está activado por defecto en todos los agentes. Haz clic en Save changes para aplicar un cambio.

El Playground usa el interruptor tal como está en pantalla, así que puedes probarlo antes de guardar.

Desactivarlo detiene las respuestas enriquecidas nuevas. Las respuestas que ya mostraron una la conservan en la conversación.

Cuándo las usa el agente

El agente decide en cada respuesta. Tiene indicado usar respuestas enriquecidas solo cuando ayudan:

SituaciónQué muestra
Una comparación de varios elementos en los mismos puntosUna tabla
Varias opciones entre las que el visitante puede elegirTarjetas
Siguientes pasos claros entre los que el visitante elegiríaRespuestas rápidas

Tiene indicado no usarlas para un solo dato, un sí o un no, una charla informal o una respuesta de un párrafo corto, y rellenarlas solo con datos de tu conocimiento, de la conversación o de los resultados de tus acciones, nunca con productos, precios, enlaces o imágenes inventados. Como con cualquier respuesta de IA, revisa las respuestas importantes en el Playground y usa tus instrucciones para guiarlo, por ejemplo «Muestra nuestros planes en una tabla cuando alguien pregunte por los precios».

Una respuesta enriquecida forma parte de la misma respuesta, así que no consume un mensaje extra, y activar el interruptor no cambia cómo se transmite la respuesta. La respuesta enriquecida aparece cuando el texto está completo. Un visitante que pulsa una respuesta rápida o el botón de respuesta de una tarjeta envía un mensaje, que cuenta como uno escrito.

Límites y reglas de seguridad

Una respuesta muestra como mucho una tabla, una fila de tarjetas y un grupo de respuestas rápidas.

TipoLímites
TablaDe 1 a 8 columnas y de 1 a 20 filas. Cada celda es texto sin formato de hasta 200 caracteres, los encabezados de columna de hasta 60 y un título opcional de hasta 100. Cada fila tiene una celda por columna.
TarjetasDe 1 a 10 tarjetas. Cada una tiene un título de hasta 80 caracteres y, opcionalmente, un subtítulo de hasta 200, una imagen, un precio escrito como texto de hasta 40 (como "CHF 49" o "from $9/month") y hasta 2 botones. Un botón abre un enlace o envía una respuesta de hasta 120 caracteres como mensaje del visitante. Las etiquetas de los botones tienen hasta 40 caracteres.
Respuestas rápidasDe 1 a 6 botones de hasta 40 caracteres cada uno. Las repeticiones se muestran una sola vez.

intoCHAT comprueba cada respuesta enriquecida antes de mostrarla:

  • Todo es texto sin formato. El HTML se rechaza, y las marcas de Markdown como ** se eliminan.
  • Los enlaces y las imágenes deben ser direcciones https:// completas. Se rechazan los enlaces http://, javascript: y data:, las direcciones con un nombre de usuario o una contraseña y las direcciones sin dominio, como localhost.
  • Las respuestas rápidas y los botones de respuesta no pueden contener un enlace, porque su texto se envía como mensaje del visitante.

Una tabla, una fila de tarjetas o un grupo de respuestas rápidas que incumple una regla no se muestra en absoluto, nunca en parte. La respuesta de texto y cualquier otra respuesta enriquecida válida siguen apareciendo. Cuando tu agente tiene también acciones, formularios de chat u otras herramientas, se le dice qué estaba mal y puede corregirlo en la misma respuesta.

Cómo se ven en el widget

  • Las respuestas enriquecidas aparecen debajo del mensaje del agente, alineadas con él, en el tema claro u oscuro de tu widget. Los botones de enlace y de respuesta de las tarjetas usan el color de tu Launcher bubble.
  • Una tabla se desplaza hacia los lados en una pantalla estrecha. Varias tarjetas forman una fila que se desplaza hacia los lados, con flechas para quien usa el ratón. Una sola tarjeta se muestra a todo lo ancho.
  • Las respuestas rápidas solo aparecen debajo de la última respuesta y desaparecen en cuanto el visitante envía un mensaje. Mientras se muestran respuestas rápidas, las preguntas de seguimiento no aparecen, para que no compitan entre sí.
  • Los enlaces de las tarjetas se abren en una pestaña nueva. Con Keep campaign tags on links activado (consulta Aspecto), llevan tus etiquetas de campaña como los demás enlaces de las respuestas.
  • Todo funciona con el teclado: se llega a los botones y los enlaces con Tab, y la tabla y la fila de tarjetas se pueden enfocar y desplazar con las flechas. Los lectores de pantalla anuncian el título de la tabla, el número de tarjetas y el grupo de respuestas rápidas.

Las etiquetas propias del widget, como «Más», «Anterior», «Respuestas rápidas» y la nota de que un enlace se abre en una pestaña nueva, siguen el idioma del widget. El texto dentro de una respuesta enriquecida lo escribe el agente, en el idioma de su respuesta.

Dónde más aparecen las respuestas enriquecidas

LugarQué ves
Pestaña Conversations y el PlaygroundLa respuesta enriquecida tal como la vio el visitante. En la pestaña Conversations, sus botones no envían nada.
Bandeja de Live chat, correo de traspaso, tickets de helpdesk y la exportación CSVUna versión en texto: una tabla como líneas de celdas separadas por |, las tarjetas como • Title — subtitle — price con sus enlaces, las respuestas rápidas como [Yes] [No].
Conversaciones de Slack y por correoNo se ofrecen: el agente escribe texto sin formato ahí.
API REST y servidor MCPUn campo ui, descrito más abajo.

En la API

Enviar un mensaje (sin streaming) y Obtener una conversación añaden un campo ui a una respuesta del agente que mostró una respuesta enriquecida. Una respuesta sin ella no tiene campo ui. Las herramientas MCP chat_with_agent y get_conversation devuelven lo mismo. content y reply siguen siendo texto sin formato, sin la respuesta enriquecida.

{
  "id": "MESSAGE_ID",
  "role": "assistant",
  "content": "Here are our two plans.",
  "createdAt": "2026-10-27T10:00:00.000Z",
  "authorName": null,
  "sources": [],
  "ui": [
    {
      "type": "table",
      "title": "Plans",
      "columns": ["Plan", "Price", "Seats"],
      "rows": [["Basic", "CHF 9", "1"], ["Pro", "CHF 29", "5"]]
    },
    {
      "type": "cards",
      "cards": [
        {
          "title": "Pro",
          "subtitle": "For growing teams",
          "image": "https://www.example.com/pro.png",
          "price": "CHF 29 / month",
          "buttons": [
            { "label": "See details", "url": "https://www.example.com/pricing" },
            { "label": "Start a trial", "reply": "I'd like to start a Pro trial" }
          ]
        }
      ]
    },
    { "type": "quick_replies", "replies": ["Compare features", "Talk to sales"] }
  ]
}

Cada elemento tiene un type: table (con columns, rows y un title opcional), cards (cada tarjeta con title, subtitle, image y price opcionales, y buttons con un label y un url o un reply) o quick_replies (con replies). Los campos opcionales se omiten cuando están vacíos.

Siguientes pasos

Ver como Markdown