Calendly

Ce que ça fait

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

Événement Calendly	Type dans DURUM.ai	Quand
invitee.created	Booking	Un prospect réserve un créneau
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 (recommandée)

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 à 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ère 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étecte automatiquement s'il s'agit d'une création ou d'une annulation grâce au type d'événement Calendly (invitee.created vs invitee.canceled).

---