https://api.getincloud.online/balerion/v3/messagesEnvío de Flow mediante plantilla de mensaje
Entrega un Flow estático incluido en una plantilla de WhatsApp para iniciar conversaciones salientes sin ventana activa.
POST https://api.getincloud.online/balerion/v3/messagesCuando una plantilla de mensaje de WhatsApp incluye un Flow estático, este se convierte en parte integral de la definición de la plantilla. Se entrega automáticamente cada vez que dicha plantilla es enviada a un usuario final.
Este método está diseñado para escenarios de comunicación saliente, donde la empresa inicia la interacción sin depender de una ventana de conversación activa con el cliente.
Desde la perspectiva de envío, la plantilla actúa como punto de entrada, mientras que el Flow representa la experiencia interactiva que el usuario inicia al seleccionar el botón de llamada a la acción (CTA). Una vez que el usuario selecciona el CTA, WhatsApp renderiza el Flow asociado directamente dentro del chat.
Parámetros del cuerpo (Whatsapp Message Request)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| placeholders | object | No | Objeto que contiene los valores personalizados asignados a cada variable definida en el encabezado, cuerpo del mensaje o ambos. |
| templateName | string | No | Nombre de la plantilla de mensaje creada y aprobada en tu cuenta de WhatsApp Business. |
| templateLanguage | string | No | Idioma de la plantilla definido al momento de su creación. Actualmente la API soporta 3 idiomas: inglés, español y portugués. Es obligatorio si deseas enviar plantillas en un idioma diferente al inglés. |
| 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 de plantilla. Debe especificarse en formato E.164 (incluye + y código de país). |
Valores de `templateLanguage`
| Idioma | Valor |
|---|---|
| Inglés | en |
| Español | es |
| Portugués | pt_BR, pt_PT |
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. |