Integration (Webhooks & API)

Klärungen lassen sich per Webhooks an externe Systeme übergeben und per API auslesen — etwa um ein ERP, ein Ticketsystem oder ein Data Warehouse anzubin…

Klärungen lassen sich per Webhooks an externe Systeme übergeben und per API auslesen — etwa um ein ERP, ein Ticketsystem oder ein Data Warehouse anzubinden.

Webhooks

Klärungs-Ereignisse lösen ausgehende Webhook-Benachrichtigungen aus (als HTTP-Aufruf oder, bei E-Mail-Webhooks, als E-Mail). Webhooks werden in den üblichen Webhook-Einstellungen konfiguriert. Die relevanten Klärungs-Ereignisse sind:

Der Payload enthält die Felder der Klärung (siehe API unten). Bei einem gelöschten Ereignis trägt die Nutzlast nur die ID der Klärung, da diese nicht mehr existiert.

API

Die API stellt Klärungen (nicht Antworten/Ereignisse/Workflows) lesend bereit. Zu den Feldern zählen: Klärungsnummer, Status, Thema, Kunde, Reporter/Bearbeiter, Bereichs-/Geschäftsbereichs-/Vertriebseinheits-IDs, Workflow- und Antwortvorlagen-IDs, Datumsangaben (erstellt, fällig, eskaliert, gelöst, zuletzt gestartet, aktualisiert), Eskalationsstufe/-anzahl/-empfänger, Restart-Anzahl und -Quelle, Schließgrund/-quelle, der verknüpfte Beleg, die Bearbeiter-Team-IDs sowie die Gründe als kommaseparierte Titel (erforderliche und optionale Gründe).

Tipp: Wenn ein Webhook oder Export ein Feld zu „vermissen" scheint, das in der Oberfläche existiert: Antworten und Ereignisse werden nicht einzeln bereitgestellt — nur die Klärung. Der aktuelle Grund ist über die Felder des akzeptierten Grunds verfügbar.

Kontextbezogene Zuständigkeiten (User-Context-Links)

Ist die Funktion User-Context-Links für Ihr Unternehmen aktiviert, können Workflows den Reporter/Bearbeiter aus einer User-Context-Rolle ableiten (Kontakt je Kunde oder je Buchungskreis) statt aus einem festen Nutzer. Das ist besonders bei großen Kundenstämmen nützlich, in denen Zuständigkeiten pro Kunde variieren.