Konzept von Webhooks in enneo

Neben den Events, die eine asynchrone Verarbeitung ermöglichen, bietet enneo auch Webhooks, die eine synchrone Bearbeitung von Prozessen unterstützen. Webhooks sind besonders nützlich, wenn es darum geht, den Prozessfluss in Echtzeit zu beeinflussen und externe Systeme direkt einzubinden.

Tip

Webhooks unterbrechen den laufenden Prozess in enneo an definierten Punkten. Dies ermöglicht es, in Echtzeit auf Daten und Ereignisse zu reagieren und gegebenenfalls notwendige Informationen aus externen Systemen nachzuladen, bevor der Prozess in enneo fortgesetzt wird.

Mit Webhooks kann eigener Code oder externe APIs aufgerufen werden, sobald bestimmte Ereignisse auftreten, beispielsweise wenn eine E-Mail oder ein Brief empfangen oder versendet wird. Der Aufruf ist synchron, das heißt, bei einem Fehlschlag wird der Benutzer benachrichtigt.

Webhooks bei E-Mails

Unter Einstellungen → E-Mail → E-Mail Konten ein E-Mail Konto auswählen und den Schalter „Webhooks aktivieren“ einschalten. Danach stehen zwei Webhooks zur Verfügung:

„Update eines Tickets“: bei Änderungen an Ticketeigenschaften, z. B. Status (offen/geschlossen), Priorität, Frist oder Zuweisung.
„Neue E-Mail“: bei jeder eingehenden oder ausgehenden E-Mail sowie bei internen Notizen. Ist die E-Mail eine Antwort oder geht sie aus, ist das Feld conversationId gesetzt, sonst ist es null.

Webhooks bei Briefen

Unter Einstellungen → Brief → (Postfach auswählen) → Webhooks den Schalter „Webhooks aktivieren“ einschalten. Danach stehen drei Webhooks zur Verfügung:

„Update eines Tickets“: bei Änderungen an Ticketeigenschaften, wie bei E-Mails.
„Neuer Brief / Conversation“: bei jedem neuen Brief bzw. jeder neuen Nachricht im Ticket.
„Brief versenden“: übergibt ausgehende Briefe an Ihren Druckdienstleister, siehe Brief.

Webhooks im Bereich der ERP-Integration

Durch die Integration von Webhooks können externe APIs angebunden werden, um Kundendaten live abzufragen. Immer wenn enneo Kundendaten benötigt, wird die Anfrage über den konfigurierten Individualcode an die hinterlegte API weitergeleitet. Enneo speichert Abfragen zudem zwischen.

Tip

Enneo unterstützt nativ verschiedene ERP-Systeme, kann aber auch durch Integrationen an andere Systeme angebunden werden. Die hier aufgeführten Webhooks dienen dieser Integration und ermöglichen den Zugriff auf Kundendaten in Echtzeit.

Bei nativ unterstützten Systemen sind keine Webhooks für die ERP-Integration notwendig, da diese bereits im Kern von enneo umgesetzt sind.

Konfiguration erfolgt unter Einstellungen → Integration in Umsysteme → API-Integration. Folgende Webhook-Arten sind verfügbar:

Suche Vertrag nach ID: Enneo kann Verträge anhand der Vertrags-ID suchen. Dieser Webhook wird genutzt, um die Vertragsdaten zu laden.
Suche Kunde nach ID: Enneo kann Kunden anhand der Kunden-ID suchen. Dieser Webhook wird genutzt, um die Kundendaten zu laden.
Merkmalbasierte Suche von Verträgen: Enneo kann Verträge anhand spezifischer Merkmale durchsuchen. Dieser Code wird ausgeführt, wenn die enneo-KI bestimmte Merkmale, z. B. Namen oder Adressen in der Kundenkommunikation erkennt und darauf basierend Verträge sucht.
Freitextsuche von Kunden: Enneo ermöglicht die Suche nach Kunden mittels einer Freitextsuche. Dieser Code wird ausgeführt, wenn Agenten die Freitextsuchleiste oben rechts verwenden.