Tipos de transporte de acontecimientos
Notificaciones
Sección titulada «Notificaciones»El sistema de mensajería de eventos se creó en sustitución del anticuado sistema de notificación del estado de entrega de sms salientes y entrantes (estos sistemas se consideran obsoletos, no se mejorarán y no se recomienda su uso).
El sistema de mensajería de eventos permite enviar información sobre eventos concretos a URIs específicas (http o correo electrónico). Puede personalizar el sistema para enviar notificaciones de un evento a diferentes URI.
Para configurar las notificaciones, abra la página de configuración (account.lox24.eu -> Configuración -> Notificaciones), haga clic en “Crear un nuevo webhook” e introduzca en el campo URI la dirección http o el correo electrónico al que desea recibir las notificaciones. Por defecto, todos los eventos posibles se enviarán a la URI especificada. Si sólo desea recibir notificaciones sobre determinados eventos, marque la casilla situada junto a los eventos sobre los que desea recibir notificaciones.
Si necesita notificaciones adicionales, repita las instrucciones anteriores. Se puede crear un máximo de cinco notificaciones individuales.
La información del evento se notificará en formato de objeto JSON, que tiene el mismo formato para todos los eventos y sólo difiere en los datos del propio evento.
Estructura del objetivo del evento
Sección titulada «Estructura del objetivo del evento»| Campo | Tipo | Descripción |
|---|---|---|
| id | string (36 chars) | ID del evento |
| api_version | string | Versión de la estructura de datos |
| name | string | Nombre de evento E.j. ‘sms.delivery’ |
| created_at | integer | Unix timestamp cuando el evento fue creado |
| attempt_total | integer | Número total de intentos (reintentos). |
| attempt_number | integer | Número actual de intentos |
| data | object | Datos del evento (ver lista de eventos) |
| notification_task_id | string (36 chars) | ID de la tarea de notificación (identificador de la solicitud) |
Ejemplo de evento
Sección titulada «Ejemplo de evento»{ "id": "a3cd6e19-8af2-498d-ad07-c7840f1b4ac8", "data": { "id": "d6c12ac4-cc7d-11ec-b6da-525400bbb7dc", "key_id": 8207, "dlr_code": 1, "status_code": 100, "callback_data": "some data from user's request here" }, "name": "sms.delivery", "created_at": 1653378603, "api_version": "2022-05-25", "attempt_number": 1, "attempts_total": 4, "notification_task_id": "3378de83-de66-4de8-9d29-2b10d41bb641"}Tipos de transporte de acontecimientos
Sección titulada «Tipos de transporte de acontecimientos»El sistema de notificación puede enviar información de eventos de dos maneras (transportes): HTTP y Correo electrónico
El json se envía como cuerpo de la petición http con la cabecera Content-Type: application/json.
El servicio continuará intentando enviar la petición (a intervalos de tiempo crecientes) hasta que reciba una respuesta con un código de estado >= 200 y < 300 o el número de intentos alcance el valor especificado en el campo número_de_intentos.
NOTA: La respuesta de su script de punto final no se tiene en cuenta, por lo que debe supervisar su script. En caso de mal funcionamiento no hay notificación por nuestra parte.
El json se envía como cuerpo del email con un único intento desde un email no-reply@lox24.eu.
Servicio de hosts y direcciones IP
Sección titulada «Servicio de hosts y direcciones IP»Las alertas se envían desde los siguientes hosts 162.55.80.140 y 162.55.80.141. Si utilizas un cortafuegos, no olvides poner esas direcciones IP en la lista blanca.