Webhooks im Überblick

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.