Synchronisation automatique du statut Lead quand un Deal est gagné
Comprenez pourquoi vos leads passent automatiquement en "closed_won" lorsqu'un deal est marqué gagné, peu importe la source d'import (HubSpot, Stripe, AI import, manuel).
Synchronisation Deal gagné -> Lead "closed_won"
En une phrase
Quand un Deal passe en won dans Metrikia, le Lead lié passe automatiquement en closed_won: quelle que soit la source (HubSpot, Stripe Checkout, import IA, modification manuelle).
Pourquoi c'est important
Le statut du Lead est la source de vérité pour:
- Le funnel de conversion sur le dashboard
/app/dashboard - Le calcul du
closing rate(% lead -> deal) - Les listes filtrées dans
/app/crm(Vue closing, Vue active) - L'éligibilité du Lead aux modèles d'attribution multi-touch
Si le Deal est won mais le Lead reste appointment_booked ou deal_pending, vos KPIs sont incohérents et Metrikia affiche un avertissement de qualité de données.
Ce qui se passe automatiquement
| Action | Conséquence sur le Lead |
|---|---|
| Deal créé via sync HubSpot avec statut won | Lead -> closed_won |
| Deal créé via Stripe Checkout (paiement reçu) | Lead -> closed_won |
| Deal créé via Import IA avec colonne deal.status = won | Lead -> closed_won |
| Premier paiement enregistré sur un Deal pending | Deal -> won, Lead -> closed_won |
| Modification manuelle du Deal en won (PATCH API) | Lead -> closed_won |
Ce que Metrikia NE fait PAS
- Ne déclasse PAS un Lead
closed_wonsi le Deal est plus tard re-ouvert (reopen). Cas rare métier; à gérer manuellement si besoin. - Ne touche PAS les Leads orphelins (Deal sans Lead lié). Un avertissement est loggé.
Vérifier
- Ouvrir le Deal dans
/app/closing/deals - Cliquer "Marquer gagné"
- Naviguer vers le Lead lié dans
/app/crm - Le statut affiche "Gagné" en vert immédiatement après le rafraîchissement (TanStack Query refetch).
Si quelque chose semble incohérent
- Le Lead reste sur l'ancien statut malgré un Deal
won: rafraîchir la page (le cache TanStack expire au bout de 60s), ou vérifier les logs Sentry pour un messageDealWonEvent received but lead not found(Deal orphelin). - Vous avez besoin de corriger un historique pré-existant: contactez le support: un script de backfill SQL est disponible côté admin.
Pour aller plus loin
Cette règle NE cascade PAS dans le sens inverse: si vous mettez un Lead manuellement en closed_won sans Deal, Metrikia n'invente PAS de Deal. Il faut créer le Deal explicitement.
Référence technique
Cette synchronisation est automatique : dès qu'un deal passe gagné, le statut du lead correspondant suit immédiatement.
Guide précédent
Activer le tracking Google Ads (gclid → ad_id)
Guide suivant
Comprendre le funnel e-commerce
Pour aller plus loin, consultez notre blog, la documentation ou contactez le support.