Saltar al contenido principal
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.
Este punto final experimental utiliza un protocolo WhatsApp no oficial. El renderizado del destinatario varía según el cliente y puede cambiar sin previo aviso. Prueba en tus clientes objetivo antes de usar. Una respuesta API exitosa confirma la aceptación de envío, no entrega o renderizado.
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

Enviar este JSON a /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

Reemplace los marcadores de posición de la imagen por base64 estándar sin un prefijo de URL de datos. Las imágenes son opcionales en tarjetas individuales. GOWA redimensiona las imágenes suministradas para ajustarlas a 1280 píxeles, las convierte en JPEG, crea miniaturas y las carga a WhatsApp. Las URL de imágenes remotas no son aceptadas.

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 con results.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.