Integrations

DURUM.ai se connecte a vos outils existants pour centraliser automatiquement toutes vos donnees marketing et ventes. Cette page explique chaque integration en detail et vous guide etape par etape pour configurer les webhooks vous-meme.

---

Vue d'ensemble

Integration	Ce qu'elle fait	Configuration
Meta Ads	Synchronise vos depenses publicitaires chaque heure	Connectez dans Integrations (1 clic)
GHL (GoHighLevel)	Envoie les leads, applications, bookings et ventes en temps reel	Connectez dans Integrations ou configurez les workflows
Pipedrive	Envoie les leads, ventes et meetings en temps reel	Connectez dans Integrations (OAuth)
Calendly	Envoie les bookings, annulations et no-shows en temps reel	Connectez dans Integrations (OAuth)
Typeform	Envoie les leads et applications en temps reel	Connectez dans Integrations puis mappez les formulaires
Stripe	Envoie les paiements, ventes et remboursements en temps reel	Connectez dans Integrations (cle API)
Zoho CRM	Envoie les ventes (deals gagnes/perdus) en temps reel	Webhooks manuels a configurer (guide)
Zoho Books	Envoie les paiements et factures en temps reel	Webhooks manuels a configurer (guide)
Google Calendar	Synchronise le calendrier de vos reps pour le suivi des meetings	Chaque rep connecte dans son Profil
Microsoft Outlook	Meme chose que Google Calendar, pour les utilisateurs Outlook	Chaque rep connecte dans son Profil
Slack	Recoit les rapports automatiques, alertes et analyses d'appels	Configure dans la page Notifications

Integrations natives vs webhooks manuels

La majorite des integrations se connectent directement depuis la page Integrations dans l'app (1 ou 2 clics). Seuls Zoho CRM et QuickBooks necessitent une configuration manuelle de webhooks. Consultez le guide de chaque integration pour les details.

---

Comment les donnees arrivent dans DURUM.ai

Il y a deux facons dont les donnees entrent dans la plateforme :

1. Webhooks (temps reel)

Un webhook est une notification automatique envoyee par un outil externe vers DURUM.ai au moment ou un evenement se produit. Par exemple :

• Un prospect remplit un formulaire Typeform -- DURUM.ai recoit le lead instantanement
• Un prospect reserve un rendez-vous sur Calendly -- DURUM.ai recoit le booking instantanement
• Une vente est conclue dans Zoho CRM -- DURUM.ai recoit la vente instantanement

Les webhooks sont la methode principale pour tous les evenements CRM (leads, applications, bookings, no-shows, ventes, paiements, remboursements).

2. Synchronisation periodique (enrichissement)

Certaines donnees sont synchronisees periodiquement par API :

Donnee	Frequence	Source
Depenses publicitaires	Chaque heure	Meta Ads API
Contacts et opportunites	Toutes les 15 minutes	GHL API
Monitoring calendrier	Toutes les 15 minutes	Calendly API

INFO

La synchronisation periodique sert a enrichir les donnees, pas a les creer. Tous les evenements (leads, bookings, ventes) arrivent par webhooks en temps reel. Les API syncs ajoutent des informations supplementaires comme les tags de contact, les details d'opportunite, etc.

---

Comment trouver votre client_key

Votre client_key est un identifiant unique attribue a votre compte. Il est utilise dans toutes les URLs de webhook pour identifier vos donnees.

Pour trouver votre client_key :

1. Connectez-vous a app.durum.ai
2. Allez dans Profil (menu lateral → Profil)
3. Votre cle client est affichee dans la section "Cle client (API & Integrations)" avec un bouton Copier
4. Collez cette cle dans vos URLs webhook : ?client_key=VOTRE_CLE

TIP

Votre cle client est toujours visible dans votre page Profil. Vous n'avez pas besoin de la demander a votre gestionnaire.

---

Tableau recapitulatif des URLs webhook

Toutes les URLs webhook suivent le format :

https://app.durum.ai/api/webhook/{type}?client_key={votre_cle}

