Calendly

Ce que ca fait

Calendly envoie les événements de rendez-vous en temps réel vers DURUM.ai. Chaque type d'événement Calendly est mappe à un type dans DURUM.ai.

Événement Calendly	Type dans DURUM.ai	Quand
invitee.created	Booking	Un prospect réservé un creneau
invitee.canceled	Annulation	Le prospect annule son rendez-vous
invitee.no_show	No-show	Le prospect ne se présente pas

Configuration étape par étape

Option A : Via le portail développeur Calendly (recommandee)

1. Connectez-vous à votre compte Calendly
2. Allez sur https://developer.calendly.com/ (ou dans votre profil Calendly, section Intégrations puis API & Webhooks)
3. Cliquez sur Webhooks dans le menu latéral
4. Cliquez sur Create Webhook Subscription

Vous devez créer 3 subscriptions (une par type d'événement) :

Subscription 1 : Bookings et annulations

5. Dans le champ Callback URL, entrez :

   https://app.durum.ai/api/webhook/booking?client_key=VOTRE_CLE

6. Dans Events, sélectionnez :
   • invitee.created
   • invitee.canceled
7. Cliquez sur Create Webhook Subscription

Subscription 2 : No-shows

8. Cliquez sur Create Webhook Subscription à nouveau
9. Dans le champ Callback URL, entrez :

   https://app.durum.ai/api/webhook/no-show?client_key=VOTRE_CLE

10. Dans Events, sélectionnez :
    • invitee.no_show
11. Cliquez sur Create Webhook Subscription

Option B : Via l'interface Calendly (si disponible)

1. Connectez-vous a Calendly
2. Allez dans Intégrations depuis le menu latéral
3. Cherchez la section Webhooks
4. Ajoutez les mêmes URLs et événements que dans l'Option A

Comment tester

1. Créez un rendez-vous de test sur votre lien Calendly (utilisez un email de test)
2. Attendez 30 secondes
3. Dans DURUM.ai, allez dans Logs Data
4. Vous devriez voir un événement booking avec le statut success
5. Annulez le rendez-vous de test dans Calendly
6. Vérifiez qu'un événement booking_cancel apparaît dans les logs

Dépannage Calendly

Problème	Solution
L'événement n'apparaît pas	Vérifiez que la subscription est active dans le portail développeur Calendly
Erreur 401	Vérifiez que le client_key dans l'URL est correct
Doublons	DURUM.ai géré automatiquement la déduplication via l'URI Calendly. Pas d'action requise.
Les no-shows n'apparaissent pas	Vérifiez que vous avez créé une subscription séparée pour invitee.no_show

TIP

Les bookings et les annulations utilisent la même URL (/api/webhook/booking). DURUM.ai détecté automatiquement s'il s'agit d'une création ou d'une annulation grace au type d'événement Calendly (invitee.created vs invitee.canceled).

---