Ereignisbenachrichtigungen

Das Ereignisbenachrichtigungssystem dient als Ersatz für das veraltete System zur Übermittlung von Zustellberichten und eingehenden SMS (diese alten Systeme gelten als veraltet, werden nicht verbessert und werden nicht zur weiteren Verwendung empfohlen).

Mit dem Ereignisbenachrichtigungssystem können Sie Informationen über bestimmte Ereignisse an bestimmte URIs (http oder E-Mail) senden. Sie können das System so anpassen, dass Benachrichtigungen über ein Ereignis an verschiedene URIs gesendet werden. Sie können auch verschiedene Benachrichtigungen an die gleiche URI schicken.

Um die Benachrichtigungen zu konfigurieren, öffnen Sie die Einstellungsseite in Ihrem Web-Account (account.lox24.eu -> Einstellungen -> Benachrichtigungen), klicken Sie auf “Neuen Webhook erstellen” und geben Sie im Feld URI die http-Adresse oder E-Mail ein, an die Sie Benachrichtigungen erhalten möchten. Standardmäßig werden alle möglichen Ereignisse an die angegebene URI gesendet. Wenn Sie nur über bestimmte Ereignisse benachrichtigt werden möchten, markieren Sie das Kästchen neben den Ereignissen, über die Sie benachrichtigt werden möchten.

Wenn Sie zusätzliche Benachrichtigungen wünschen, wiederholen Sie die obige Vorgehensweise. Es können maximal fünf individuelle Benachrichtigungseinstellungen erstellt werden.

Die Ereignisinformationen werden im JSON-Objektformat übermittelt, das für alle Ereignisse das gleiche Format hat und sich nur in den Daten des Ereignisses selbst unterscheidet.

Struktur des Ereignisobjekts

Feld	Typ	Beschreibung
id	string (36 chars)	Ereignis ID
api_version	string	Version der Datenstruktur
name	string	Ereignis Name, e.g. ‘sms.delivery’
created_at	integer	Unix timestamp des Ereignisses
attempt_total	integer	Gesamtzahl der Übertragungsvesuche (re-tries).
attempt_number	integer	Aktueller Übertragungsversuch
data	object	Ereignisdaten (siehe Liste der Ereignisse)
notification_task_id	string (36 chars)	ID des Übertragungsversuchs

Beispielereignis

{
    "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"
}

Ereignis-Transportarten

Das Benachrichtigungssystem kann Ereignisinformationen auf zwei Arten senden: HTTPS und E-Mail.

HTTP

Das json wird als Body der http-Anfrage mit der Kopfzeile Content-Type: application/json gesendet. Der Dienst wird weiterhin versuchen, die Anfrage zu senden (in zunehmenden Zeitabständen), bis er eine Antwort mit einem Statuscode >= 200 und < 300 erhält oder die Anzahl der Versuche den im Feld attempt_number angegebenen Wert erreicht.

HINWEIS: Die Antwort Ihres Endpunkt-Skripts wird nicht berücksichtigt, daher müssen Sie Ihr Skript überwachen. Im Falle von Störungen erfolgt keine Benachrichtigung durch uns.

E-Mail

Das json wird als Body der E-Mail mit einem einzigen Versuch von einer E-Mail no-reply@lox24.eu gesendet.

Hosts und IP-Adressen des Dienstes

Warnmeldungen werden von den folgenden IP-Adressen gesendet. Wenn Sie eine Firewall verwenden, vergessen Sie nicht, diese IP-Adressen auf die Whitelist zu setzen.

IPv4:

162.55.80.140
162.55.80.141
5.9.114.27
144.76.190.20

IPv6:

2a01:4f8:271:10a7::2
2a01:4f8:271:10a6::2

Ereignisbenachrichtigungen