Type d'evenement	URL webhook	Methode	Sources supportees
Lead (nouveau contact)	https://app.durum.ai/api/webhook/lead?client_key=VOTRE_CLE	POST	GHL, Typeform, generique
Application (formulaire qualifie)	https://app.durum.ai/api/webhook/application?client_key=VOTRE_CLE	POST	GHL, Typeform, generique
Booking (rendez-vous reserve)	https://app.durum.ai/api/webhook/booking?client_key=VOTRE_CLE	POST	Calendly, GHL
No-show (absence)	https://app.durum.ai/api/webhook/no-show?client_key=VOTRE_CLE	POST	Calendly, GHL
Vente (deal gagne/perdu)	https://app.durum.ai/api/webhook/sale?client_key=VOTRE_CLE	POST	Zoho CRM, GHL, Stripe
Paiement (facture payee)	https://app.durum.ai/api/webhook/payment?client_key=VOTRE_CLE	POST	Zoho Books, Stripe
Remboursement	https://app.durum.ai/api/webhook/refund	POST	Stripe uniquement

TIP

Pour les sources GHL, ajoutez toujours &source=ghl a la fin de l'URL. Exemple : https://app.durum.ai/api/webhook/lead?client_key=VOTRE_CLE&source=ghl

---

Meta Ads

Ce que ca fait

Meta Ads est synchronise automatiquement par l'agence. Les donnees suivantes sont importees :

• Depenses quotidiennes par publicite (spend, clics, impressions, reach)
• Metadonnees des campagnes, adsets et publicites (noms, statuts, objectifs)

Frequence

• Chaque heure : les 3 derniers jours de depenses sont resynchronises
• Chaque nuit : les agregats mensuels sont recalcules

Configuration

La connexion Meta Ads est geree entierement par l'agence. Vous n'avez rien a configurer. Si vos depenses n'apparaissent pas, contactez votre gestionnaire de compte.

---

GHL (GoHighLevel)

Ce que ca fait

GHL envoie les evenements CRM en temps reel vers DURUM.ai via des Workflows. Chaque evenement est automatiquement associe a votre compte grace a votre client_key.

Evenement GHL	Type dans DURUM.ai	Quand
Contact cree	Lead	Nouveau contact dans votre CRM
Formulaire soumis	Application	Le prospect remplit un formulaire de qualification
Rendez-vous cree	Booking	Un rendez-vous est reserve
Rendez-vous no-show	No-show	Le prospect ne se presente pas
Opportunite gagnee	Vente	Un deal est marque comme gagne

Configuration etape par etape

Vous devez creer un Workflow GHL par type d'evenement. Voici les etapes detaillees pour chaque.

Workflow 1 : Lead (nouveau contact)

1. Connectez-vous a votre compte GHL
2. Dans le menu lateral, allez dans Automation puis Workflows
3. Cliquez sur Create Workflow (ou Creer un workflow)
4. Choisissez Start from Scratch (commencer a partir de zero)
5. Nommez le workflow : DURUM - Lead
6. Configurer le declencheur (Trigger) :
   • Cliquez sur Add New Trigger
   • Selectionnez Contact Created
   • Cliquez sur Save Trigger
7. Ajouter l'action webhook :
   • Cliquez sur le + sous le trigger
   • Cherchez et selectionnez Webhook
   • Dans le champ URL, entrez :

     https://app.durum.ai/api/webhook/lead?client_key=VOTRE_CLE&source=ghl

   • Methode : POST
   • Laissez le body par defaut (GHL envoie automatiquement les donnees du contact)
   • Cliquez sur Save Action
8. Activez le workflow en cliquant sur le toggle Publish (en haut a droite)

Workflow 2 : Application (formulaire soumis)

1. Creez un nouveau workflow : Create Workflow puis Start from Scratch
2. Nommez-le : DURUM - Application
3. Trigger : selectionnez Form Submitted (ou Survey Submitted selon votre configuration)
   • Selectionnez le ou les formulaires concernes
4. Action : ajoutez un Webhook
   • URL :

     https://app.durum.ai/api/webhook/application?client_key=VOTRE_CLE&source=ghl

   • Methode : POST
5. Activez le workflow

Workflow 3 : Booking (rendez-vous cree)

1. Creez un nouveau workflow : DURUM - Booking
2. Trigger : selectionnez Appointment Status Changed
   • Filtrez sur le statut Booked (ou Confirmed)
