POST
https://getincloud.online/balerion/v3/messagesEnviar mensaje de texto (sesión)
Envía un mensaje de texto de sesión dentro de la ventana de 24 horas, sin plantilla.
API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
Si un usuario de WhatsApp ha enviado un mensaje a tu aplicación, ya sea como respuesta a una plantilla previamente enviada o iniciando la conversación, tu aplicación dispone de una ventana de 24 horas para enviar mensajes sin necesidad de usar plantillas. Estos se conocen como mensajes de sesión.
Los mensajes de texto contienen únicamente un cuerpo de texto.
POST https://getincloud.online/balerion/v3/messagesParámetros del cuerpo (Whatsapp Message Request)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| externalId | string | No | Identificador alfanumérico utilizado para fines de reporte. |
| callbacks | array de strings | No | URL de webhook para notificar los eventos del mensaje de WhatsApp. |
| 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. Solo acepta caracteres numéricos. No incluir el signo +. |
| to | string | Sí | Número de teléfono de destino. Formato E.164 (incluye + y código de país). |
| body | string | No | Longitud entre 0 y 4096. Aplica únicamente para los tipos text, image, audio, document. Para mensajes de tipo text, es el contenido del mensaje a enviar; el texto tiene un límite de 1024 caracteres. Para mensajes multimedia, es la URL del archivo (imagen, video o documento): debe ser válida, iniciar con http:// o https:// y permitir descarga directa. No se soportan redirecciones. |
| type | string | No | Tipo de mensaje que se desea enviar. En este caso se utiliza el valor text. |
Valores soportados de type
text: envía un mensaje de texto plano.image: envía un archivo de imagen (.jpeg, .png).audio: envía un archivo de audio (.acc, .mp3, .amr, .mpeg).video: envía un archivo de video (.mp4, .3gpp).document: envía un archivo de documento (.pdf).contacts: envía información de contacto.location: envía una ubicación con latitud y longitud.interactive: envía un mensaje interactivo con botones o listas.
Respuestas
| Código | Descripción |
|---|---|
| 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. |
¿Te sirvió esta página?