Webhooks

Ein Webhook sagt einem anderen System, zum Beispiel einem Automatisierungswerkzeug oder deinem eigenen Dienst, wenn in workelligence etwas passiert.

Einen Webhook hinzufügen

1. Öffne Einstellungen → Webhooks und klicke auf Webhook hinzufügen.
2. Gib die Endpunkt-URL ein, die die Ereignisse empfangen soll.
3. Setze einen Event-Filter, oder lass ihn leer für alle Ereignisse. Der Filter ist ein Präfix: invoice. für alles rund um Rechnungen, invoice.finalized für ein Ereignis, deal. für Deals.
4. Speichern. Das Signatur-Geheimnis wird einmal angezeigt; kopiere es.
5. Test-Event senden, um den Endpunkt zu prüfen.

Was gesendet wird

Jede Änderung im Aktivitätsprotokoll, ob eine Person, ein Workflow oder ein verbundener Assistent sie ausgelöst hat, wird als POST mit JSON-Body zugestellt. Jede Zustellung ist mit HMAC-SHA256 im Header X-AgencyOS-Signature signiert; prüfe sie auf deiner Seite.

Wiederholungen und Fehler

Eine fehlgeschlagene Zustellung wird dreimal mit wachsenden Abständen wiederholt. Jede Zustellung steht in der Liste der Zustellungen und lässt sich erneut senden. Nach zehn Fehlern in Folge deaktiviert sich der Webhook selbst und du wirst benachrichtigt; mit Wieder aktivieren schaltest du ihn ein, sobald der Endpunkt wieder funktioniert.