Calendly

Ce que ca fait

Calendly envoie les evenements de rendez-vous en temps reel vers DURUM.ai. Chaque type d'evenement Calendly est mappe a un type dans DURUM.ai.

Evenement Calendly	Type dans DURUM.ai	Quand
invitee.created	Booking	Un prospect reserve un creneau
invitee.canceled	Annulation	Le prospect annule son rendez-vous
invitee.no_show	No-show	Le prospect ne se presente pas

Configuration etape par etape

Option A : Via le portail developpeur Calendly (recommandee)

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

Vous devez creer 3 subscriptions (une par type d'evenement) :

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, selectionnez :
   • invitee.created
   • invitee.canceled
7. Cliquez sur Create Webhook Subscription

Subscription 2 : No-shows

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

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

10. Dans Events, selectionnez :
    • 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 Integrations depuis le menu lateral
3. Cherchez la section Webhooks
4. Ajoutez les memes URLs et evenements que dans l'Option A

Comment tester

1. Creez 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 evenement booking avec le statut success
5. Annulez le rendez-vous de test dans Calendly
6. Verifiez qu'un evenement booking_cancel apparait dans les logs

Depannage Calendly

Probleme	Solution
L'evenement n'apparait pas	Verifiez que la subscription est active dans le portail developpeur Calendly
Erreur 401	Verifiez que le client_key dans l'URL est correct
Doublons	DURUM.ai gere automatiquement la deduplication via l'URI Calendly. Pas d'action requise.
Les no-shows n'apparaissent pas	Verifiez que vous avez cree une subscription separee pour invitee.no_show

TIP

Les bookings et les annulations utilisent la meme URL (/api/webhook/booking). DURUM.ai detecte automatiquement s'il s'agit d'une creation ou d'une annulation grace au type d'evenement Calendly (invitee.created vs invitee.canceled).

---