POST /send/interactive envía mensajes de flujo nativo de WhatsApp a través del dispositivo seleccionado. Use Basic Auth, X-Device-Id, y un cuerpo JSON. Este endpoint soporta envíos REST inmediatos. Los envíos programados y MCP no lo exponen.
Establezca la URL del servidor y las credenciales antes de ejecutar los ejemplos de curl. Utilice la URL pública HTTPS para un servidor remoto e incluya APP_BASE_PATH cuando esté configurado.
Botones de envío
phone acepta un número de teléfono o un usuario o grupo JID. Los envíos de grupos requieren membresía y permiso de publicación. El boletín de noticias y los destinatarios de difusión no son compatibles.
Proporciona buttons o cards en el nivel superior. Si proporcionas ambos o ninguno, la validación falla.
Para una lista de selección, utilice estos parámetros:
Solicitar una ubicación
/send/interactive. El destinatario debe elegir compartir una ubicación. El punto final no recupera una ubicación sin su acción.
Enviar un carrusel de imagen
Límites de solicitud
El límite total de peticiones HTTP del servidor también se aplica. Utilice imágenes pequeñas al enviar varias tarjetas. Las opciones o tamaños no válidos devuelven un error de validación antes de enviar.
Manejar respuestas y recibos
Envío exitoso devuelve el sobre de éxito normal conresults.message_id y un estado que dice que el renderizado del destinatario no está verificado. Usa webhooks entrantes para respuestas y eventos message.ack para recibos. Reintentarlo después de un tiempo de espera ambiguo puede duplicar mensajes.
Las pruebas de Android descendentes reportaron respuestas de trabajo, URL, copia, llamada, selección, ubicación y acciones de carrusel. Estos informes no establecen compatibilidad entre cuentas, iOS o WhatsApp Web. Las tarjetas de carrusel individuales pueden mostrar iconos pendientes incluso cuando el mensaje padre tiene marcas de verificación y el destinatario puede responder. Este problema sigue sin resolverse.
El punto final no registra plantillas oficiales ni ayuda a Flows, catálogos o pagos nativos.