3. Action : ajoutez un Webhook
   • URL :

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

   • Methode : POST
4. Activez le workflow

Workflow 4 : No-show (absence au rendez-vous)

1. Creez un nouveau workflow : DURUM - No-Show
2. Trigger : selectionnez Appointment Status Changed
   • Filtrez sur le statut No Show
3. Action : ajoutez un Webhook
   • URL :

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

   • Methode : POST
4. Activez le workflow

Workflow 5 : Vente (opportunite gagnee)

1. Creez un nouveau workflow : DURUM - Vente
2. Trigger : selectionnez Opportunity Status Changed
   • Filtrez sur le statut Won
3. Action : ajoutez un Webhook
   • URL :

     https://app.durum.ai/api/webhook/sale?client_key=VOTRE_CLE&source=ghl

   • Methode : POST
4. Activez le workflow

Comment tester

1. Creez un contact de test dans GHL (utilisez un email facilement identifiable, par exemple test@votredomaine.com)
2. Le workflow devrait se declencher automatiquement
3. Attendez 30 secondes puis allez dans DURUM.ai, page Logs Data
4. Vous devriez voir l'evenement apparaitre avec le statut success ou queued
5. Supprimez le contact de test dans GHL apres verification

Depannage GHL

Probleme	Solution
L'evenement n'apparait pas dans Logs Data	Verifiez que le workflow est Publish (actif). Verifiez l'URL (pas d'espace, client_key correct)
Statut quarantined dans les logs	Le formulaire n'est pas encore reconnu. Normal pour un nouveau formulaire. L'agence le categorisera.
Erreur 401 dans les logs GHL	Verifiez que &source=ghl est present dans l'URL
Erreur 429 (Too Many Requests)	Trop de webhooks en meme temps. Contactez l'agence.

Formulaires inconnus et quarantaine

Si un formulaire GHL envoie des donnees mais n'est pas encore reconnu par DURUM.ai, l'evenement est mis en quarantaine automatiquement. L'agence le categorisera dans la page Matching, et les prochains evenements de ce formulaire seront automatiquement reconnus. Vous n'avez rien a faire.

---

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).

---

Typeform

Ce que ca fait

Typeform envoie les soumissions de formulaires en temps reel vers DURUM.ai. Selon le formulaire, la soumission sera classifiee comme lead (premier contact) ou application (formulaire de qualification).

Configuration etape par etape

1. Connectez-vous a votre compte Typeform
2. Ouvrez le formulaire que vous souhaitez connecter
3. Cliquez sur Connect dans le menu du haut
4. Selectionnez Webhooks dans la liste des integrations
5. Cliquez sur Add a webhook
6. Dans le champ URL, entrez :
   • Pour un formulaire de premier contact (lead) :

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

   • Pour un formulaire de qualification (application) :

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

7. Cliquez sur Save
8. Activez le webhook avec le toggle ON

Configuration des hidden fields (important pour le suivi UTM)

Pour que DURUM.ai puisse attribuer chaque soumission a la bonne campagne publicitaire, configurez des hidden fields dans votre formulaire Typeform :

1. Dans Typeform, ouvrez votre formulaire en mode edition
2. Cliquez sur Logic dans le menu lateral
3. Selectionnez Hidden Fields
4. Ajoutez les champs suivants :
   • client_key -- votre identifiant client
   • utm_source -- la source du trafic (ex: facebook, google)
   • utm_campaign -- le nom de la campagne
   • utm_content -- le nom de la publicite
   • utm_term -- le terme de recherche (optionnel)
5. Dans vos publicites Meta, ajoutez ces parametres a l'URL du formulaire Typeform :

   https://votre-formulaire.typeform.com/to/XXXXX#client_key=VOTRE_CLE&utm_source=facebook&utm_campaign={{campaign.name}}&utm_content={{ad.name}}

WARNING

Sans les hidden fields UTM, DURUM.ai recevra la soumission mais ne pourra pas l'attribuer a une campagne specifique. Le lead sera quand meme enregistre, mais sans attribution publicitaire.

Comment tester

1. Ouvrez votre formulaire Typeform dans un navigateur
2. Remplissez une soumission de test (utilisez un email facilement identifiable)
3. Attendez 30 secondes
4. Dans DURUM.ai, allez dans Logs Data
5. Verifiez que l'evenement apparait avec le bon type (lead ou application)

