POST
https://api.getincloud.online/balerion/v3/messagesEnviar plantilla de mensaje de texto
Envía a tus usuarios una plantilla de texto de WhatsApp ya aprobada mediante la API de mensajes.
API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
Una vez que la plantilla de mensaje de texto de WhatsApp ha sido creada mediante la interfaz de usuario o la API y ha sido aprobada, el siguiente paso es enviar la plantilla a los usuarios finales a través de la API de mensajes.
POST https://api.getincloud.online/balerion/v3/messagesParámetros del cuerpo (Whatsapp Message Request)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| placeholders | object | No | Objeto de campos personalizados (marcadores de posición) que contienen el cuerpo del mensaje de texto. Establece como parámetro el marcador que configuraste dentro de llaves dobles {{...}} al crear la plantilla y asigna el valor correspondiente. Los marcadores deben estar correctamente formateados en el mismo orden en que se creó la plantilla. Ejemplo: para un mensaje como "Here is your {{code}}", debes establecer el marcador como code: 34871. |
| templateName | string | No | Nombre de la plantilla creada 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. |
| 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 para el mensaje de plantilla. Los números deben especificarse en formato E.164 (incluye + y código de país). |
| templateId | string | No | Identificador único de la plantilla. |
| callbacks | array de strings | No | Sin descripción adicional en el manual. |
Idiomas soportados
- English:
en - Spanish:
es - Portuguese:
pt_BR,pt_PT
Ejemplo de petición
curl --location 'https://api.getincloud.online/balerion/v3/messages' \
--header 'accept: application/json' \
--header 'authorization: Bearer tutoken \
--header 'content-type: application/json' \
--data
{
"templateName": "test_getincloud20042026",
"templateLanguage": "es",
"from": "573212417473",
"to": "573104258723",
"placeholders": {
"1": "Camilo"
}
}Respuestas
| Código | Descripción |
|---|---|
| 202 Accepted | La solicitud fue aceptada correctamente para su procesamiento. |
| 400 Bad Request | La solicitud contiene errores o parámetros inválidos. |
| 401 Unauthorized | Error de autenticación. |
| 410 Gone | El recurso solicitado ya no está disponible. |
| 500 Internal Server Error | Error interno del servidor. |
¿Te sirvió esta página?