Esta web utiliza 'cookies' propias y de terceros para ofrecerte una mejor experiencia y servicio

Ok Leer más

Documentación

Notificacion de estados envios

Petición enviada por smsup, a la url indicada, cuando se reciben nuevos estados para los envíos.

La url a la que se debe enviar la notificación se debe indicar en Configuración / Datos API

Parámetros recibidos

Se recibe una petición POST, en formato JSON, con un array de objetos, siendo cada objeto el estado de un sms. Se pueden recibir hasta 100 estados en una sola petición. Los parámetros indicados en cada objeto son:

Nombre
Descripción
id
Identificador del sms que se dio como respuesta en la petición de envío realizada a la API
estado
Estado del sms enviado
referencia
Valor que se indicó en el campo referencia al hacer la petición de envío a la api, irá en blanco si no se indico ningún valor
prefijo
El prefijo del numero al que se envió el mensaje
telefono
Número de teléfono al que se envió el mensaje
numeroCompleto
Número internacional completo, en formato +prefijo teléfono. Ej: +44 0000000000
mensajes
Número total de mensajes de los que se compone el sms
creditos
Numero de créditos consumidos por el envío. En caso de no haberse enviado el mensaje puede devolver 0 o null indistintamente. Para envíos anteriores al 25/08/2017 este dato no esta disponible y se devolverá null

Los estados que se pueden enviar y su significado son los siguientes:

Respuesta

Si la recepción de la petición es correcta se debe responder con el código HTTP 200. En caso contrario, se asume que ocurrió un error al procesar la notificación y se reintentara a los 5 minutos, si falla de nuevo a los 10 minutos y si falla otra vez a los 15 minutos.

Ejemplo

Petición:

POST http://urlindicada/ HTTP/1.1
Host: urlindicada
Content-Length: 304

[{"id":"12345678", "estado":"OK: Entregado a destino", "referencia":"45tj566", "prefijo":"34", "telefono":"678XXXXXX", "mensajes":"1", "creditos":"1.00"},
 {"id":"11223344", "estado":"Terminal no disponible", "referencia":"", "prefijo":"34", "telefono":"698XXXXXX", "mensajes":"2", "creditos":"1.60"}]

Respuesta:

Codigo HTTP 200