Hilfe-Center

Webhooks einrichten

Lesezeit etwa 2 Minuten.

Kurz gesagt: Mit Webhooks sendet BOOKING Termin- und Kundendaten automatisch an eine URL deiner Wahl, sobald etwas passiert, zum Beispiel eine Buchung oder Stornierung.

Das brauchst du

  • Eine Anwendung mit URL, die Webhook-Anfragen (POST) empfangen kann

Schritt für Schritt

  1. Webhooks aktivieren

    Aktiviere in „Features & Integrations“ (Funktionen & Integrationen) das Feature „Webhooks“ und klicke auf „Set Up“ (Einrichten). Auf der Seite gibt es noch keine Webhooks.

  2. 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.
  3. 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).

  4. 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?