Depannage Typeform

Probleme	Solution
L'evenement n'apparait pas	Verifiez que le webhook est active (toggle ON) dans Typeform
Statut quarantined	Le formulaire n'est pas encore reconnu. L'agence le categorisera automatiquement.
client_key=unknown dans les logs	Le client_key n'est pas present dans l'URL ou les hidden fields
Pas d'attribution aux campagnes	Verifiez que les hidden fields UTM sont configures et passes dans l'URL

Identification automatique

Si un formulaire Typeform est nouveau et que le client_key n'est pas dans l'URL, DURUM.ai tente de l'identifier via sa base de formulaires connus. Si le formulaire est inconnu, il est mis en quarantaine et l'agence le mappe a votre compte. Les soumissions suivantes seront automatiquement reconnues.

---

Zoho CRM

Ce que ca fait

Zoho CRM envoie les changements de statut des deals en temps reel vers DURUM.ai.

Evenement Zoho CRM	Type dans DURUM.ai	Quand
Deal gagne (Closed Won)	Vente	Un deal est marque comme gagne
Deal perdu (Closed Lost)	Vente perdue	Un deal est marque comme perdu

Configuration etape par etape

1. Connectez-vous a votre compte Zoho CRM
2. Cliquez sur l'icone Engrenage (en haut a droite) pour acceder aux Settings (Parametres)
3. Dans la section Automation, cliquez sur Actions
4. Selectionnez l'onglet Webhooks
5. Cliquez sur Configure Webhook (ou + New Webhook)

Webhook pour les deals gagnes :

6. Nom : DURUM - Sale Won
7. URL :

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

8. Method : POST
9. URL Format : JSON
10. Dans le Body, selectionnez Custom et ajoutez les champs suivants :
    • Deal_Name : ${Deals.Deal Name}
    • Stage : ${Deals.Stage}
    • Amount : ${Deals.Amount}
    • Contact_Name : ${Deals.Contact Name}
    • Email : ${Deals.Email}
    • Owner : ${Deals.Deal Owner}
11. Cliquez sur Save

Associer le webhook a un workflow :

12. Retournez dans Settings puis Automation puis Workflow Rules
13. Cliquez sur + Create Rule
14. Module : Deals
15. Nom de la regle : DURUM - Notify Sale
16. Quand : Stage est modifie a Closed Won (ou votre statut equivalent)
17. Action : selectionnez Webhook puis choisissez DURUM - Sale Won
18. Sauvegardez et activez la regle

Repetez les memes etapes pour les deals perdus, en changeant :

• Le nom du webhook : DURUM - Sale Lost
• Le filtre de la regle : Stage est modifie a Closed Lost
• L'URL reste la meme (/api/webhook/sale)

Comment tester

1. Creez un deal de test dans Zoho CRM
2. Changez son statut a Closed Won
3. Attendez 30 secondes
4. Dans DURUM.ai, allez dans Logs Data
5. Verifiez qu'un evenement sale apparait
6. Supprimez le deal de test

Depannage Zoho CRM

Probleme	Solution
L'evenement n'apparait pas	Verifiez que le workflow rule est active et que le webhook est bien associe
Erreur dans les logs Zoho	Verifiez l'URL (pas d'espace, client_key correct) et que le format est JSON
Le montant est a 0	Verifiez que le champ Amount est bien mappe dans le body du webhook

---

Zoho Books

Ce que ca fait

Zoho Books envoie les evenements de facturation en temps reel vers DURUM.ai.

Evenement Zoho Books	Type dans DURUM.ai	Quand
Facture payee (Invoice Paid)	Paiement	Le client paie une facture
Facture en retard (Invoice Overdue)	Paiement du	La facture depasse la date d'echeance

Configuration etape par etape

1. Connectez-vous a votre compte Zoho Books
2. Cliquez sur l'icone Engrenage (en haut a droite) pour acceder aux Settings
3. Dans la section Integrations, cliquez sur Webhooks (ou dans Automation selon votre version)
4. Cliquez sur + New Webhook

Webhook pour les factures payees :

