> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Mensajes interactivos

## 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.

Fuente: [guía de Meta sobre mensajes interactivos de WhatsApp](https://developers.facebook.com/docs/whatsapp/guides/interactive-messages/).

## Activar las herramientas

#### Añade la integración de WhatsApp

Importa tu cuenta de WhatsApp Business ([instrucciones](/docs/es/eleven-agents/whatsapp)) y, después, ve a
la [página de integraciones](https://elevenlabs.io/app/agents/integrations), haz clic en el botón **\_Añadir
integración \_**, selecciona WhatsApp y conecta tu cuenta.

#### Añade las herramientas

Ve a la [página de herramientas](https://elevenlabs.io/app/agents/tools), 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***.

> **Warning**
>
> 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.

#### 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ámetro     | Obligatorio | Descripción                                                                     |
| ------------- | ----------- | ------------------------------------------------------------------------------- |
| `body_text`   | Sí          | Mensaje mostrado encima de los botones. Máximo 1024 caracteres.                 |
| `buttons`     | Sí          | De uno a tres botones, en orden de visualización. Los títulos deben ser únicos. |
| `footer_text` | No          | Texto pequeño mostrado debajo de los botones. Máximo 60 caracteres.             |

Cada botón tiene:

| Campo   | Obligatorio | Descripción                                                                             |
| ------- | ----------- | --------------------------------------------------------------------------------------- |
| `id`    | Sí          | Identificador que se devuelve cuando el usuario toca este botón. Máximo 256 caracteres. |
| `title` | Sí          | 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ámetro     | Obligatorio | Descripción                                                                                      |
| ------------- | ----------- | ------------------------------------------------------------------------------------------------ |
| `body_text`   | Sí          | Mensaje mostrado encima de la lista. Máximo 4096 caracteres.                                     |
| `button_text` | Sí          | Etiqueta del botón que abre la lista. Máximo 20 caracteres.                                      |
| `sections`    | Sí          | De 1 a 10 grupos de opciones. Una lista puede contener hasta 10 filas entre todas las secciones. |
| `header_text` | No          | Encabezado mostrado encima del cuerpo del mensaje. Máximo 60 caracteres.                         |
| `footer_text` | No          | Texto pequeño mostrado debajo de la lista. Máximo 60 caracteres.                                 |

Cada sección tiene:

| Campo   | Obligatorio | Descripción                                  |
| ------- | ----------- | -------------------------------------------- |
| `title` | Sí          | Encabezado de sección. Máximo 24 caracteres. |
| `rows`  | Sí          | De una a 10 opciones en esta sección.        |

Cada fila tiene:

| Campo         | Obligatorio | Descripción                                                                             |
| ------------- | ----------- | --------------------------------------------------------------------------------------- |
| `id`          | Sí          | Identificador que se devuelve cuando el usuario elige esta fila. Máximo 200 caracteres. |
| `title`       | Sí          | Etiqueta de la fila. Máximo 24 caracteres.                                              |
| `description` | No          | Texto 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:

```text
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](/docs/es/eleven-agents/customization/procedures) le indica cómo utilizarlas bien.

> **Note**
>
> 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.

#### Copia el procedimiento de ejemplo

```markdown
---
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](/docs/es/eleven-agents/whatsapp/outbound) para iniciar conversaciones.