Mensaje SMS Unidireccional (Batch - En Lotes)

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ónTipo de Dato
messagesArreglo de mensajes masivos que serán enviados.Objeto messages
bulkIdNoIdentificador opcional, asociado al envío masivo.Texto

Descripción Objeto messages

Nombre¿Obligatorio?DescripciónTipo de Dato
destinationsArreglo de destinatarios del mensaje.Objeto destinations
textContenido del mensaje a enviar.Texto
flashNoIndica si el mensaje a enviar es de tipo Flash.Booleano
notifyUrlNoURL donde se enviarán las notificaciones sobre el estado del mensaje.Texto
notifyContentTypeNoFormato de las notificaciones (por ejemplo, application/json).Texto
callbackDataNoInformación adicional en notación JSON, que será devuelta en el Callback.Texto
shortCodeNoCódigo corto que puede ser utilizado en el mensaje. Usado para mensajes bidireccionales.Texto

Descripción Objeto destinations

Nombre¿Obligatorio?DescripciónTipo de Dato
toNú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
messageIdNoIdentificador ú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:

NombreDescripciónTipo de Dato
TransactionNumberNúmero de transacción, con el cual es posible consultar el estado de los envíos.Número de 28 dígitos
StatusEstado 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
MessageTextSi 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
Language
Click Try It! to start a request and see the response here!