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:

🛠️ Webhook nicht erhalten oder verspätet?

Richtige Buchungsseite: Jede Buchungsseite verfügt über eine eigene Webhook-URL. Vergewissern Sie sich, dass diese auf der Seite, auf der die Buchung eingegangen ist, eingestellt ist und dass Sie die Seite gespeichert haben.
Vollständige URL: Geben Sie die vollständige Adresse ein, beginnend mit https:// . Eine ungültige URL wird ignoriert.
Reagieren Sie schnell: Ihr Endpunkt sollte einen BEITRAG mit einem JSON-Body und antworte mit einem 2xx Status. Wenn es zu einer Zeitüberschreitung kommt oder ein Fehler zurückgegeben wird, versucht Koalendar es später erneut, sodass der Webhook verspätet eintrifft.
Nichts blockiert den Zugriff: Stellen Sie sicher, dass keine Anmeldung, keine Firewall und kein IP-Filter Anfragen an Ihren Endpunkt blockieren.
Testen Sie die Übermittlung: Fügen Sie eine temporäre URL aus einem Tool wie webhook.site ein, nehmen Sie eine Testbuchung vor und überprüfen Sie, ob die Anfrage ankommt.

ℹ️ 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.