Qualité des leads : import CSV et webhook

Avant de commencer : les statuts

Kapitaine ramène chaque statut à cinq étapes : Nouveau, Qualifié, Rendez-vous, Signé, Perdu. Les libellés courants sont reconnus d'office, en français et en anglais (« rdv pris », « gagné », « closed won », « MQL », « disqualifié »…).

Si votre CRM utilise d'autres libellés, un admin les associe une fois pour toute l'agence dans la carte Statuts de l'onglet Qualité des leads.

Importer un fichier CSV

Exportez vos leads depuis votre CRM en CSV (5 Mo et 20 000 lignes au plus). Ne gardez pas forcément les colonnes personnelles : elles ne pourront de toute façon pas être importées.
Ouvrez le client, onglet Qualité des leads, carte Importer un fichier CSV, et choisissez le fichier. Il est lu dans votre navigateur.
Associez les colonnes. Obligatoires : Date du lead (JJ/MM/AAAA ou AAAA-MM-JJ) et Statut. Facultatives : Identifiant du lead, Date du statut, Campagne / formulaire / source, Identifiant de campagne, Identifiant de publicité, Montant signé.
Lancez l'import. Le résumé indique les lignes importées, les doublons, les rejets (avec leur motif) et la part rattachée à une campagne.

Réimporter le même fichier ne crée pas de doublon. Le tableau Derniers imports permet d'Annuler l'import : ses résultats sont retirés, sans toucher aux données reçues par webhook.

Brancher un webhook (CRM, Zapier, Make)

Carte Webhook entrant, cliquez sur Créer l'URL du webhook. Copiez l'URL et le secret de signature : ils ne sont affichés qu'une fois.
Dans votre CRM, ou dans une étape « requête HTTP » de Zapier ou Make, envoyez à cette URL une requête POST en application/json à chaque changement de statut.
Signez la requête : en-tête de signature au format t=<horodatage>,v1=<HMAC-SHA256>, calculé avec le secret sur l'horodatage et le corps de la requête. La signature est exigée par défaut ; la désactiver demande une confirmation.
Vérifiez le résultat dans Derniers appels : nombre d'événements acceptés, doublons et erreurs (jamais le contenu envoyé).

Exemple d'événement :

{
  "lead_id": "1234567890123456",
  "status": "signé",
  "occurred_at": "2026-09-24T15:12:00+02:00",
  "lead_created_at": "2026-09-02",
  "campaign_id": "120210000000000",
  "value": 1250.50,
  "currency": "EUR"
}

lead_id et status sont obligatoires. Envoyez l'identifiant en texte : les grands nombres JSON perdent des chiffres.
campaign_id, adset_id ou ad_id rattachent le lead à sa campagne ; à défaut, campaign (nom ou utm_campaign) s'il désigne une seule campagne du client.
Un appel peut contenir un objet, un tableau ou {"events": [...]}, 100 événements et 256 Ko au plus. Un envoi rejoué ne crée pas de doublon.

Régénérer l'URL désactive immédiatement l'ancienne ; Supprimer coupe la réception.

Aucune donnée personnelle

Nom, e-mail, téléphone, adresse, date de naissance, IBAN, adresse IP ou commentaire : ces colonnes ne peuvent pas être associées dans un CSV, et un événement de webhook qui en contient est refusé avec l'erreur « Champ(s) personnel(s) refusé(s) (RGPD) ». Une valeur qui ressemble à un e-mail ou à un numéro de téléphone fait aussi rejeter la ligne.

Lire les résultats et les partager

L'onglet affiche, sur 3, 6 ou 12 mois : leads importés, taux de qualification, coût par lead qualifié, coût par rendez-vous, coût par client signé, revenu signé et ROAS réel, délai médian jusqu'à la signature, puis l'évolution mensuelle et le détail par campagne.

Afficher dans l'espace client montre une tuile de résultats agrégés à votre client (désactivé par défaut).
Dans l'éditeur du rapport mensuel, ajoutez la section Qualité des leads : elle est figée au moment de l'ajout et visible du client après publication.

Importer la qualité des leads : CSV et webhook