Konzepte: Ereignisse, Trigger und Nachrichten

Die tebio Plattform basiert im Kern auf einer ereignisgesteuerten Architektur. Statt feste Abläufe hart zu verdrahten, wann genau eine E-Mail versendet oder ein Drittsystem benachrichtigt werden muss, werden nahezu alle relevanten Vorgänge zunächst als technische Ereignisse (Events) im System publiziert.

Dieses Konzept ermöglicht eine Entkopplung von Prozessen: Die eigentliche Geschäftslogik (z. B. eine automatisierte Rechnungsstellung im Abrechnungslauf (Billrun)) kümmert sich nicht um den E-Mail-Versand. Stattdessen reagieren Trigger auf das Ereignis und lösen dann asynchron die gewünschten Nachrichten aus.

Dieser Artikel erklärt die drei Bestandteile dieses Workflows.

1. Ereignisse (Events)

Wenn ein wichtiger Geschäftsfall in der tebio Plattform eintritt, wird ein Ereignis erzeugt. Beispiele für typische Ereignistypen (Event Type Codes) sind:

customer.created (Ein neuer Kunde wurde angelegt)
invoice.finalized (Eine Rechnung wurde verbindlich erstellt)
payment.failed (Eine Zahlung ist fehlgeschlagen)
subscription.cancelled (eine Subscription wurde gekündigt)

Ereignisverlauf: Jedes Event wird in der Kundenansicht als Historien-Eintrag (Customer History) gespeichert. Über die sogenannten EventTypeSettings können Sie definieren, wie ein bestimmter Event-Typ für Kunden (im Self-Care / Kundenportal) oder für Ihre Portalnutzer (im Business-Portal) übersetzt und in verschiedenen Sprachen angezeigt werden soll.

2. Trigger (Auslöser)

Ein Event allein führt noch keine Aktion aus – es ist im ersten Schritt nur ein Protokolleintrag. Damit auf ein Event eine Aktion folgt, kommen Trigger ins Spiel. Ein Trigger reagiert auf bestimmte Event-Typen und führt bei deren Eintreten eine verknüpfte Aktion aus.

Es gibt zwei zentrale Trigger-Mechanismen in der Plattform:

System-Trigger (Messaging): Das interne Messaging-Modul reagiert auf Ereignisse und löst vordefinierte E-Mail- oder Brief-Workflows an. So ist zum Beispiel konfiguriert, dass bei einem invoice.finalized-Event die Rechnungs-E-Mail an den Kunden generiert und versendet wird.
Webhooks (Externe Trigger): Sie können eigene Webhook-Endpunkte konfigurieren. Sobald ein von Ihnen definierter Event-Typ auftritt, sendet tebio einen POST-Request (eine Push-Benachrichtigung) an Ihre eigenen Server. So können Sie Ihr CRM- oder ERP-System automatisch synchronisieren, ohne die tebio API permanent per Polling abfragen zu müssen.

3. Nachrichten (Messaging)

Wenn ein System-Trigger auslöst, übernimmt das Messaging-Modul die Erstellung und den Versand der eigentlichen Nachricht. Die Plattform unterstützt hierbei primär zwei Transportwege: digitale E-Mails und postalische Briefe.

Nachrichtenkanäle

E-Mail-Versand

SMTP-Accounts: Sie können eigene SMTP-Server im System hinterlegen, damit E-Mails (z. B. Mahnungen oder Bestellbestätigungen) sauber unter Ihrer eigenen Firmen-Domain verschickt werden.
E-Mail-Vorlagen: Für jeden Zweck legen Sie individuelle Templates an. Das Messaging-Modul füllt diese Templates zur Laufzeit automatisch mit den konkreten Werten aus dem Event (z. B. Kundenname, Rechnungsbetrag) und hängt bei Bedarf PDF-Dokumente an.
Store-and-Forward: Der Versand erfolgt asynchron. Bei temporärer Nichterreichbarkeit Ihres Mailservers versucht das System den Versand automatisch erneut.

Physischer Briefversand (Deutsche Post)

Das System verfügt über eine integrierte Anbindung an den E-POSTBUSINESS Service der Deutschen Post.
Auf Basis von Briefvorlagen wird aus den Event-Daten ein PDF-Dokument (inklusive korrekter Adressfenster-Positionierung) generiert.
Das Messaging-Modul übermittelt dieses PDF asynchron an die Post, wo es gedruckt, kuvertiert und postalisch an die hinterlegte Adresse oder den vorgesehenen Empfänger zugestellt wird.

Zusammenfassung

Eine Aktion (z. B. Rechnungsstellung) publiziert ein neutrales Event.
Ein konfigurierter Trigger (System oder Webhook) registriert das Event.
tebio sendet einen Webhook an Ihre Systeme oder das Messaging-Modul generiert auf Basis eines Templates eine Nachricht (E-Mail/Brief).