5. Nom : DURUM - Payment
6. Module : Invoice
7. URL :

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

8. HTTP Method : POST
9. Payload Format : JSON
10. Dans Trigger, selectionnez : quand le statut de la facture passe a Paid
11. Ajoutez les champs a inclure dans le payload :
    • Invoice Number
    • Invoice Date
    • Total
    • Balance
    • Customer Name
    • Contact Email
12. Cliquez sur Save

Webhook pour les factures en retard :

13. Creez un deuxieme webhook : DURUM - Payment Due
14. Meme URL :

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

15. Trigger : quand le statut passe a Overdue
16. Sauvegardez

Comment tester

1. Creez une facture de test dans Zoho Books
2. Marquez-la comme payee
3. Attendez 30 secondes
4. Dans DURUM.ai, allez dans Logs Data
5. Verifiez qu'un evenement payment apparait
6. Supprimez la facture de test

Depannage Zoho Books

Probleme	Solution
Payload vide dans les logs	Verifiez que les champs sont bien configures dans le webhook Zoho Books
client_key=unknown	Assurez-vous que ?client_key=VOTRE_CLE est present dans l'URL
Evenement en quarantaine	L'agence doit mapper la source. Contactez votre gestionnaire.

WARNING

Le parametre ?client_key=VOTRE_CLE est obligatoire dans l'URL du webhook Zoho Books. Sans ce parametre, DURUM.ai ne pourra pas associer le paiement a votre compte.

---

Stripe

Ce que ca fait

Stripe envoie les evenements de paiement en temps reel vers DURUM.ai. Stripe utilise une verification de signature pour securiser les webhooks.

Evenement Stripe	Type dans DURUM.ai	URL webhook
checkout.session.completed	Vente	/api/webhook/sale
invoice.paid	Paiement	/api/webhook/payment
charge.refunded	Remboursement	/api/webhook/refund

Configuration etape par etape

