Webhooks im Überblick
Calendly unterstützt Webhooks über unsere offene API und ermöglicht es Ihnen, Echtzeit-Updates zu erhalten, wenn wichtige Ereignisse in Ihrem Konto auftreten. Verwenden Sie die v2 API, um Ereignisdaten an eine angegebene URL zu senden, wenn jemand ein Meeting plant oder storniert oder ein Weiterleitungsformular absendet.
Zum Beispiel können Sie:
- Aktionen auslösen, wenn ein neues Meeting gebucht wird
- Systeme aktualisieren, wenn ein Ereignis storniert wird
- Daten erfassen, wenn jemand ein Weiterleitungsformular absendet (auch wenn kein Ereignis gebucht wird)
Bevor Sie beginnen
- Sie benötigen entweder Zugriff auf personal access token oder eine OAuth application zur Authentifizierung.
- Stellen Sie sicher, dass Ihr Endpunkt bereit ist, Webhook-Daten zu empfangen und zu verarbeiten.
- Sehen Sie sich die Calendly API-Anwendungsfälle für weitere Ideen und Beispiele an.
Webhook-Ereignistypen
Calendly unterstützt die folgenden Webhook-Abonnements:
- Von eingeladenen Personen erstellte Ereignisse — wenn ein neues Ereignis geplant wird
- Von eingeladenen Personen stornierte Ereignisse — wenn ein bestehendes Ereignis storniert wird
- Weiterleitungsformular-Übermittlungen — wenn jemand ein Weiterleitungsformular absendet (mit oder ohne Buchung)
Webhook erstellen
Befolgen Sie die Schritte im Developer Portal.
Sobald Sie ein Webhook-Abonnement erstellt haben, sendet Calendly Ereignisdaten an den von Ihnen angegebenen Endpunkt, wenn neue Aktivitäten auftreten.
Um Ihren Webhook zu testen, lösen Sie ein neues Ereignis aus (z. B. eine Buchung, Stornierung oder Umbuchung). Webhooks werden nicht durch vergangene Ereignisse ausgelöst.
Sehen Sie sich Beispiel-Daten in unserer Webhook-Payload-Dokumentation an. Webhook löschen
Um einen Webhook zu entfernen, besuchen Sie unseren Leitfaden zum Löschen von Webhook-Abonnements.
Beste Vorgehensweisen
Für Entwickler:
- Verwenden Sie sichere HTTPS-URLs für Ihre Webhook-Endpunkte.
- Validieren Sie eingehende Webhook-Signaturen für zusätzliche Sicherheit.
- Handhaben Sie Wiederholungsversuche und vermeiden Sie doppelte Verarbeitung, indem Sie Ereignis-IDs überprüfen.
Für Admins:
- Überwachen Sie, wer Webhook-Abonnements erstellt hat.
- Wenn ein Benutzer, der Webhooks erstellt hat, aus Ihrer Organisation entfernt wird, bleiben seine Webhooks aktiv, bis sie manuell gelöscht werden.