Calendly prend en charge les webhooks via notre API ouverte, ce qui vous permet 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 à une URL spécifiée lorsque quelqu'un 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 lorsque quelqu'un soumet un formulaire d'acheminement (même si aucun événement n'est réservé)
Avant de commencer
- Vous aurez besoin d'un jeton d'accès personnel ou d'une application OAuth pour l'authentification.
- Assurez-vous que votre point de terminaison est prêt à recevoir et à traiter les données de webhook.
- Consultez les exemples d'utilisation de l'API Calendly pour plus d'idées et d'exemples.
Types d'événements webhook
Calendly prend en charge les abonnements Webhook suivants :
- Événements créés pour un invité — lorsqu'un nouvel événement est planifié
- Événements annulés par l'invité — lorsqu'un événement existant est annulé
- Soumissions de formulaire d'acheminement — lorsque quelqu'un soumet un formulaire d'acheminement (avec ou sans réservation)
Créer un webhook
Suivez les étapes indiquées dans notre Portail du développeur.
Une fois que vous avez créé votre abonnement webhook, Calendly envoie les données d'événement au point de terminaison que vous avez indiqué. Affichez des exemples de données dans notre documentation sur les charges utiles des webhooks.
Supprimer un webhook
Pour supprimer un webhook, consultez notre guide Supprimer un abonnement à un webhook.
Meilleures pratiques
Pour les développeurs :
- Utilisez des URL HTTPS sécurisées pour vos points de terminaison webhook.
- Validez les signatures de webhook entrantes pour plus de sécurité.
- Gérez les nouvelles tentatives et évitez les doubles traitements en vérifiant les identifiants d'événement.
Pour les administrateurs :
- Surveillez qui a créé des abonnements par webhook.
- Si un utilisateur qui a créé des webhooks est supprimé de votre organisation, ses webhooks restent actifs jusqu'à ce qu'ils soient supprimés manuellement.