Dépannage des intégrations

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.