# Webhooks

> Ereignisse an ein anderes System schicken, wenn sich in deinem Workspace etwas ändert.

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.