Intégrations

DURUM.ai se connecte à vos outils existants pour centraliser automatiquement toutes vos données marketing et ventes. Cette page explique chaque intégration en détail et vous guide étape par étape pour configurer les webhooks vous-même.

---

Vue d'ensemble

Intégration	Ce qu'elle fait	Configuration
Meta Ads	Synchronisé vos dépenses publicitaires chaque heure	Connectez dans Intégrations (1 clic)
GHL (GoHighLevel)	Envoie les leads, applications, bookings et ventes en temps réel	Connectez dans Intégrations ou configurez les workflows
Pipedrive	Envoie les leads, ventes et meetings en temps réel	Connectez dans Intégrations (OAuth)
Calendly	Envoie les bookings, annulations et no-shows en temps réel	Connectez dans Intégrations (OAuth)
Typeform	Envoie les leads et applications en temps réel	Connectez dans Intégrations puis mappez les formulaires
Stripe	Envoie les paiements, ventes et remboursements en temps réel	Connectez dans Intégrations (clé API)
Zoho CRM	Envoie les ventes (deals gagnes/perdus) en temps réel	Webhooks manuels à configurer (guide)
Zoho Books	Envoie les paiements et factures en temps réel	Webhooks manuels à configurer (guide)
Google Calendar	Synchronisé le calendrier de vos reps pour le suivi des meetings	Chaque rep connecte dans son Profil
Microsoft Outlook	Même chose que Google Calendar, pour les utilisateurs Outlook	Chaque rep connecte dans son Profil
Slack	Reçoit les rapports automatiques, alertes et analyses d'appels	Configure dans la page Notifications

Intégrations natives vs webhooks manuels

La majorite des intégrations se connectent directement depuis la page Intégrations dans l'app (1 ou 2 clics). Seuls Zoho CRM et QuickBooks nécessitent une configuration manuelle de webhooks. Consultez le guide de chaque intégration pour les détails.

---

Comment les données arrivent dans DURUM.ai

Il y a deux facons dont les données entrent dans la plateforme :

1. Webhooks (temps réel)

Un webhook est une notification automatique envoyée par un outil externe vers DURUM.ai au moment ou un événement se produit. Par exemple :

• Un prospect remplit un formulaire Typeform -- DURUM.ai reçoit le lead instantanement
• Un prospect réservé un rendez-vous sur Calendly -- DURUM.ai reçoit le booking instantanement
• Une vente est conclue dans Zoho CRM -- DURUM.ai reçoit la vente instantanement

Les webhooks sont la méthode principale pour tous les événements CRM (leads, applications, bookings, no-shows, ventes, paiements, remboursements).

2. Synchronisation périodique (enrichissement)

Certaines données sont synchronisées periodiquement par API :

Donnée	Fréquence	Source
Dépenses publicitaires	Chaque heure	Meta Ads API
Contacts et opportunités	Toutes les 15 minutes	GHL API
Monitoring calendrier	Toutes les 15 minutes	Calendly API

INFO

La synchronisation périodique sert a enrichir les données, pas à les créer. Tous les événements (leads, bookings, ventes) arrivent par webhooks en temps réel. Les API syncs ajoutent des informations supplementaires comme les tags de contact, les détails d'opportunité, etc.

---

Comment trouver votre client_key

Votre client_key est un identifiant unique attribue à votre compte. Il est utilise dans toutes les URLs de webhook pour identifier vos données.

Pour trouver votre client_key :

1. Connectez-vous a app.durum.ai
2. Allez dans Profil (menu latéral → Profil)
3. Votre clé client est affichée dans la section "Clé client (API & Intégrations)" avec un bouton Copier
4. Collez cette clé dans vos URLs webhook : ?client_key=VOTRE_CLE

TIP

Votre clé client est toujours visible dans votre page Profil. Vous n'avez pas besoin de la demander à 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'événement	URL webhook	Méthode	Sources supportées
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 réservé)	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 à 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 synchronisé automatiquement par l'agence. Les données suivantes sont importees :

• Dépenses quotidiennes par publicité (spend, clics, impressions, reach)
• Metadonnees des campagnes, adsets et publicités (noms, statuts, objectifs)

Fréquence

• Chaque heure : les 3 derniers jours de dépenses sont resynchronises
• Chaque nuit : les agregats mensuels sont recalcules

Configuration

La connexion Meta Ads est gérée entièrement par l'agence. Vous n'avez rien à configurer. Si vos dépenses n'apparaissent pas, contactez votre gestionnaire de compte.

---

GHL (GoHighLevel)

Ce que ca fait

