Wie konfiguriere ich Webhooks in Calenso?

INHALTSVERZEICHNIS

• Voraussetzungen
• Einrichtung

Voraussetzungen

• Die Verwendung von Webhooks ist in den Abonnements Whitelabel und Enterprise möglich.
• Ein System, welches Webhooks als POST Aufruf entgegennehmen kann.

Einrichtung

• https://dashboard.calenso.com/app/settings/webhooks aufrufen
• "Webhooks aktivieren" Button anklicken
• Über das "Plus"-Symbol" können neue Webhook-Endpunkte hinzugefügt werden

Anschliessend die URL des Webhook Endpunktes angeben.

Es ist nun in Calenso möglich mehrere Endpunkte zu definieren.

Wenn das System abgesichert ist, kann ein Authorization Header konfiguriert werden. Klicke dafür auf "Define Authorization Header Key" um den Key zu definieren. Ein möglicher Wert wäre "Authorization" oder "Ocp-Apim-Subscription-Key".

Dasselbe kannst du mit dem Authorization Header Value machen.

Es kann definiert werden, ob die JSON-Datei an eine bestimmte Email-Adresse gesendet werden soll. Wenn diese hinterlegt wurde, wird allerdings kein Request mehr auf den oben definierten Endpoint gemacht.

Was Es können mehrere Webhook-Ereignistypen definiert werden.

Ebenfalls kann definiert werden, dass die JSON-Datei, welche die Webhook-Daten übergibt, auf nur eine Hierarchie beschränkt sein soll.

Wenn nun ein Kunde einen Termin bucht oder an einem Event teilnimmt, dann wird automatisch ein Webhook-Request an die konfigurierte URL versendet. Neben jedem Endpunkt findest Du die dazugehörige Statistik. Sie gibt dir Informationen darüber, ob die Requests vom Server akzeptiert wurden oder nicht (Statuscode 2xx).

Detailliertere Informationen (inkl. Payload der Requests) findest du weiter unten.

Wähle dazu zunächst den gewünschten Endpunkt aus.

Hinter dem jeweiligen Zeitstempel siehst Du anhand des Status und des HTTP Codes, ob der Aufruf erfolgreich war.

Unter "Aktionen" kannst Du Dir mit "Raw" die Rohdaten anzeigen lassen, diese herunterladen oder den Webhook erneut anstossen.

Mehrfach angestossene Webhooks erhalten ein entsprechendes Label.

Wenn du den Payload des Requests anschauen möchtest, dann klicke auf "Raw". Dort kannst du den JSON Payload genauer untersuchen:

Mehr Details zu Webhooks findest Du auch in unserer Dokumentation.

Bei Fragen zur Einrichtung von Webhooks darfst du uns gerne im Support kontaktieren! Viel Erfolg!