1. Connectez-vous au Dashboard Stripe (https://dashboard.stripe.com)
2. Dans le menu lateral, allez dans Developers puis Webhooks
3. Cliquez sur Add endpoint (ou Ajouter un endpoint)

Endpoint 1 : Ventes (checkout)

4. Dans le champ Endpoint URL, entrez :

   https://app.durum.ai/api/webhook/sale

5. Cliquez sur Select events to listen to
6. Cochez checkout.session.completed
7. Cliquez sur Add endpoint

Endpoint 2 : Paiements (factures)

8. Cliquez sur Add endpoint a nouveau
9. URL :

   https://app.durum.ai/api/webhook/payment

10. Evenement : invoice.paid
11. Cliquez sur Add endpoint

Endpoint 3 : Remboursements

12. Cliquez sur Add endpoint a nouveau
13. URL :

    https://app.durum.ai/api/webhook/refund

14. Evenement : charge.refunded
15. Cliquez sur Add endpoint

Configuration du secret de signature :

16. Pour chaque endpoint cree, cliquez dessus pour voir ses details
17. Dans la section Signing secret, cliquez sur Reveal pour voir le secret
18. Transmettez ce secret a votre agence -- elle le configurera dans DURUM.ai pour verifier l'authenticite des webhooks

WARNING

La verification de signature Stripe est obligatoire. Sans le secret de signature configure par l'agence, les webhooks Stripe seront rejetes avec une erreur 401. Apres avoir cree les endpoints, contactez votre gestionnaire de compte pour lui transmettre le ou les secrets.

Comment tester

1. Dans Stripe Dashboard, allez dans l'endpoint que vous avez cree
2. Cliquez sur Send test webhook
3. Selectionnez le type d'evenement (ex: checkout.session.completed)
4. Cliquez sur Send test webhook
5. Verifiez que la reponse est 200 OK
6. Dans DURUM.ai, allez dans Logs Data pour confirmer la reception

INFO

Stripe ne necessite pas de client_key dans l'URL. Le client est identifie automatiquement via les metadonnees du paiement (email du client, ID de session). Si l'identification echoue, l'evenement est mis en quarantaine pour traitement par l'agence.

Depannage Stripe

Probleme	Solution
Erreur 401 (signature invalide)	Le secret de signature n'est pas configure ou est incorrect. Contactez l'agence.
Erreur 500 (Server misconfigured)	Le secret n'est pas configure cote serveur. Contactez l'agence.
Evenement ignore	Seuls checkout.session.completed, invoice.paid et charge.refunded sont traites. Les autres types sont ignores.
Test webhook echoue	Les webhooks de test Stripe n'ont pas de vraie signature. Contactez l'agence pour un test en mode live.

---

Google Calendar / Microsoft Outlook

Ce que ca fait

La connexion calendrier permet a DURUM.ai de :

• Suivre automatiquement les rendez-vous planifies
• Detecter les presences et no-shows
• Alimenter l'onglet Calendrier de la page Ventes Reps
• Declencher l'enregistrement des appels (si active)

Configuration etape par etape

1. Connectez-vous a DURUM.ai
2. Allez dans Profil (dans le menu lateral)
3. Faites defiler jusqu'a la section Integrations calendrier
4. Cliquez sur Connecter Google Calendar (ou Connecter Microsoft Outlook, selon votre cas)
5. Une fenetre OAuth s'ouvre -- connectez-vous a votre compte Google (ou Microsoft)
6. Autorisez l'acces en cliquant sur Autoriser (ou Allow)
7. La fenetre se ferme automatiquement
8. Le statut dans DURUM.ai passe a Connecte

Ce qu'il faut savoir

• Chaque representant doit connecter son propre calendrier individuellement
• La connexion est personnelle -- un directeur ne peut pas connecter le calendrier de ses reps
• Si vous changez le mot de passe de votre compte Google/Microsoft, vous devrez peut-etre reconnecter le calendrier

Comment tester

1. Apres la connexion, creez un rendez-vous de test dans votre calendrier
2. Attendez quelques minutes (la synchronisation se fait toutes les 15 minutes)
3. Dans DURUM.ai, allez dans la page Ventes Reps pour verifier que le rendez-vous apparait

Depannage Google Calendar / Outlook

Probleme	Solution
La fenetre OAuth ne s'ouvre pas	Desactivez le bloqueur de popups de votre navigateur pour app.durum.ai
Le statut reste "Non connecte"	Essayez de vous deconnecter puis reconnecter. Assurez-vous d'avoir autorise tous les accès demandes.
Les rendez-vous n'apparaissent pas	Attendez 15 minutes (cycle de synchronisation). Si ca persiste, deconnectez et reconnectez le calendrier.

Important pour les directeurs

Assurez-vous que chaque representant de votre equipe connecte son calendrier. Sans cette connexion, les meetings ne seront pas suivis automatiquement et les analyses de presence/no-show ne seront pas disponibles pour ce rep.

---

Slack

Ce que ca fait

Slack recoit tous les rapports automatiques et alertes de DURUM.ai :

• Rapports quotidiens, hebdomadaires, mensuels
• Alertes de performance en temps reel
• Analyses d'appels
• Resumes de fin de journee
• Alertes systeme

Comment configurer

Voir la page Configuration des notifications Slack pour le guide complet.

---

Deduplication des donnees

DURUM.ai inclut un systeme de deduplication automatique a 3 niveaux pour eviter les doublons :

Niveau	Comment ca fonctionne	Exemple
Numero de facture	Si un evenement avec le meme numero de facture existe deja, il est ignore	Zoho Books envoie la meme facture 2 fois
URI Calendly	Si un evenement avec le meme identifiant Calendly existe deja, il est ignore	Calendly reenvoie un webhook
Email + type + date	Si un evenement du meme type, pour le meme email, le meme jour existe deja, il est ignore	GHL envoie un lead 2 fois

De plus, la deduplication de revenus empeche le double-comptage quand un meme client a une vente (Zoho CRM) et un paiement (Zoho Books). Seul le paiement est compte dans les revenus pour eviter de gonfler les chiffres.

Vous n'avez rien a faire -- la deduplication est entierement automatique.

---

Quarantaine

Quand DURUM.ai recoit un evenement d'une source inconnue ou qui ne peut pas etre associee a un compte client, l'evenement est automatiquement place en quarantaine.

Pourquoi un evenement est mis en quarantaine

Raison	Explication
Formulaire inconnu	Un nouveau formulaire GHL ou Typeform que DURUM.ai ne connait pas encore
Client non resolu	Le client_key est manquant ou invalide
Source non reconnue	La source de l'evenement ne peut pas etre identifiee automatiquement

Ce qui se passe ensuite

1. L'evenement est sauvegarde dans la quarantaine (rien n'est perdu)
2. L'agence est notifiee automatiquement
3. L'agence categorise l'evenement dans la page Matching
4. Une fois categorise, tous les prochains evenements de cette source sont traites automatiquement

