post https://rest.inalambria.com/mtmessage/massive
El envío de mensajes Batch permite el envío de múltiples mensajes a diferentes destinatarios en un solo consumo de API. Este enfoque es ideal para comunicaciones masivas donde no se espera una respuesta inmediata del destinatario.
{
"messages": [
{
"destinations": [
{
"to": "XXXXXXXXXXXX"
},
{
"to": "YYYYYYYYYY"
}
],
"text": "Mensaje por lotes enviado desde Inalambria"
}
]
}
Posibles Campos a Enviar en la Petición
Al consumir nuestro servicio, tenemos los siguientes campos a enviar:
Nombre | ¿Obligatorio? | Descripción | Tipo de Dato |
---|---|---|---|
messages | Sí | Arreglo de mensajes masivos que serán enviados. | Objeto messages |
bulkId | No | Identificador opcional, asociado al envío masivo. | Texto |
Descripción Objeto messages
Nombre | ¿Obligatorio? | Descripción | Tipo de Dato |
---|---|---|---|
destinations | Sí | Arreglo de destinatarios del mensaje. | Objeto destinations |
text | Sí | Contenido del mensaje a enviar. | Texto |
flash | No | Indica si el mensaje a enviar es de tipo Flash. | Booleano |
notifyUrl | No | URL donde se enviarán las notificaciones sobre el estado del mensaje. | Texto |
notifyContentType | No | Formato de las notificaciones (por ejemplo, application/json). | Texto |
callbackData | No | Información adicional en notación JSON, que será devuelta en el Callback. | Texto |
shortCode | No | Código corto que puede ser utilizado en el mensaje. Usado para mensajes bidireccionales. | Texto |
Descripción Objeto destinations
Nombre | ¿Obligatorio? | Descripción | Tipo de Dato |
---|---|---|---|
to | Sí | Número de teléfono del destinatario; recomendamos enviarlo en formato E.164. En caso contrario, se interpreta como número con indicativo 57 (código de país de Colombia). | Texto |
messageId | No | Identificador único del mensaje para el destinatario; es devuelto vía Callback. | Texto |
Posibles Estados HTTP de Respuesta
- 200: Mensaje recibido y en procesamiento.
- 400: Estructura de payload inválida.
- 401: No autorizado. Es necesario verificar las credenciales de autenticación.
- 403: Permisos insuficientes. Es posible que las credenciales estén validas, pero no se tiene permitido acceder al recurso (por ejemplo, la petición de consumo se genera desde una dirección IP no permitida).
- 500: Error interno del servidor. Se recomienda intentar en unos minutos, o en su defecto, contactar el servicio de soporte de Inalambria Internacional.
Campos de Respuesta
En la respuesta obtenida al consumir nuestro servicio, se encuentran los siguientes campos:
Nombre | Descripción | Tipo de Dato |
---|---|---|
TransactionNumber | Número de transacción, con el cual es posible consultar el estado de los envíos. | Número de 28 dígitos |
Status | Estado de la petición; si el mensaje fue validado de manera correcta para su envío, el valor de este campo será el número 0. Si la validación del mensaje para su envío falla, el valor de este campo será el número 1. | Númerico |
MessageText | Si el campo Status tiene por valor el número 1, aquí se encontrará la descripción del evento relacionado con el fallo en la validación. | Texto |