Calendly unterstützt Webhooks über unsere offene API, sodass Sie Echtzeit-Updates 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 absagt oder ein Weiterleitungsformular absendet.
Sie können beispielsweise:
- Aktionen auslösen, wenn ein neues Meeting gebucht wird
- Systeme aktualisieren, wenn ein Ereignis abgesagt wird
- Daten erfassen, wenn jemand ein Weiterleitungsformular sendet (auch, wenn kein Ereignis gebucht wurde)
Bevor Sie beginnen
- Sie benötigen entweder Zugriff auf ein persönliches Zugriffstoken oder eine OAuth-Anwendung zur Authentifizierung.
- Stellen Sie sicher, dass Ihr Endpunkt zum Empfangen und Verarbeiten von Webhook-Daten bereit ist.
- Sehen Sie sich Beispiele für die Verwendung der Calendly API an, um weitere Ideen und Beispiele zu erhalten.
Webhook-Ereignistypen
Calendly unterstützt die folgenden Webhook-Abonnements:
- Von eingeladenen Personen erstellte Ereignisse – wenn ein neues Ereignis geplant ist
- Von eingeladenen Personen abgesagte Ereignisse – wenn ein vorhandenes Ereignis abgesagt wird
- Übermittlungen von Weiterleitungsformularen – wenn jemand ein Weiterleitungsformular (mit oder ohne Buchung) absendet
Webhook erstellen
Befolgen Sie die Schritte in unserem Entwickler-Portal.
Sobald Sie Ihr Webhookabonnement erstellt haben, sendet Calendly Ereignisdaten an den von Ihnen angegebenen Endpoint. Beispieldaten finden Sie in unserer Webhook-Payload-Dokumentation.
Einen Webhook Löschen
Um ein Webhook zu entfernen, besuchen Sie unseren Leitfaden zum Löschen des Webhookabonnements.
Empfohlene Vorgehensweisen
Für Entwickler:
- Verwenden Sie sichere, HTTPS-Links für Ihre Webhook-Endpunkte.
- Validieren Sie eingehende Webhook-Signaturen für zusätzliche Sicherheit.
- Bearbeiten Sie Wiederholungen und vermeiden Sie Doppelverarbeitung, indem Sie Ereignis-IDs überprüfen.
Für Admins:
- Überwachen, wer Webhook-Anmeldungen erstellt hat.
- Wenn ein Benutzer, der Webhooks erstellt hat, aus Ihrer Organisation entfernt wird, bleiben seine Webhooks aktiv, bis sie manuell gelöscht werden.