INFO

Vous n'avez rien a faire quand un evenement est en quarantaine. L'agence s'en occupe. Si vous voyez beaucoup d'evenements en quarantaine, contactez votre gestionnaire de compte pour accelerer la categorisation.

---

Verification : comment savoir si vos webhooks fonctionnent

Methode 1 : Page Logs Data

1. Connectez-vous a DURUM.ai
2. Allez dans la page Logs Data (dans le menu lateral)
3. Vous verrez tous les evenements entrants en temps reel
4. Chaque ligne montre :
   • La source (Typeform, Calendly, GHL, Zoho, Stripe)
   • Le type d'evenement (lead, booking, sale, etc.)
   • Le statut (success, queued, quarantined, error)
   • La date et l'heure de reception

Methode 2 : Tester manuellement

Pour chaque integration, creez un evenement de test :

• GHL : creez un contact de test
• Calendly : reservez un creneau de test
• Typeform : soumettez une reponse de test
• Zoho CRM : creez un deal de test et changez son statut
• Zoho Books : creez et payez une facture de test
• Stripe : utilisez la fonction "Send test webhook" dans le dashboard Stripe

Attendez 30 secondes puis verifiez dans la page Logs Data.

Statuts dans les logs

Statut	Signification	Action requise
success	L'evenement a ete traite et enregistre	Rien, tout est bon
queued	L'evenement est en file d'attente (probleme temporaire)	Rien, sera traite automatiquement
quarantined	Source inconnue, en attente de categorisation	L'agence s'en occupe
duplicate	Evenement deja recu, ignore	Normal, la deduplication fonctionne
error	Erreur lors du traitement	Contactez l'agence avec les details du log
ignored	Evenement configure pour etre ignore	Normal si le formulaire est ignore volontairement

---

Depannage general

Problemes frequents

Probleme	Cause probable	Solution
Aucun evenement dans les logs	Le webhook n'est pas active	Verifiez la configuration dans l'outil source (GHL, Calendly, etc.)
client_key=unknown	Le parametre client_key manque dans l'URL	Ajoutez ?client_key=VOTRE_CLE a l'URL du webhook
Erreur 401	Authentification echouee	Pour GHL : ajoutez &source=ghl. Pour Stripe : transmettez le secret a l'agence.
Erreur 405	Mauvaise methode HTTP	Assurez-vous que le webhook est configure en POST (pas GET)
Erreur 429	Trop de requetes en peu de temps	Limitez les webhooks ou contactez l'agence
Erreur 500	Erreur serveur	Contactez l'agence avec les details de l'erreur
Donnees incompletes (montant a 0, pas de nom)	Les champs ne sont pas mappes dans le webhook	Verifiez le mapping des champs dans l'outil source
Evenement en double dans DURUM.ai	Le systeme de deduplication n'a pas pu detecter le doublon	Contactez l'agence pour supprimer le doublon manuellement

Si rien ne fonctionne

1. Verifiez que l'URL est exactement https://app.durum.ai/api/webhook/{type}?client_key=VOTRE_CLE
2. Verifiez qu'il n'y a pas d'espaces ou de caracteres speciaux dans l'URL
3. Verifiez que la methode est POST
4. Verifiez que votre client_key est correct (demandez a l'agence en cas de doute)
5. Essayez de creer un evenement de test et verifiez dans la page Logs Data
6. Si le probleme persiste, contactez votre gestionnaire de compte avec :
   • Le nom de l'integration (GHL, Calendly, etc.)
   • L'URL webhook utilisee
   • Le type d'evenement qui ne fonctionne pas
   • Une capture d'ecran de l'erreur (si disponible)

TIP

La grande majorite des problemes de webhook sont lies a une URL mal copiee ou un client_key incorrect. Verifiez toujours ces deux elements en premier.