Dépannage des intégrations

Déduplication des données

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

Niveau	Comment ça fonctionne	Exemple
Numéro de facture	Si un événement avec le même numéro de facture existe déjà, il est ignoré	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 ignoré	Calendly réenvoie 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 ignoré	GHL envoie un lead 2 fois

De plus, la déduplication de revenus empêche le double-comptage quand un même client a une vente (Zoho CRM) et un paiement (Zoho Books). Seul le paiement est compté 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 placé 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 sauvegardé dans la quarantaine (rien n'est perdu)
2. L'agence est notifiée automatiquement
3. L'agence catégorise 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 accélérer la catégorisation.

---

Vérification : comment savoir si vos webhooks fonctionnent

Méthode 1 : Page Logs Data

1. Connectez-vous à 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 : réservez un créneau 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é traité et enregistré	Rien, tout est bon
queued	L'événement est en file d'attente (problème temporaire)	Rien, sera traité automatiquement
quarantined	Source inconnue, en attente de catégorisation	L'agence s'en occupe
duplicate	Événement déjà reçu, ignoré	Normal, la déduplication fonctionne
error	Erreur lors du traitement	Contactez l'agence avec les détails du log
ignored	Événement configuré pour être ignoré	Normal si le formulaire est ignoré volontairement

---

Dépannage général

Problèmes fréquents

Problème	Cause probable	Solution
Aucun événement dans les logs	Le webhook n'est pas activé	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 configuré 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 incomplètes (montant à 0, pas de nom)	Les champs ne sont pas mappés 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 caractères spéciaux 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 majorité des problèmes de webhook sont liés à une URL mal copiée ou un client_key incorrect. Vérifiez toujours ces deux éléments en premier.