INNOVA360 - Documentación

Callbacks de entregas (DLR)

Introducción

El servicio de Callbacks de entregas (DLR) te permite recibir una notificación automática en tu sistema cuando el porcentaje de entregas confirmadas de tus envíos SMS o Email caiga por debajo de un límite que tú mismo defines.

La plataforma revisa periódicamente las notificaciones de entrega registradas en la última hora y, si detecta que el porcentaje de entrega de alguno de los canales configurados no alcanza el mínimo establecido, realiza una llamada HTTP POST a la URL de callback que hayas indicado, enviando un resumen con los datos del intervalo analizado.

Este servicio es independiente para cada canal: puedes configurar solo SMS, solo Email, o ambos a la vez, cada uno con su propio límite.

Parámetros de configuración

Desde el apartado Preferencias › Callbacks de entregas (DLR) puedes configurar los siguientes parámetros:

Parámetro Descripción Valores válidos
Callback URL Endpoint de tu sistema al que la plataforma enviará la alerta mediante una petición HTTP POST en formato JSON. Si se deja en blanco, el servicio quedará desactivado. URL válida
SMS - Porcentaje límite Límite mínimo de entregas confirmadas para el canal SMS. Si el porcentaje de entregas registradas en la última hora cae por debajo de este valor, se enviará una alerta. Deja el campo vacío si no deseas recibir alertas de SMS. Entero entre 80 y 99
Email - Porcentaje límite Límite mínimo de entregas confirmadas para el canal Email. Si el porcentaje de entregas registradas en la última hora cae por debajo de este valor, se enviará una alerta. Deja el campo vacío si no deseas recibir alertas de Email. Entero entre 95 y 99

Activar y desactivar el servicio

El servicio se considera activo cuando se cumplen las dos condiciones siguientes:

  • Se ha introducido una URL de callback válida.
  • Se ha configurado al menos uno de los dos porcentajes límite (SMS o Email).

Para desactivar el servicio por completo basta con dejar la URL de callback en blanco y guardar. Al hacerlo, también se eliminarán los porcentajes almacenados.

Si únicamente quieres desactivar las alertas de un canal concreto, deja vacío el campo del porcentaje correspondiente y guarda. El otro canal seguirá activo mientras tenga su porcentaje configurado y la URL siga siendo válida.

Frecuencia de revisión de notificaciones de entrega

La plataforma ejecuta la revisión de las notificaciones de entrega una vez cada hora, a los 30 minutos (es decir, a las 00:30, 01:30, 02:30…). Este retraso de media hora es intencionado: permite que las notificaciones de entrega que se encuentran en estado pendiente tengan tiempo suficiente para ser confirmadas antes de que se evalúe el porcentaje.

En cada ejecución se analizan las notificaciones de entrega registradas en la ventana de tiempo comprendida entre 90 minutos y 30 minutos antes del momento de la comprobación. Por ejemplo, si la comprobación se ejecuta a las 10:30, se analizan las notificaciones cuya fecha de envío se encuentre entre las 09:00 y las 10:00.

Callback

Cuando el porcentaje de entrega de un canal cae por debajo del límite configurado, la plataforma realiza una petición HTTP POST a tu URL con el siguiente cuerpo en formato JSON. Todas las fechas se expresan en UTC.

Se genera una llamada independiente por canal: si tanto SMS como Email superan el límite en la misma revisión, recibirás dos callbacks separados.

Ejemplo de callback de SMS 
{
    "data": {
        "channel": "SMS",
        "start_date": "2026-03-10 10:00:00",
        "end_date": "2026-03-10 11:00:00",
        "total_dlr": 1200,
        "delivered_dlr": 900,
        "delivered_percentage": 75,
        "threshold_percentage": 80
    }
}

Ejemplo de callback de Email 
{
    "data": {
        "channel": "Email",
        "start_date": "2026-03-10 10:00:00",
        "end_date": "2026-03-10 11:00:00",
        "total_dlr": 1000,
        "delivered_dlr": 950,
        "delivered_percentage": 95,
        "threshold_percentage": 97
    }
}