Was ist ein Webhook?
Ein Webhook ermöglicht die automatische Kommunikation zwischen zwei Systemen. Sobald ein bestimmtes Ereignis in venabo eintritt – zum Beispiel eine neue Buchung oder ein gelöschter Urlaubseintrag – sendet venabo automatisch eine Nachricht an eine externe URL Ihrer Wahl.
💡 Tipp: Webhooks eignen sich ideal zur Anbindung externer Dienste wie Slack, Make (ehem. Integromat), Zapier oder eigene REST-APIs.
Neuen Webhook erstellen
Folgen Sie diesen Schritten, um einen Webhook in venabo einzurichten:
- Navigieren Sie in venabo zu den Webhook-Einstellungen.
- Klicken Sie auf Neuen Webhook erstellen.
- Füllen Sie die folgenden Felder aus (Details siehe unten).
- Speichern Sie den Webhook mit einem Klick auf Speichern.
Felder im Überblick
| Feld | Beschreibung | Pflicht |
|---|---|---|
| Name | Ein eindeutiger Name zur Identifikation des Webhooks. Beispiel: NeuerBenutzerWebhook |
✅ Ja |
| ObjektTyp | Der Datentyp, der den Webhook auslöst. Mögliche Werte: Abwesenheit, Buchung, Krankheit, Urlaub. | ✅ Ja |
| Aktion | Legt fest, wann der Webhook ausgelöst wird: Anlegen, Aktualisieren oder Löschen. venabo sendet dabei einen POST-Request an die angegebene URL. |
✅ Ja |
| URL | Die Ziel-URL, an die venabo die Daten sendet. Die URL muss öffentlich erreichbar sein. Beispiel: https://mein-service.de/webhook-empfang |
✅ Ja |
| Secret | Ein geheimer Schlüssel zur Signierung der Webhook-Nachricht. Die empfangende Seite kann damit die Echtheit der Anfrage prüfen. | ⬜ Optional |
| Header | Zusätzliche HTTP-Header, falls die Ziel-API diese erfordert. Beispiele: Content-Type: application/json oder Authorization: Bearer |
⬜ Optional |
⚠️ Hinweis: Die Ziel-URL muss öffentlich aus dem Internet erreichbar sein. Lokale Adressen wie localhost oder interne Netzwerkadressen funktionieren nicht.
Praxisbeispiel
Szenario: Sie möchten Ihr Team-Benachrichtigungssystem automatisch informieren, sobald in venabo ein neuer Urlaubsantrag angelegt wird.
| Feld | Eingegebener Wert |
|---|---|
| Name | UrlaubsantragBenachrichtigung |
| ObjektTyp | Urlaub |
| Aktion | Anlegen |
| URL | https://mein-service.de/urlaub-webhook |
| Secret | meinGeheimesPasswort123 |
| Ergebnis | venabo sendet bei jedem neuen Urlaubsantrag automatisch einen POST-Request an die angegebene URL. |
Häufige Fragen
Wozu brauche ich ein Secret?
Das Secret dient der Sicherheit: venabo signiert die ausgehende Nachricht mit diesem Schlüssel. Die empfangende Seite kann anhand der Signatur prüfen, ob die Anfrage wirklich von venabo stammt und nicht von einem Dritten manipuliert wurde. Die Angabe ist optional, wird aber dringend empfohlen.
Kann ich für denselben ObjektTyp mehrere Webhooks anlegen?
Ja. Sie können für denselben ObjektTyp mehrere Webhooks mit unterschiedlichen Aktionen oder Ziel-URLs erstellen – zum Beispiel je einen für „Anlegen“ und „Löschen“.
Was passiert, wenn die Ziel-URL nicht erreichbar ist?
Ist die Ziel-URL zum Zeitpunkt der Auslösung nicht erreichbar, schlägt die Übertragung fehl. Prüfen Sie in diesem Fall, ob die URL korrekt eingetragen und öffentlich zugänglich ist.
Welches HTTP-Verfahren verwendet venabo für Webhooks?
venabo verwendet ausschließlich POST-Requests. Die Nutzlast (Payload) wird im JSON-Format übertragen.
✅ Hinweis: Nach dem Speichern ist der Webhook sofort aktiv. Testen Sie ihn mit einem entsprechenden Ereignis in venabo, um die korrekte Übertragung zu überprüfen.