Skip to main content
POST
Disponible solo en WhatsApp

Parámetros de ruta

string
requerido
Identificador único del bot que envía el mensaje.

Parámetros del cuerpo

string
requerido
Tipo de mensaje. Debe ser "CAROUSEL".
string
requerido
Destinatario del mensaje. Acepta un número de teléfono en formato E.164 sin el signo + (ej: 593999999999) o un BSUID (ej: US.13491208655302741918) para usuarios con protección de número activada en WhatsApp. Consulta Identificación del destinatario.
string
requerido
Texto que se muestra encima del carrusel.
object
requerido
Contenido del carrusel.

Respuesta

boolean
true si el mensaje se envió correctamente.
string
Identificador del mensaje enviado.

Estructura de cada tarjeta

Tarjeta con botones de respuesta rápida

No incluyas el campo type a nivel de la tarjeta cuando uses botones quick_reply. Solo se incluye cuando la acción es cta_url. Si lo agregas en tarjetas con quick_reply, Meta rechaza el mensaje con error 400/500.

Campos del botón quick_reply

Restricciones

  • Tarjetas: mínimo 1, máximo 10 por carrusel.
  • Header: solo image o video.
  • Providers compatibles: WhatsApp Cloud API y Gupshup CAPI.
Este es un carrusel interactivo enviado dentro de una sesión activa de WhatsApp. No requiere plantilla HSM aprobada por Meta.

Casos de Uso

  • Catálogos de productos con CTA a la tienda
  • Comparación de planes o servicios
  • Promociones múltiples con botones de compra
  • Selección rápida entre opciones con imagen