Events nachvollziehen

Wenn im tebio Business-Portal ein Ereignis auftritt, das für einen konfigurierten Webhook relevant ist, erzeugt tebio ein Event. Der Reiter Ereignisse dient als zentrale Übersicht zur Überwachung von Webhook-Ereignissen, mit dem Sie nachvollziehen können, welche Ereignisse wann an Ihre Endpunkte gesendet wurden und ob die Übertragung erfolgreich war.

Wann brauche ich diese Funktion?

Nutzen Sie das Webhook-Event-Log, wenn Sie:

Prüfen möchten, ob ein bestimmtes Ereignis (z. B. eine Adressänderung oder eine neue Bestellung) tatsächlich an Ihr Drittsystem, zum Beispiel CRM oder ERP, übermittelt wurde.
Fehler suchen oder Debugging durchführen möchten, weil Ihr Drittsystem Daten nicht oder unvollständig erhalten hat.
Sich einen Überblick über Anzahl und Art der ausgelösten Ereignisse verschaffen wollen.

Voraussetzungen

Sie benötigen administrative Rechte für den Entwickler-Bereich.
Sie sollten bereits mindestens einen Webhook eingerichtet haben, da ansonsten keine Webhook-Ereignisse in dieser Übersicht erscheinen.

Schritt-für-Schritt-Anleitung

Klicken Sie in der Hauptnavigation auf das Terminal-Symbol oben rechts.
Wechseln Sie auf den Reiter Ereignisse.

Ereignisse filtern und überwachen

In der Standardansicht sehen Sie eine chronologische Liste aller für Ihre Endpunkte erzeugten Events.

Nutzen Sie das Dropdown Status auf der linken Seite, um die Liste gezielt zu filtern:

Keine: Hebt den Filter auf und zeigt alle Events an.
Benachrichtigt: Zeigt alle Events, die erfolgreich an Ihren Webhook übermittelt wurden (HTTP-Status 200 OK).
Geplant: Zeigt Events, die sich noch in der Warteschlange befinden und in Kürze gesendet werden.
Fehlgeschlagen: Relevant für Debugging und Fehleranalyse. Zeigt Events, bei denen der Zustellversuch gescheitert ist (z. B. weil Ihr Empfängerserver offline war oder mit einem Fehlercode wie 500 geantwortet hat). Hinweis: tebio verfügt über eine automatische Wiederholungslogik (Retry) und versucht die Zustellung bei Fehlern mehrfach erneut.

Tabelle verstehen

Die Tabelle liefert Ihnen die wichtigsten Metadaten zu jedem Event:

Datum/Uhrzeit des Ereignisses: Zeitpunkt, zu dem das Ereignis im Portal aufgetreten ist.
Datum/Uhrzeit der Benachrichtigung: Zeitpunkt, zu dem das Event (erfolgreich) an Ihren Webhook gesendet wurde.
Codetyp: Die technische Bezeichnung des Ereignisses (z. B. customer.address.update oder subscription.option.add).
Entität: Das betroffene Datenobjekt (z. B. ADDRESS, SUBSCRIPTION).
Referenz, ID oder UID: Die eindeutigen Kennungen des betroffenen Datensatzes, mit denen Sie oder Ihr System den Datensatz per API abrufen können.

Ergebnis

Sie sehen, welche Webhook-Ereignisse erzeugt wurden, welchen Status die Zustellung hat und welche Datensätze betroffen sind.

API-Hinweise

Wenn Sie das Event-Log über die API auslesen oder den Benachrichtigungsstatus fehlgeschlagener Events aktualisieren möchten, nutzen Sie folgende Endpunkte:

Endpunkt	Methode	Beschreibung	OperationId
`/v1/event/webhook`	GET	Webhook-Events suchen (filterbar nach Status und Datum)	searchWebhookEvent
`/v1/event/webhook`	PATCH	Benachrichtigungsstatus eines Webhook-Events aktualisieren (z. B. um Retry-Vorgänge manuell zu beenden)	updateWebhookEvent