Depannage des integrations

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.