Importer des prospects
Vous pouvez importer des prospects en masse depuis un fichier CSV dans votre espace de travail. L'importateur associe les colonnes CSV aux champs de prospect et crée les enregistrements en arrière-plan.
Étape 1 — Préparer votre CSV
Votre fichier CSV doit :
- Avoir une ligne d'en-tête (noms des colonnes en première ligne)
- Utiliser l'encodage UTF-8
- Être séparé par des virgules (pas des tabulations ou des points-virgules)
Colonnes supportées
| Nom de colonne CSV (suggéré) | Champ du prospect |
|---|---|
first_name | Prénom |
last_name | Nom |
email | |
phone | Téléphone |
company | Nom d'entreprise (crée une entreprise si elle n'existe pas) |
status | Statut (new, contacted, qualified, converted, lost) |
source | Source du prospect |
lead_score | Score |
deal_value | Valeur de l'affaire |
tags | Noms de tags séparés par des virgules |
notes | Notes (texte brut) |
Les colonnes non reconnues sont ignorées.
Étape 2 — Démarrer l'import
- Accédez à Prospects → Importer des prospects dans la barre latérale.
- Cliquez sur Nouvel import.
- Téléchargez votre fichier CSV.
Étape 3 — Mapper les colonnes
L'importateur affiche un aperçu de votre CSV et vous permet d'associer chaque colonne à un champ de prospect :
- Pour chaque colonne CSV, sélectionnez le champ de prospect correspondant dans la liste déroulante.
- Les colonnes à ignorer : laissez sur « Ne pas importer ».
- Vérifiez la ligne d'exemple pour confirmer que la correspondance est correcte.
- Cliquez sur Démarrer l'import.
Étape 4 — Surveiller la progression
L'import s'exécute en arrière-plan (via la file d'attente). Une barre de progression affiche :
- Total des lignes
- Lignes traitées
- Imports réussis
- Lignes ignorées (doublons ou données invalides)
- Erreurs
Gestion des doublons
- Si un prospect avec le même e-mail existe déjà dans votre espace de travail, la ligne est ignorée (pas mise à jour).
- Les lignes sans e-mail sont importées comme nouveaux prospects.
Historique des imports
Tous les imports passés sont listés sous Prospects → Importer des prospects. Cliquez sur n'importe quel import pour voir son statut et les détails des erreurs.
Problèmes courants
| Problème | Solution |
|---|---|
| « Format CSV invalide » | Assurez-vous que le fichier est en UTF-8 séparé par des virgules |
| Nombreuses lignes ignorées | Vérifiez les e-mails en double dans votre espace de travail |
| Champs non mappés | Vérifiez l'orthographe de la ligne d'en-tête ; mappez manuellement |
| Import bloqué | Vérifiez que le cron job fonctionne (Super Admin → Santé du système) |
Conseils
- Testez toujours avec un petit fichier (10-20 lignes) avant d'importer des milliers de prospects.
- Incluez
statusdans votre CSV pour éviter que tous les prospects soient par défaut à « Nouveau ». - Utilisez des valeurs
sourcecohérentes pour pouvoir filtrer par source après l'import.