Maytapi/Documentación//interactive
/interactiveSin aprobación de plantillasAPI de mensajes interactivos de WhatsApp
Envía botones de respuesta, botones de enlace y de llamada, menús de lista y carruseles de productos desde tu propio número de WhatsApp. Un único endpoint sendMessage y sin aprobación de plantillas: la elección del cliente vuelve a tu webhook.
- botones de respuesta
- botones de enlace y llamada
- mensajes de lista
- carruseles

Todos los formatos interactivos en un endpoint
Elige el campo type y el tipo de botón; el resto de la petición no cambia.
-
buttons · id
Botones de respuesta
Respuestas rápidas como Confirmar o Cancelar. El id del botón vuelve a tu código para saber qué se eligió.
-
buttons · url
Botones de enlace
Abre una página de seguimiento, un enlace de pago o tu web con un toque.
-
buttons · phoneNumber
Botones de llamada
El cliente llama a tu línea de soporte directamente desde el mensaje.
-
buttons · code
Botones de copiar código
Comparte un cupón o un código de verificación que el cliente copia con un toque.
-
type: list
Mensajes de lista
Un botón de menú que abre secciones y filas: ideal para menús de soporte y horarios de citas.
-
type: carousel
Carruseles
Hasta 10 tarjetas deslizables, cada una con multimedia y hasta 5 botones, para productos y ofertas.
Botones con multimedia, título y pie
Añade una imagen o un vídeo, un título, el cuerpo y un pie, y combina botones de respuesta, enlace, llamada y copiar código en el mismo mensaje.
- ✓Los botones de respuesta devuelven su id a tu webhook
- ✓Los botones de enlace y llamada no requieren configuración extra
- ✓Botones de copiar código para cupones y códigos de un solo uso
Menús de lista para muchas opciones
Cuando tres botones no bastan, envía una lista. El cliente la abre con el texto de tu botón y elige una fila de tus secciones.
- ✓Agrupa filas en secciones con título
- ✓Cada fila tiene título, descripción y rowId
- ✓Ideal para menús de soporte, sucursales y horarios
Tarjetas de producto deslizables
Muestra varios productos u ofertas uno al lado del otro. Cada tarjeta tiene su propia imagen, texto y botones.
- ✓Hasta 10 tarjetas por carrusel
- ✓Hasta 5 botones por tarjeta
- ✓La multimedia es obligatoria en cada tarjeta
Mismo endpoint, distinto type
Botones, listas y carruseles se envían con POST /sendMessage. Solo cambian el campo type y sus opciones.
- ✓Funciona con cURL, Node.js, Python, PHP y cualquier cliente HTTP
- ✓Sin revisión de plantillas: envía al momento
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "buttons",
"title": "Your order #10482",
"message": "Your order is ready to ship. Please confirm the delivery address.",
"footer": "Maytapi Store",
"media": "https://example.com/order.jpg",
"buttons": [
{
"id": "confirm",
"text": "Confirm"
},
{
"url": "https://example.com/track/10482",
"text": "Track order"
},
{
"phoneNumber": "3461xxxxx67",
"text": "Call us"
}
]
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "buttons",
"message": "Here is 10% off your next order.",
"buttons": [
{
"code": "WELCOME10",
"text": "Copy code"
}
]
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "list",
"title": "How can we help?",
"message": "Choose a topic and we will connect you to the right team.",
"footer": "Support",
"button_text": "See options",
"sections": [
{
"title": "Support topics",
"rows": [
{
"rowId": "status",
"title": "Order status",
"description": "Track a recent order"
},
{
"rowId": "returns",
"title": "Returns",
"description": "Start a return or exchange"
}
]
}
]
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "carousel",
"message": "New arrivals this week",
"cards": [
{
"title": "Classic sneaker",
"body": "Sizes 38–45",
"media": "https://example.com/sneaker.jpg",
"buttons": [
{
"id": "add_sneaker",
"text": "Add to cart"
},
{
"url": "https://example.com/sneaker",
"text": "Details"
}
]
},
{
"title": "Canvas backpack",
"body": "Free shipping",
"media": "https://example.com/backpack.jpg",
"buttons": [
{
"id": "add_backpack",
"text": "Add to cart"
},
{
"url": "https://example.com/backpack",
"text": "Details"
}
]
}
]
}'Dónde funcionan mejor los mensajes interactivos
-
Confirmación de pedidos
Confirma, cambia o cancela un pedido con un toque en lugar de una respuesta escrita.
-
Recordatorios de citas
Envía un recordatorio con botones Confirmar y Reprogramar y actualiza tu agenda desde el webhook.
-
Menús de soporte
Dirige al cliente al equipo adecuado con un mensaje de lista antes de que entre un agente.
-
Escaparate de productos
Presenta novedades en un carrusel con botones de añadir al carrito y detalles.
-
Cupones y códigos
Entrega códigos de descuento o verificación con un botón de copiar código.
-
Flujos de chatbot
Guía las conversaciones del bot con botones para que las respuestas sean estructuradas.
Preguntas frecuentes sobre mensajes interactivos
Pregunta lo que quieras a nuestro equipo de soporte por WhatsApp. El tiempo medio de respuesta es inferior a 24 horas.
Centro de ayuda →¿Necesito aprobación de plantillas para enviar botones?
No. Maytapi envía los mensajes interactivos desde tu propio número a través de WhatsApp Web, así que no hay revisión de plantillas de Meta. Puedes enviarlos de inmediato.
¿Qué tipos de botón se admiten?
Botones de respuesta con id, de enlace con url, de llamada con phoneNumber y de copiar código con code. El título, el pie y la multimedia son opcionales.
¿Cuántas tarjetas puede tener un carrusel?
Hasta 10 tarjetas por carrusel. Cada tarjeta necesita multimedia y admite hasta 5 botones.
¿Cómo sé qué botón pulsó el cliente?
La elección del cliente llega a tu webhook como cualquier mensaje entrante, así tu código puede reaccionar al momento.
¿Puedo añadir una imagen a un mensaje con botones?
Sí. Añade una URL en media y la imagen o el vídeo se mostrará sobre el cuerpo del mensaje.

Consigue tu clave y envía tu primer mensaje en diez minutos
Sin aprobación, sin plantillas, sin tarjeta. Todos los endpoints abiertos durante tres días.