4.1 Conexión HTTP para recibir DLR


Si el cliente desea recibir las notificaciones de DLR de las peticiones enviadas por el API de envíos, deberá desarrollar un servicio web para procesar a su conveniencia dichas notificaciones.


URL: 

Definida por el cliente

METHOD: 

POST 

HEADERS: 

'Content-Type: application/json'

Authorization: [token]

BODY: 

{ 

mailingId: 234

statusDelivery: "DELIVERED"

sendDate: 1588694204000

carrier: "MOVISTAR"

} 



Parámetros  

URL 

Es la ruta del endpoint a donde deberán de enviarse las notificaciones. Esta se define dentro de portal Webhook SMS en del apartado API SMS > Configuración de la API > Webhook.

Obligatorio 

Authorization 

Identificador del usuario obtenido en el portal de Webhook SMS dentro del apartado API SMS > Configuración de la API > Webhook > Seguridad.

Obligatorio

mailingId 

Identificador único asociado a un registro específico dentro del sistema (corresponde con el mailingId de una respuesta exitosa en el consumo del API).

Obligatorio 

statusDelivery 

Parámetro que indica el estado del envío del MT. Puede tener alguno de los siguientes valores:

  • DELIVERED: envío exitoso.

  • REJECTED: envío rechazado por el operador.

  • UNKNOWN: envío rechazado por el operador, se desconoce el código de error

Obligatorio

sendDate

Parámetro que indica la fecha y hora de envío del MT.

Obligatorio

carrier

Compañía telefónica al que pertenece el msisdn (número telefónico)

Obligatorio


4.1.1 Ejemplo de Solicitud 


{ 

mailingId: 234

statusDelivery: "DELIVERED"

sendDate: 1588694204000

carrier: "MOVISTAR"

} 


4.2 Códigos de Respuesta


La respuesta del servicio deberá ser texto plano y el código HTTP correspondiente, se considerará como exitosa una respuesta con código 200 y errónea cualquier otro código.