Mensajes interactivos

Permite que tu agente ofrezca botones y listas que se pueden tocar en conversaciones de WhatsApp

Descripción general

En lugar de pedir al usuario que escriba una respuesta, tu agente puede enviar mensajes interactivos de WhatsApp: hasta tres botones de respuesta que se pueden tocar o una lista de hasta diez opciones. La selección del usuario vuelve como su siguiente mensaje, y el agente ve exactamente qué opción ha elegido.

Los mensajes interactivos solo funcionan en conversaciones de mensajes de WhatsApp activas. El agente los envía mediante dos herramientas de integración:

  • Enviar botones interactivos: hasta tres botones de respuesta, para conjuntos pequeños de opciones.
  • Enviar lista interactiva: una lista de opciones que se pueden tocar agrupadas en secciones, para más de tres opciones.
Un usuario compra saldo mediante un menú de lista y botones de respuesta.

Fuente: guía de Meta sobre mensajes interactivos de WhatsApp.

Activar las herramientas

1

Añade la integración de WhatsApp

Importa tu cuenta de WhatsApp Business (instrucciones) y, después, ve a la página de integraciones, haz clic en el botón _Añadir integración _, selecciona WhatsApp y conecta tu cuenta.

2

Añade las herramientas

Ve a la página de herramientas, haz clic en el botón _Añadir herramienta de integración _, selecciona la integración de WhatsApp y añade las herramientas _ Enviar botones interactivos _ y Enviar lista interactiva.

Si has importado más de una cuenta de WhatsApp, cada una tiene su propia integración de WhatsApp. Asegúrate de añadir las herramientas desde la integración conectada a la cuenta que usa tu agente: las herramientas añadidas desde la integración de otra cuenta no funcionarán en las conversaciones de este agente.

3

Vincula las herramientas a tu agente

Añade las herramientas a la configuración de tu agente. Las herramientas siempre envían mensajes al usuario de la conversación activa: el agente elige el contenido, nunca el destinatario.

Enviar botones interactivos

Enviar botones interactivos presenta de una a tres opciones en la conversación actual de mensajes de WhatsApp.

ParámetroObligatorioDescripción
body_textSíMensaje mostrado encima de los botones. Máximo 1024 caracteres.
buttonsSíDe uno a tres botones, en orden de visualización. Los títulos deben ser únicos.
footer_textNoTexto pequeño mostrado debajo de los botones. Máximo 60 caracteres.

Cada botón tiene:

CampoObligatorioDescripción
idSíIdentificador que se devuelve cuando el usuario toca este botón. Máximo 256 caracteres.
titleSíEtiqueta del botón. Máximo 20 caracteres.

Enviar una lista interactiva

Enviar lista interactiva presenta opciones agrupadas en secciones en la conversación actual de mensajes de WhatsApp. El usuario abre la lista y selecciona una fila.

ParámetroObligatorioDescripción
body_textSíMensaje mostrado encima de la lista. Máximo 4096 caracteres.
button_textSíEtiqueta del botón que abre la lista. Máximo 20 caracteres.
sectionsSíDe 1 a 10 grupos de opciones. Una lista puede contener hasta 10 filas entre todas las secciones.
header_textNoEncabezado mostrado encima del cuerpo del mensaje. Máximo 60 caracteres.
footer_textNoTexto pequeño mostrado debajo de la lista. Máximo 60 caracteres.

Cada sección tiene:

CampoObligatorioDescripción
titleSíEncabezado de sección. Máximo 24 caracteres.
rowsSíDe una a 10 opciones en esta sección.

Cada fila tiene:

CampoObligatorioDescripción
idSíIdentificador que se devuelve cuando el usuario elige esta fila. Máximo 200 caracteres.
titleSíEtiqueta de la fila. Máximo 24 caracteres.
descriptionNoTexto secundario mostrado debajo de la etiqueta de la fila. Máximo 72 caracteres.

Si el agente genera contenido que supera un límite, la llamada a la herramienta falla y se le indica el motivo para que pueda volver a intentarlo con contenido más breve.

Indicaciones para el agente

Indica al agente en el prompt del sistema cuándo debe ofrecer opciones. Por ejemplo:

When you need the user to pick from a fixed set of options (appointment slots,
product variants, yes/no confirmations), use the Send Interactive Buttons tool
for up to 3 options or the Send Interactive List tool for more. Keep option
titles short. Do not use interactive messages for open-ended questions.

Opcional: añade un procedimiento para orientar el uso de herramientas del agente

Dar las herramientas al agente es solo la mitad del trabajo: un procedimiento le indica cómo utilizarlas bien.

El procedimiento siguiente es una plantilla, no algo listo para usar sin cambios. Después de copiarlo, adáptalo a tus necesidades: ajusta el desencadenante a tus flujos, conserva solo las herramientas que realmente tiene tu agente y reescribe los ejemplos y las reglas de opciones para que se ajusten a tu caso de uso.

---
name: Offer choices with interactive messages
trigger: The user must pick from a fixed set of known options in a WhatsApp message conversation, such as appointment slots, product variants, or order confirmations.
---
Offer the options as an interactive message instead of asking the user
to type an answer.
1. Check which interactive tools you have. Prefer Send Interactive
Buttons for 2–3 options and Send Interactive List for 4–10. If only
one of the two is available, use it for any option count that fits its
limits; if no interactive tool fits, ask the question in plain text.
Never present more than 10 options; narrow them down with a question
first.
2. Write a body_text that asks one clear question. Do not stack multiple
questions into one interactive message.
3. Give every option a stable, machine-readable id (for example
slot_2026-08-20_10am) and a short human title — 20 characters for
buttons, 24 for list rows.
4. For lists, group related rows into titled sections, and add a
description to a row only when its title alone is ambiguous.
5. Send the message with the tool, then wait for the user's reply. Do not
send a second interactive message before the user responds to the first.
6. Treat the reply as the user's choice. Confirm it back in one short line
and continue the flow.
Rules:
- Never use interactive messages for open-ended questions.
- When the fixed options may not cover everyone, include a final option
such as "Something else" and follow up with a free-text question.
- If the tool call fails because content exceeds a limit, shorten titles
and descriptions and retry once.
- If the user types an answer instead of tapping, accept it — do not
re-send the options.

Restricciones

  • Los mensajes interactivos solo se pueden enviar en conversaciones de mensajes; no durante llamadas de voz de WhatsApp ni en otros canales.
  • WhatsApp Flows (formularios interactivos) no es compatible. Si un usuario responde con una respuesta de Flow, no se transmite al agente.
  • Los mensajes interactivos son mensajes de sesión: solo se pueden enviar dentro de una conversación activa, no como primer contacto saliente. Usa plantillas de mensaje para iniciar conversaciones.