GHL envoie les événements CRM en temps réel vers DURUM.ai via des Workflows. Chaque événement est automatiquement associé à votre compte grace à votre client_key.

Événement GHL	Type dans DURUM.ai	Quand
Contact créé	Lead	Nouveau contact dans votre CRM
Formulaire soumis	Application	Le prospect remplit un formulaire de qualification
Rendez-vous créé	Booking	Un rendez-vous est réservé
Rendez-vous no-show	No-show	Le prospect ne se présente pas
Opportunité gagnee	Vente	Un deal est marque comme gagne

Configuration étape par étape

Vous devez créer un Workflow GHL par type d'événement. Voici les étapes détaillées pour chaque.

Workflow 1 : Lead (nouveau contact)

1. Connectez-vous à votre compte GHL
2. Dans le menu latéral, allez dans Automation puis Workflows
3. Cliquez sur Create Workflow (ou Créer un workflow)
4. Choisissez Start from Scratch (commencer à partir de zero)
5. Nommez le workflow : DURUM - Lead
6. Configurer le déclencheur (Trigger) :
   • Cliquez sur Add New Trigger
   • Sélectionnez Contact Created
   • Cliquez sur Save Trigger
7. Ajouter l'action webhook :
   • Cliquez sur le + sous le trigger
   • Cherchez et sélectionnez Webhook
   • Dans le champ URL, entrez :

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

   • Méthode : POST
   • Laissez le body par défaut (GHL envoie automatiquement les données du contact)
   • Cliquez sur Save Action
8. Activez le workflow en cliquant sur le toggle Publish (en haut à droite)

Workflow 2 : Application (formulaire soumis)

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

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

   • Méthode : POST
5. Activez le workflow

Workflow 3 : Booking (rendez-vous créé)

1. Créez un nouveau workflow : DURUM - Booking
2. Trigger : sélectionnez 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

   • Méthode : POST
4. Activez le workflow

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

1. Créez un nouveau workflow : DURUM - No-Show
2. Trigger : sélectionnez 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

   • Méthode : POST
4. Activez le workflow

Workflow 5 : Vente (opportunité gagnee)

1. Créez un nouveau workflow : DURUM - Vente
2. Trigger : sélectionnez 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

   • Méthode : POST
4. Activez le workflow

Comment tester

1. Créez 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'événement apparaitre avec le statut success ou queued
5. Supprimez le contact de test dans GHL après vérification

Dépannage GHL

Problème	Solution
L'événement n'apparaît pas dans Logs Data	Vérifiez que le workflow est Publish (actif). Vérifiez 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	Vérifiez que &source=ghl est présent dans l'URL
Erreur 429 (Too Many Requests)	Trop de webhooks en même temps. Contactez l'agence.

Formulaires inconnus et quarantaine

Si un formulaire GHL envoie des données mais n'est pas encore reconnu par DURUM.ai, l'événement est mis en quarantaine automatiquement. L'agence le categorisera dans la page Matching, et les prochains événements de ce formulaire seront automatiquement reconnus. Vous n'avez rien à faire.

---

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

---

Typeform

Ce que ca fait

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

Configuration étape par étape

1. Connectez-vous à votre compte Typeform
2. Ouvrez le formulaire que vous souhaitez connecter
3. Cliquez sur Connect dans le menu du haut
4. Sélectionnez Webhooks dans la liste des intégrations
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 à 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 latéral
3. Sélectionnez 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 publicité
   • utm_term -- le terme de recherche (optionnel)
5. Dans vos publicités Meta, ajoutez ces paramètres à 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 à une campagne spécifique. Le lead sera quand même 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. Vérifiez que l'événement apparaît avec le bon type (lead ou application)

Dépannage Typeform

Problème	Solution
L'événement n'apparaît pas	Vérifiez 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 présent dans l'URL ou les hidden fields
Pas d'attribution aux campagnes	Vérifiez que les hidden fields UTM sont configurés 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 à 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 réel vers DURUM.ai.

Événement 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 étape par étape

1. Connectez-vous à votre compte Zoho CRM
2. Cliquez sur l'icône Engrenage (en haut à droite) pour accéder aux Settings (Paramètres)
3. Dans la section Automation, cliquez sur Actions
4. Sélectionnez 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, sélectionnez 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 à un workflow :

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

Repetez les mêmes étapes pour les deals perdus, en changeant :

• Le nom du webhook : DURUM - Sale Lost
• Le filtre de la règle : Stage est modifie a Closed Lost
• L'URL reste la même (/api/webhook/sale)

Comment tester

1. Créez 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. Vérifiez qu'un événement sale apparaît
6. Supprimez le deal de test

Dépannage Zoho CRM

