WebHooks

Was sind WebHooks?

Ganz einfach: WebHooks sind eine simple Lösung für die Kommunikation zwischen Systemen. Sie ermöglichen es Ihnen, Echtzeitdaten an andere Anwendungen zu senden.

Vereinfacht sieht der Ablauf wie folgt aus:

WebHooks sind in Zammad seit Version 3.6 verfügbar. Mit der Einführung der Version 6.0 sind auch frei konfigurierbare und vordefinierte WebHooks hinzugekommen, die den Nutzern zusätzliche Flexibilität und Optionen bieten. Mit dieser Erweiterung haben Sie die Flexibilität, Ihren eigenen Payload zu definieren und ihm bestimmte Ticketwerte zuzuweisen.

Vorteil für Microsoft Teams Nutzer: Zusätzlich zu unseren bestehenden Integrationen mit Slack, Mattermost, RocketChat und anderen Plattformen, ermöglicht ein vordefinierter WebHook für Microsoft Teams jetzt eine nahtlose Kommunikation und Echtzeit-Benachrichtigungen innerhalb Ihrer Microsoft Teams-Umgebung.

Anwendungsfall

Anhand von Anwendungsfällen wird die Funktion von WebHooks verdeutlicht.

Anwendungsfall (Microsoft Teams, Slack, RocketChat und andere Platformen)
Mit den vordefinierten WebHook für Microsoft Teams, Slack oder RocketChat wird eine nahtlose Kommunikation und Echtzeit-Benachrichtigungen innerhalb Ihrer Kommunikations-Umgebung ermöglicht.

Anwendungsfall (Kundenbeziehungsmanagement/CRM)
Möchten Sie zum Beispiel in Ihr CRM, Ticket-Informationen aus dem Support synchronisieren (,damit Ihre Sales Mitarbeiter auch einen Überblick über offene Support Fälle in Ihrem Support haben), so kann dies durch WebHooks bewerkstelligt werden (sofern Ihr CRM dies unterstützt).

So funktioniert's

• Erstellen Sie einen Trigger in der Admin-Oberfläche mit einer Ziel-URL und einem Signatur-Token (optional)
• Konfigurieren Sie einen Trigger, der definiert, wann es starten soll
• Der Zielserver hat nun alle Ticket-, Artikel-, Gruppen- und Benutzerdaten im JSON-Format erhalten
• Die Integrität der Daten kann mit einer HMAC-Signatur im Header verifiziert werden

Im Detail

Aber was passiert jetzt genau? Zammad sendet eine POST-Anfrage an eine Drittanbieter-URL ("API-Endpunkt"), die Sie im Dialog "Neuer Webhook" angeben und im Dialog "Neuer Trigger" auswählen. Der Anwendungsserver hinter dieser URL/Endpunkt muss so konfiguriert sein, dass er Nachrichten von Zammad empfängt und die angehängten Daten entsprechend verarbeitet.

WebHook-Anfragen von Zammad enthalten die folgenden JSON-Daten über neue / eingehende Tickets:

• Ticket-Attribute / Metadaten
• alle zugehörigen Artikel
• zugehörige Benutzer (z.B. Artikelabsender, Besitzer, etc.)
• zugehörige Benutzerrollen
• zugehörige Benutzerorganisationen (falls zutreffend)
• zugehörige Gruppen

Weitere Informationen finden Sie in unserer Admin-Dokumentation.

Dieses Feature basiert auf einem Beitrag von unserem Community-Mitglied DukeX! 💛