Webhook

Ein Webhook ist ein nicht-standardisiertes Verfahren zur automatischen Kommunikation zwischen Webservices. Technisch ist ein Webhook eine HTTP-POST-Anfrage, die automatisch an eine vordefinierte URL gesendet wird, sobald ein bestimmtes Ereignis eintritt.

Funktionsweise:

1. Der Betreiber konfiguriert eine Empfänger-URL (z. B. ein eigenes System oder Zapier/Make)
2. Bei einem Buchungsereignis (neue Buchung, Änderung, Absage) sendet das Terminbuchungssystem automatisch eine POST-Anfrage mit den Buchungsdaten (typischerweise als JSON)
3. Das empfangende System verarbeitet die Daten und kann darauf reagieren

Unterstützte Ereignistypen:

• Neue Buchung (new_appointment)
• Stornierte Buchung (cancelled_appointment)
• Verschobene/geänderte Buchung (rescheduled_appointment)

Sicherheit:

• Optionaler geheimer Schlüssel (Secret Key), der im HTTP-Header X-Schedule-Organizer-Secret mitgesendet wird
• Der Ereignistyp wird im Header X-Schedule-Organizer-Event übermittelt
• Der Empfänger-Endpunkt muss mit HTTP 200 antworten

Anwendungsfälle:

• Automatische Übernahme von Buchungen in ein CRM-System
• Trigger für Automatisierungen in Zapier, Make (früher Integromat) oder n8n
• Echtzeit-Synchronisation mit eigenen Backendsystemen
• Benachrichtigungen in Slack oder Teams