POST
https://api.getincloud.online/balerion/v3/messagesEnví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/messagesUna 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)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| interactive | object | No | Objeto contenedor que define el payload del mensaje interactivo. Toda la configuración relacionada con el Flow se define dentro de este objeto. |
| externalId | string | No | Identificador alfanumérico utilizado para fines de reporte. |
| callbacks | array of strings | No | Una 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. |
| from | string | Sí | 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 +. |
| to | string | Sí | Número de teléfono de destino del mensaje. Debe especificarse en formato E.164 (incluye + y código de país). |
| type | string | No | Tipo de mensaje. Para el envío de un Flow, este valor debe establecerse como interactive. |
Respuestas
| Código | Significado |
|---|---|
| 202 Accepted | La solicitud fue aceptada correctamente para su procesamiento. El mensaje ha sido encolado para envío. |
| 400 Bad Request | La solicitud contiene errores o parámetros inválidos. |
| 401 Unauthorized | Error de autenticación. Credenciales inválidas o token expirado. |
| 410 Gone | El recurso solicitado ya no está disponible. |
| 500 Internal Server Error | Error 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?