So richten Sie Webhooks in Koalendar ein

Verwenden Sie Webhooks, um Echtzeit-Updates zu erhalten – POST-Anfragen werden gesendet, wenn jemand einen Termin auf Ihrer Buchungsseite plant, verschiebt oder storniert.

Dies ist nützlich, wenn Sie benutzerdefinierte Automatisierungen mit Plattformen wie Zapier, Make (Integromat), n8n oder Ihrem eigenen Backend-Code erstellen.

Schritt 1: Erstellen Sie Ihren Webhook-Endpunkt

Öffnen Sie Ihren Buchungsseiten-Editor.
Scrollen Sie zum Abschnitt „Nach der Buchung “.
Geben Sie Ihren Webhook -URL-Endpunkt ein (das Ziel für POST-Anfragen).

Schritt 2: Testen und automatisieren

Führen Sie eine Testbuchung durch, verschieben Sie einen Termin oder stornieren Sie eine Buchung, um einen Webhook auszulösen.
Überprüfen Sie Ihre Serverprotokolle oder Ihr Webhook-Tool, um den Empfang des POST zu bestätigen.
Jede Nutzlast umfasst:
- Veranstaltungstyp:
  - Ereignis erstellt – wenn jemand einen Termin bucht
  - Veranstaltung.vorläufig – wenn jemand eine vorläufige Buchung vornimmt
  - Veranstaltung verschoben – wenn ein Eingeladener die Buchungszeit ändert
  - Veranstaltung.abgesagt – wenn ein Eingeladener seinen Termin absagt
- Buchungsdetails (Name, E-Mail-Adresse, Ort, Startzeit, Endzeit usw.)
- Der Eingeladene antwortet über Einladungsfelder —mit Fragen-IDs und Werten

Sie können dies verwenden, um:

E-Mails oder interne Benachrichtigungen auslösen
Aktualisieren Sie Ihr CRM oder Ihre Datenbank
Daten über Zapier oder benutzerdefinierte Logik zwischen Apps synchronisieren

Beispiel für Nutzlast

Das Feld„invitee.fields“enthält die Antworten auf die Fragen, die Sie in Ihrem Buchungsformular stellen.

Der Schlüssel des Objekts ist dieFrage-ID, die Sie beim Bearbeiten einer Frage (oben) finden können:

ℹ️ Häufig gestellte Fragen

Welche Ereignisse lösen einen Webhook aus?

Ereignis erstellt , Veranstaltung.vorläufig , Veranstaltung verschoben und Veranstaltung.abgesagt

Kann ich Zapier mit Webhooks verwenden?

Ja! Webhooks können verwendet werden, um Zapier-Aktionen oder jede andere Integrationsplattform auszulösen, die POST-Anfragen akzeptiert. Lesen Sie unseren Zapier-Leitfaden.

Was passiert, wenn mein Webhook fehlschlägt?

Koalendar versucht es erneut, wenn Ihr Endpunkt vorübergehend nicht erreichbar ist oder einen Fehler zurückgibt.

Kann ich meinen Webhook später aktualisieren oder entfernen?

Ja. Kehren Sie einfach zu den Webhook-Einstellungen in Ihrem Buchungsseiten-Editor zurück.