Aktiviere in „Features & Integrations“ (Funktionen & Integrationen) das Feature „Webhooks“ und klicke auf „Set Up“ (Einrichten). Auf der Seite gibt es noch keine Webhooks.
Webhooks einrichten
Lesezeit etwa 2 Minuten.
Das brauchst du
- Eine Anwendung mit URL, die Webhook-Anfragen (POST) empfangen kann
Schritt für Schritt
-
Webhooks aktivieren
-
Webhook anlegen
Klicke oben rechts auf „Create Webhook“ (Webhook erstellen) und wähle den Typ. Der Typ bestimmt das Ereignis, das den Webhook auslöst:
- „Appointment Booked“ (Termin gebucht)
- „Appointment Canceled“ (Termin storniert)
- „Appointment has been rescheduled“ (Termin wurde verschoben)
- „Appointment status has been changed“ (Terminstatus wurde geändert)
- „Customer Created“ (Kunde angelegt)
Pro Typ kannst du aktuell nur einen Webhook anlegen.
Trage ein:
- „Name“: eine Bezeichnung zur Wiedererkennung.
- „Website URL“ (Website-URL): die Adresse deiner Anwendung, an die BOOKING die Daten sendet.
-
Webhook testen
Mit „Send Test Webhook“ (Test-Webhook senden) sendet BOOKING Beispieldaten an die URL, damit du siehst, was ankommt. Die Daten werden per POST-Anfrage übertragen und nach den Einstellungen in BOOKING formatiert. Enthalten sind: Terminstatus; Start- und Enddatum, -zeit und -datum mit Uhrzeit; Terminpreis; Kunde (vollständiger Name, Vor- und Nachname, E-Mail, Telefon); Mitarbeiter (vollständiger Name, Vor- und Nachname, E-Mail, Telefon); Leistungskategorie, -name, -dauer und -preis; Extras; Standortname, -adresse und -telefon; „Custom Fields“ (eigene Felder).
-
Anfragen mit dem Verification Token prüfen
Klicke neben „Create Webhook“ auf „Verification Token“ (Verifizierungstoken). Im Fenster siehst du den Token und kannst ihn kopieren. BOOKING sendet ihn im
Authorization-Header jeder Webhook-Anfrage mit. So prüfst du in deiner Anwendung, dass die Daten wirklich von BOOKING kommen.
Hat dir das geholfen?