# Webhooks: Ereignisse sofort an andere Systeme melden

> Wie Sie in BetriebsOffice Webhooks anlegen, Ereignisse wie eine bezahlte Rechnung auswählen, die Signatur prüfen und Zustellungen kontrollieren.

Ein Webhook meldet ein Ereignis sofort an eine Adresse Ihrer Wahl: Ist eine Rechnung bezahlt, ein Angebot angenommen oder ein Auftrag angelegt, ruft BetriebsOffice die Adresse auf und schickt die Daten mit. So bleibt etwa ein Auswertungssystem oder Ihr Zapier-Ablauf ohne Verzögerung aktuell. Webhooks anlegen dürfen Personen mit dem Recht „Webhooks verwalten“.

## Schritt für Schritt

1. Öffnen Sie **Einstellungen** › **Entwickler und Webhooks**.
2. Klicken Sie im Abschnitt **Webhooks** auf **Webhook anlegen**.
3. Tragen Sie unter **Ziel** die **Ziel-URL** ein. Erlaubt sind nur HTTPS-Adressen und keine internen Adressen.
4. Geben Sie eine **Beschreibung** ein, etwa „Buchhaltung“ oder „Zapier“.
5. Wählen Sie unter **Ereignisse** aus, bei welchen Ereignissen die Adresse aufgerufen wird. Mindestens ein Ereignis ist nötig.
6. Klicken Sie im Dialog auf **Webhook anlegen**.
7. Kopieren Sie im Fenster **Geheimnis für die Signatur** das Geheimnis und hinterlegen Sie es im empfangenden System. Es wird nur jetzt angezeigt.
8. Klicken Sie in der Zeile des Webhooks auf **Testen**. BetriebsOffice sendet ein Beispielereignis an die Adresse.

## Welche Ereignisse es gibt

Zur Wahl stehen die Geschäftsereignisse der gebuchten Bereiche, zum Beispiel:

- **Kunde angelegt**
- **Angebot versendet**, **Angebot angenommen**, **Angebot abgelehnt**
- **Auftrag angelegt**, **Auftrag abgeschlossen**, **Auftrag storniert**
- **Einsatz geplant**, **Einsatz verschoben**, **Einsatz abgesagt**, **Arbeitsschein abgeschlossen**
- **Rechnung festgeschrieben**, **Rechnung versendet**, **Rechnung bezahlt**, **Rechnung storniert**, **Zahlung eingegangen**
- **Eingangsrechnung erfasst**, **Prüfung abgeschlossen**, **Wartungsvertrag gekündigt**
- **Aufgabe angelegt**, **Aufgabe erledigt**, **Ablauf gestartet**, **Freigabe angefragt**, **Freigabe erteilt**, **Freigabe abgelehnt**

## Signatur prüfen

Jeder Aufruf trägt eine Signatur (HMAC-SHA256) in einer Kopfzeile, gebildet aus Zeitstempel und Inhalt mit Ihrem Geheimnis. Das empfangende System sollte sie prüfen und nur Aufrufe annehmen, deren Zeitstempel höchstens wenige Minuten alt ist. Die genauen Angaben stehen auf der Seite unter **Signatur der Webhooks**. Unter **Beispiele** finden Entwicklerinnen und Entwickler fertigen Code: **Signatur prüfen (Node.js)** und **Signatur prüfen (PHP)**.

Vermuten Sie, dass das Geheimnis bekannt geworden ist, klicken Sie auf **Geheimnis erneuern**. Das alte Geheimnis gilt dann nicht mehr, und Sie hinterlegen das neue im empfangenden System.

## Zustellungen kontrollieren

Die Liste zeigt je Webhook die **Ziel-URL**, die **Ereignisse**, die **Letzte Zustellung** und den Stand **Aktiv** oder **Pausiert**. Über **Zustellungen** sehen Sie jeden Aufruf mit **Zeitpunkt**, **Ereignis**, **Stand** (**Ausstehend**, **Zugestellt**, **Fehlgeschlagen**, **Aufgegeben**) und der Zahl der **Versuche**. Einen einzelnen Aufruf senden Sie mit **Erneut zustellen** noch einmal.

Schlägt eine Zustellung fehl, wiederholt BetriebsOffice sie mit wachsendem Abstand. Nach vielen Fehlschlägen wird der Webhook pausiert, ebenso wenn das Ziel den Status 410 meldet. Beheben Sie dann den Fehler beim Empfänger und schalten Sie den Webhook über **Bearbeiten** wieder auf **Aktiv**.

## Tipps

- Webhooks liefern Ereignisse, Daten ändern Sie über die [API](https://betriebsoffice.de/handbuch/integrationen/api). Zapier und Make nutzen beides zusammen und legen ihre Webhooks beim Einschalten eines Ablaufs selbst an.
- Soll ein Fremdsystem nur in bestimmten Fällen etwas erfahren, etwa nur bei Rechnungen über einem Betrag, verwenden Sie in einer [Automatisierung](https://betriebsoffice.de/handbuch/zusammenarbeit/automationen) die Aktion **Webhook aufrufen**.
- Webhooks senden Daten zu Kunden, Rechnungen und Zahlungen an fremde Adressen. Vergeben Sie das Recht dazu deshalb nur an wenige Personen.

---

Quelle: https://betriebsoffice.de/handbuch/integrationen/webhooks
Stand: 2026-11-14
Anbieter: BetriebsOffice ist ein Angebot von Wigandt Technology (https://wigandt.tech).
