Nuevo Safe Mode calienta los números nuevos para reducir el riesgo de bloqueo en WhatsApp. Más información →

Maytapi/Documentación//interactive

/interactiveSin aprobación de plantillas

API 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
Botones y listas interactivos de WhatsApp
Tipos de mensaje

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

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
Un mensaje de WhatsApp con foto, título, pie y cuatro botones de respuesta enviado con la API de Maytapi
Listas

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
Un mensaje de lista de WhatsApp con el menú de opciones abierto, enviado con la API de Maytapi
Carruseles

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
Un carrusel de WhatsApp con tarjetas de producto deslizables y botones, enviado con la API de Maytapi
Petición

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"
      }
    ]
  }'
Casos de uso

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.

FAQ

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.

Empieza a usar la API de WhatsApp

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.