Webhook¶
Webhooks sind eine Möglichkeit, Zammad in andere Webdienste oder Anwendungen zu integrieren. Dadurch können diese Live-Updates zu Tickets abonnieren, anstatt Zammad alle n Minuten abzufragen.
Bemerkung
⌛ Webhooks kommen möglicherweise nicht sofort an.
Webhooks 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.
Hinweis
Webhooks sind für Trigger und Automatisierung verfügbar.
Wie funktionieren Webhooks¶
Unter der Haube sendet Zammad eine POST-Anfrage an eine Drittanbieter-URL („API-Endpunkt“), die Sie im Dialogfeld „Neuer Webhook“ 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 komplett neu als auch aus vordefinierten Vorlagen erstellt werden.
Wenn Sie Webhooks komplett neu erstellen, enthalten reguläre Webhook-Payloads standardmäßig die folgenden JSON-Daten zu neuen/aktualisierten Tickets:
Ticket-Attribute/Metadaten
alle zugehörigen 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, den Webhook-Payload weiter an Ihre eigenen Bedürfnisse anzupassen.
Erfahren Sie mehr