Problème	Solution
L'événement n'apparaît pas	Vérifiez que le workflow rule est active et que le webhook est bien associé
Erreur dans les logs Zoho	Vérifiez l'URL (pas d'espace, client_key correct) et que le format est JSON
Le montant est a 0	Vérifiez que le champ Amount est bien mappe dans le body du webhook

---

Zoho Books

Ce que ca fait

Zoho Books envoie les événements de facturation en temps réel vers DURUM.ai.

Événement 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'échéance

Configuration étape par étape

1. Connectez-vous à votre compte Zoho Books
2. Cliquez sur l'icône Engrenage (en haut à droite) pour accéder aux Settings
3. Dans la section Intégrations, 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, sélectionnez : 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. Créez un deuxième webhook : DURUM - Payment Due
14. Même 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. Créez 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. Vérifiez qu'un événement payment apparaît
6. Supprimez la facture de test

Dépannage Zoho Books

Problème	Solution
Payload vide dans les logs	Vérifiez que les champs sont bien configurés dans le webhook Zoho Books
client_key=unknown	Assurez-vous que ?client_key=VOTRE_CLE est présent dans l'URL
Événement en quarantaine	L'agence doit mapper la source. Contactez votre gestionnaire.

WARNING

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

---

Stripe

Ce que ca fait

Stripe envoie les événements de paiement en temps réel vers DURUM.ai. Stripe utilise une vérification de signature pour securiser les webhooks.

Événement 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 étape par étape

1. Connectez-vous au Dashboard Stripe (https://dashboard.stripe.com)
2. Dans le menu latéral, 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 à nouveau
9. URL :

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

10. Événement : invoice.paid
11. Cliquez sur Add endpoint

Endpoint 3 : Remboursements

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

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

14. Événement : charge.refunded
15. Cliquez sur Add endpoint

Configuration du secret de signature :

16. Pour chaque endpoint créé, cliquez dessus pour voir ses détails
17. Dans la section Signing secret, cliquez sur Reveal pour voir le secret
18. Transmettez ce secret à votre agence -- elle le configurera dans DURUM.ai pour vérifier l'authenticite des webhooks

WARNING

La vérification de signature Stripe est obligatoire. Sans le secret de signature configure par l'agence, les webhooks Stripe seront rejetes avec une erreur 401. Après avoir créé 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 créé
2. Cliquez sur Send test webhook
3. Sélectionnez le type d'événement (ex: checkout.session.completed)
4. Cliquez sur Send test webhook
5. Vérifiez que la réponse est 200 OK
6. Dans DURUM.ai, allez dans Logs Data pour confirmer la réception

INFO

Stripe ne nécessite pas de client_key dans l'URL. Le client est identifié automatiquement via les metadonnees du paiement (email du client, ID de session). Si l'identification échoué, l'événement est mis en quarantaine pour traitement par l'agence.

Dépannage Stripe

Problème	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.
Événement ignore	Seuls checkout.session.completed, invoice.paid et charge.refunded sont traités. Les autres types sont ignores.
Test webhook échoué	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 planifiés
• Détecter les presences et no-shows
• Alimenter l'onglet Calendrier de la page Ventes Reps
• Declencher l'enregistrement des appels (si active)

Configuration étape par étape

1. Connectez-vous a DURUM.ai
2. Allez dans Profil (dans le menu latéral)
3. Faites defiler jusqu'à la section Intégrations calendrier
4. Cliquez sur Connecter Google Calendar (ou Connecter Microsoft Outlook, selon votre cas)
5. Une fenêtre OAuth s'ouvre -- connectez-vous à votre compte Google (ou Microsoft)
6. Autorisez l'accès en cliquant sur Autoriser (ou Allow)
7. La fenêtre se fermé automatiquement
8. Le statut dans DURUM.ai passe a Connecte

Ce qu'il faut savoir

• Chaque représentant 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-être reconnecter le calendrier

Comment tester

1. Après la connexion, créez 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 vérifier que le rendez-vous apparaît

Dépannage Google Calendar / Outlook

Problème	Solution
La fenêtre 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 représentant de votre équipe connecte son calendrier. Sans cette connexion, les meetings ne seront pas suivis automatiquement et les analyses de présence/no-show ne seront pas disponibles pour ce rep.

---

Slack

Ce que ca fait

Slack reçoit tous les rapports automatiques et alertes de DURUM.ai :

• Rapports quotidiens, hebdomadaires, mensuels
• Alertes de performance en temps réel
• Analyses d'appels
• Résumés de fin de journée
• Alertes système

Comment configurer

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

---

Déduplication des données

DURUM.ai inclut un système de déduplication automatique a 3 niveaux pour éviter les doublons :

Niveau	Comment ca fonctionne	Exemple
Numéro de facture	Si un événement avec le même numéro de facture existe déjà, il est ignore	Zoho Books envoie la même facture 2 fois
URI Calendly	Si un événement avec le même identifiant Calendly existe déjà, il est ignore	Calendly reenvoie un webhook
Email + type + date	Si un événement du même type, pour le même email, le même jour existe déjà, il est ignore	GHL envoie un lead 2 fois

De plus, la déduplication de revenus empeche le double-comptage quand un même client à une vente (Zoho CRM) et un paiement (Zoho Books). Seul le paiement est compte dans les revenus pour éviter de gonfler les chiffres.

Vous n'avez rien à faire -- la déduplication est entièrement automatique.

---

Quarantaine

Quand DURUM.ai reçoit un événement d'une source inconnue ou qui ne peut pas être associée à un compte client, l'événement est automatiquement place en quarantaine.

Pourquoi un événement est mis en quarantaine

Raison	Explication
Formulaire inconnu	Un nouveau formulaire GHL ou Typeform que DURUM.ai ne connaît pas encore
Client non résolu	Le client_key est manquant ou invalide
Source non reconnue	La source de l'événement ne peut pas être identifiée automatiquement

Ce qui se passe ensuite

1. L'événement est sauvegarde dans la quarantaine (rien n'est perdu)
2. L'agence est notifiee automatiquement
3. L'agence catégorisé l'événement dans la page Matching
4. Une fois catégorisé, tous les prochains événements de cette source sont traités automatiquement

