API de Mensajería
POSThttps://api.getincloud.online/balerion/v3/messages

Envío de flujo estático

Entrega un Flujo Estático de WhatsApp ya publicado a un usuario dentro de una ventana de conversación activa de 24 horas.

API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
POST https://api.getincloud.online/balerion/v3/messages

Una vez que un Flujo Estático de WhatsApp ha sido publicado, puede ser entregado a los usuarios finales a través de este endpoint. Este método de entrega está diseñado para escenarios donde la interacción ocurre dentro de una ventana activa de conversación de 24 horas iniciada por el usuario, siguiendo las mismas reglas de los mensajes de sesión de WhatsApp, por lo tanto no requiere una plantilla preaprobada.

Parámetros del cuerpo (Whatsapp Message Request)

CampoTipoObligatorioDescripción
interactiveobjectNoObjeto contenedor que define el payload del mensaje interactivo. Toda la configuración relacionada con el Flow se define dentro de este objeto.
externalIdstringNoIdentificador alfanumérico utilizado para fines de reporte.
callbacksarray of stringsNoUna o más URLs de webhook (separadas por coma) para notificar el estado de entrega del mensaje. Si deseas recibir el estado del mensaje enviado a tus usuarios, debes especificar tu endpoint. El endpoint debe aceptar método HTTP POST y recibir un cuerpo en formato JSON. La URL es el callback externo donde se registrarán y publicarán los eventos del mensaje. Una vez procesado el mensaje, su estado será enviado a la URL configurada. Para ver la lista completa de estados y su significado, consulta la sección de WhatsApp Status.
fromstringSíNúmero de teléfono del remitente. El número proporcionado durante la configuración de la cuenta WABA se utilizará como remitente del mensaje de notificación. Solo acepta caracteres numéricos. No incluir el signo +.
tostringSíNúmero de teléfono de destino del mensaje. Debe especificarse en formato E.164 (incluye + y código de país).
typestringNoTipo de mensaje. Para el envío de un Flow, este valor debe establecerse como interactive.

Respuestas

CódigoSignificado
202 AcceptedLa solicitud fue aceptada correctamente para su procesamiento. El mensaje ha sido encolado para envío.
400 Bad RequestLa solicitud contiene errores o parámetros inválidos.
401 UnauthorizedError de autenticación. Credenciales inválidas o token expirado.
410 GoneEl recurso solicitado ya no está disponible.
500 Internal Server ErrorError interno del servidor al procesar la solicitud.
AnteriorEnvío de campaña SMS masivo (batch)SiguienteEnvío de mensaje con botones de respuesta (Reply Button)
¿Te sirvió esta página?