POST
https://api.getincloud.online/balerion/v3/messagesEnviar mensaje multimedia (sesión)
Envía imágenes, audio, video o documentos como mensaje de sesión dentro de la ventana 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.
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 multimedia incluyen contenido como imágenes, archivos de audio, videos y documentos.
POST https://api.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 tipo text, es el contenido del mensaje (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 image. |
| caption | string | No | Aplica únicamente para el tipo image. Texto descriptivo de la imagen. |
| fileName | string | No | Aplica únicamente para el tipo document. Nombre del archivo incluyendo su extensión (.pdf). |
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?