Vue d'ensemble des webhooks
Calendly prend en charge les Webhooks via notre API ouverte, vous permettant de recevoir des mises à jour en temps réel lorsque des événements clés se produisent dans votre Compte. Utilisez l'API v2 pour envoyer des données d'événement vers une URL spécifiée lorsqu'une personne planifie ou annule une Réunion, ou soumet un formulaire d'acheminement.
Par exemple, vous pouvez :
- Déclencher des actions lorsqu'une nouvelle Réunion est réservée
- Mettre à jour les systèmes lorsqu'un Événement est annulé
- Capturer des données lorsqu'une personne soumet un formulaire d'acheminement (même si aucun Événement n'est réservé)
Avant de commencer
- Vous aurez besoin d'un personal access token ou d'une OAuth application pour l'authentification.
- Assurez-vous que votre endpoint est prêt à recevoir et à traiter les données Webhooks.
- Consultez les Cas d'utilisation de l'API Calendly pour plus d'idées et d'exemples.
Types d'événements Webhooks
Calendly prend en charge les abonnements Webhooks suivants :
- Invitee Created Events — lorsqu'un nouvel Événement est planifié
- Invitee Canceled Events — lorsqu'un Événement existant est annulé
- Routing Form Submissions — lorsqu'une personne soumet un formulaire d'acheminement (avec ou sans réservation)
Créer un Webhook
Suivez les étapes indiquées dans notre Developer Portal.
Une fois que vous avez créé un abonnement Webhook, Calendly envoie les données d'événement à l'endpoint que vous spécifiez lorsque de nouvelles activités se produisent.
Pour tester votre Webhook, déclenchez un nouvel événement (par exemple une réservation, une annulation ou une reprogrammation). Les Webhooks ne sont pas déclenchés par des événements passés.
Consultez des données d'exemple dans notre Webhook Payload documentation. Supprimer un Webhook
Pour supprimer un Webhook, consultez notre Delete Webhook Subscription guide.
Meilleures pratiques
Pour les développeurs :
- Utilisez des URL HTTPS sécurisées pour vos endpoints Webhook.
- Validez les signatures des Webhooks entrants pour plus de sécurité.
- Gérez les nouvelles tentatives et évitez le traitement en double en vérifiant les ID d'événement.
Pour les administrateurs :
- Surveillez qui a créé des abonnements Webhooks.
- Si un utilisateur qui a créé des Webhooks est supprimé de votre organisation, ses Webhooks restent actifs jusqu'à suppression manuelle.