INFO

Vous n'avez rien à faire quand un événement est en quarantaine. L'agence s'en occupe. Si vous voyez beaucoup d'événements en quarantaine, contactez votre gestionnaire de compte pour accelerer la categorisation.

---

Vérification : comment savoir si vos webhooks fonctionnent

Méthode 1 : Page Logs Data

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

Méthode 2 : Tester manuellement

Pour chaque intégration, créez un événement de test :

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

Attendez 30 secondes puis vérifiez dans la page Logs Data.

Statuts dans les logs

Statut	Signification	Action requise
success	L'événement a été traite et enregistre	Rien, tout est bon
queued	L'événement est en file d'attente (problème temporaire)	Rien, sera traite automatiquement
quarantined	Source inconnue, en attente de categorisation	L'agence s'en occupe
duplicate	Événement déjà reçu, ignore	Normal, la déduplication fonctionne
error	Erreur lors du traitement	Contactez l'agence avec les détails du log
ignored	Événement configure pour être ignore	Normal si le formulaire est ignore volontairement

---

Dépannage général

Problèmes frequents

Problème	Cause probable	Solution
Aucun événement dans les logs	Le webhook n'est pas active	Vérifiez la configuration dans l'outil source (GHL, Calendly, etc.)
client_key=unknown	Le paramètre client_key manque dans l'URL	Ajoutez ?client_key=VOTRE_CLE à l'URL du webhook
Erreur 401	Authentification échouée	Pour GHL : ajoutez &source=ghl. Pour Stripe : transmettez le secret à l'agence.
Erreur 405	Mauvaise méthode HTTP	Assurez-vous que le webhook est configure en POST (pas GET)
Erreur 429	Trop de requêtes en peu de temps	Limitez les webhooks ou contactez l'agence
Erreur 500	Erreur serveur	Contactez l'agence avec les détails de l'erreur
Données incompletes (montant a 0, pas de nom)	Les champs ne sont pas mappes dans le webhook	Vérifiez le mapping des champs dans l'outil source
Événement en double dans DURUM.ai	Le système de déduplication n'a pas pu détecter le doublon	Contactez l'agence pour supprimer le doublon manuellement

Si rien ne fonctionne

1. Vérifiez que l'URL est exactement https://app.durum.ai/api/webhook/{type}?client_key=VOTRE_CLE
2. Vérifiez qu'il n'y a pas d'espaces ou de caracteres speciaux dans l'URL
3. Vérifiez que la méthode est POST
4. Vérifiez que votre client_key est correct (demandez à l'agence en cas de doute)
5. Essayez de créer un événement de test et vérifiez dans la page Logs Data
6. Si le problème persiste, contactez votre gestionnaire de compte avec :
   • Le nom de l'intégration (GHL, Calendly, etc.)
   • L'URL webhook utilisée
   • Le type d'événement qui ne fonctionne pas
   • Une capture d'écran de l'erreur (si disponible)

TIP

La grande majorite des problèmes de webhook sont liés à une URL mal copiee ou un client_key incorrect. Vérifiez toujours ces deux éléments en premier.