Webhook¶
Webhooks sind eine Möglichkeit, Zammad mit anderen Webdiensten oder Anwendungen zu verbinden, so dass diese Live-Aktualisierungen über Tickets abonnieren können, anstatt den Zammad-Server alle n Minuten abzufragen. Sie finden die Webhook-Konfiguration in den Einstellungen von Zammad unter Verwalten > Webhooks.
Hinweis
Webhooks kommen möglicherweise nicht sofort an. Sie werden mit der gleichen Priorität und in der gleichen Reihenfolge wie per Trigger ausgelöste E-Mails verschickt. Wenn die Ausführung des Webhooks fehlschlägt (z.B. weil der empfangende Server falsch konfiguriert ist), versucht Zammad es bis zu vier Mal erneut.
Webhooks müssen durch Trigger oder Automatisierung ausgelöst werden.
Wie funktionieren Webhooks¶
Unter der Haube sendet Zammad eine Anfrage an eine Drittanbieter-URL („API-Endpunkt“), die Sie in der Webhook-Konfiguration angeben. Der Anwendungsserver hinter dieser URL/Endpunkt muss so konfiguriert sein, dass er Nachrichten von Zammad empfängt und die bereitgestellten Nutzdaten entsprechend verarbeitet.
Webhooks können sowohl von Grund auf als auch aus vordefinierten Vorlagen erstellt werden. Wenn sie von Grund auf neu erstellt werden, enthält die Webhook-Nutzlast standardmäßig die folgenden JSON-Daten über neue/aktualisierte Tickets:
Ticket-Attribute/Metadaten
Zugehörige(r) Artikel
Jeweilige Benutzer (z.B. Absender von Artikeln, Besitzer usw.)
Jeweilige Benutzerrollen
Jeweilige Organisationen der Benutzer (falls vorhanden)
Jeweilige Gruppen
Andererseits sind vordefinierte Webhooks für die Zusammenarbeit mit bestimmten Diensten konzipiert und enthalten spezielle Nutzdaten, die diese Dienste verstehen. In beiden Fällen ist es jedoch möglich, die Webhook-Nutzlast weiter an Ihre eigenen Bedürfnisse anzupassen.