Importer des contacts en masse
L'import en masse permet de charger une liste de contacts depuis un fichier Excel (.xlsx, .xls), OpenDocument (.ods) ou CSV (.csv), avec un assistant en 4 étapes : upload, mapping, validation, import.
Accédez-y depuis le menu Contacts → Importer, ou via l'URL
/app/contact/import.
Étape 1 — Upload du fichier
- 1
(Optionnel) Télécharger le modèle
Le bouton Télécharger le modèle propose un fichier Excel d'exemple avec les colonnes recommandées. Utile pour préparer un fichier depuis zéro.
- 2
Glisser-déposer ou cliquer
Déposez votre fichier dans la zone d'upload, ou cliquez pour sélectionner. Formats acceptés :
.xlsx,.xls,.csv,.ods. Taille recommandée : jusqu'à 50 000 lignes. - 3
Choisir la feuille (si plusieurs)
Si votre fichier Excel contient plusieurs onglets, sélectionnez celui qui contient vos contacts.
- 4
Confirmer la ligne d'en-têtes
L'assistant détecte automatiquement si votre première ligne est un en-tête (texte court non numérique). Confirmez ou ajustez : indiquez Oui ou Non, et le numéro de la ligne d'en-têtes (ou la première ligne de données si pas d'en-têtes).
Un aperçu brut des 10 premières lignes est affiché. Les lignes vides sont automatiquement ignorées.
Étape 2 — Mapping des colonnes
C'est l'étape clé : vous indiquez à quel champ contact correspond chaque colonne de votre fichier.
L'assistant affiche un tableau avec, pour chaque colonne :
- Le nom de la colonne dans votre fichier (en-tête ou Colonne A, B, C…).
- Jusqu'à 3 exemples de valeurs non vides issues du fichier.
- Un sélecteur Champ cible.
- (Si mapping IA utilisé) Le score de confiance en pourcentage.
Champs cibles disponibles
| Champ standard | Type | Notes |
|---|---|---|
| Nom, Prénom | Texte | Identité de base |
| Email principal, Email secondaire, Email (3) | Plusieurs colonnes possibles vers emails[] | |
| Téléphone principal, Téléphone secondaire, Téléphone (3) | Téléphone | Plusieurs colonnes possibles vers tels[] |
| Date de naissance | Date | Format détecté ou imposé à l'étape 3 |
| Sexe (Homme oui/non) | Booléen | Accepte Homme/Femme, M/F, H/F, Oui/Non… |
| Adresse, Code postal, Ville, État/Région, Pays | Texte | Adresse principale |
| Adresse 2 (Libellé, Rue, Code postal, Ville, Pays) | Texte | Adresse secondaire |
| Archivé, Décédé, Chef de famille | Booléen | États du contact |
En complément, vous pouvez mapper vers :
- Tag / Catégorie — la cellule devient une catégorie appliquée au contact. Si la cellule contient plusieurs catégories séparées (par virgule, point-virgule, pipe ou slash), elles seront éclatées selon le séparateur choisi à l'étape 3.
- Champs personnalisés existants — vos champs sur mesure déjà créés dans votre organisation (Texte, Nombre, Oui/Non, Date, Date & Heure).
- + Créer un nouveau champ personnalisé — pour créer à la volée un champ qui n'existe pas encore.
- — Ignorer cette colonne — — pour les colonnes inutiles (ID interne, doublons d'en-tête…).
Mapping automatique IA
Le bouton Mapping automatique IA demande à un modèle IA d'analyser vos colonnes (en-têtes + exemples) et de proposer un mapping pour chacune. Le résultat affiche un score de confiance :
- ≥ 80 % (vert) — fiable, peut être validé tel quel.
- 50–80 % (jaune) — à vérifier.
- < 50 % (orange) — incertain, à corriger manuellement.
Survolez le score pour voir la raison invoquée par l'IA.
L'IA reste une suggestion : vous restez libre de tout ajuster manuellement avant de continuer.
Créer un nouveau champ personnalisé
Si une colonne ne correspond à aucun champ standard ni personnalisé existant, choisissez + Créer un nouveau champ personnalisé. Une modale demande :
- Le libellé affiché à l'utilisateur (ex: « Voiture »).
- La clé technique (sans espaces ni accents, ex:
voiture). - Le type : Texte, Nombre, Oui/Non, Date, Date & Heure.
Le champ est créé à la volée et devient disponible pour les imports suivants.
Étape 3 — Validation et options
Cette étape vérifie chaque ligne et affiche le statut individuel : valide, avertissement (doublon interne au fichier), erreur (format invalide, identité manquante), ignorée (exclue manuellement).
Options d'import
Trois sections d'options sont à régler :
Gestion des doublons & filtres
| Option | Valeurs | Comportement |
|---|---|---|
| Si le contact existe déjà | Mettre à jour / Ignorer / Créer un doublon | Si un contact existant a le même email ou téléphone : on enrichit (update), on saute (skip), ou on crée quand même (create). |
| Exiger un moyen de contact | Oui / Non | Si activé, les lignes sans email ET sans téléphone sont rejetées. Recommandé. |
Format des données
| Option | Description |
|---|---|
| Pays par défaut (téléphones) | Pays utilisé pour interpréter les numéros sans indicatif. Ex: France (+33) transforme 0612345670 en +33612345670. |
| Format de date | Format imposé pour parser les dates de naissance. Auto-détection essaie plusieurs formats courants. À forcer si vos dates sont ambiguës (12/03/2024 = 12 mars ou 3 décembre ?). |
| Séparateur de tags | Caractère qui sépare les catégories dans une cellule de type Tag (virgule, point-virgule, pipe, slash). |
Tags globaux
Ajoutez des tags qui seront appliqués à tous les contacts importés.
Idéal pour tracer la source (IMPORT_2026_AVRIL, LISTE_RACHIDESS,
EVENEMENT_PESSAH). Saisissez le tag puis cliquez sur Ajouter (ou
appuyez sur Entrée). Cliquez sur la croix d'un tag pour l'enlever.
Tableau de vérification
Sous les options, le tableau liste toutes les lignes avec leur statut. Vous pouvez :
- Filtrer par statut (Toutes / Erreurs / Avertissements / Ignorées).
- Éditer une cellule directement sur place — cliquez dessus, modifiez, validez avec Entrée. Les modifications n'affectent pas votre fichier d'origine ; elles sont gardées en mémoire jusqu'à l'import.
- Ignorer une ligne — cliquez sur son numéro de ligne (premier colonne) pour la basculer en ignorée. Recliquer pour la réactiver.
Le résumé en haut affiche : N valides, N avertissements, N erreurs,
N ignorées sur N lignes au total.
Étape 4 — Lancer l'import
Une confirmation finale s'affiche avant le lancement :
- Résumé du nombre de lignes à importer, avec avertissements et ignorées.
- Rappel de la stratégie de doublons choisie.
- Rappel du filtre exigence contact s'il est actif.
- Liste des tags globaux appliqués.
- Case à cocher « Je comprends que cette action est irréversible » — obligatoire avant de pouvoir cliquer sur Lancer l'import définitivement.
Pendant l'import
L'import s'exécute par lots de 200 contacts. Une barre de progression indique le lot en cours et le pourcentage. Les compteurs en direct affichent :
- +N créés (vert) — nouveaux contacts.
- ↻N mis à jour (bleu) — contacts existants enrichis.
- N ignorés (gris) — sautés selon la stratégie de doublons.
- N erreurs (rouge) — rejetés par le serveur.
Après l'import
Un écran de résultat affiche le bilan final :
| Statut | Signification |
|---|---|
| Import réussi | Aucune erreur côté serveur. |
| Import terminé avec des erreurs | Au moins une ligne a été rejetée par le serveur. |
Deux boutons sont proposés :
- Retour aux contacts — vous ramène au catalogue contacts.
- Télécharger le rapport d'erreurs — génère un CSV avec, pour chaque ligne rejetée, le numéro de ligne dans le fichier original, le type d'erreur (validation ou serveur), la raison, et toutes les valeurs d'origine. Idéal pour corriger puis ré-importer uniquement les lignes en erreur.
Limitations et bonnes pratiques
- Taille max recommandée : 50 000 lignes par fichier. Au-delà, scindez en plusieurs fichiers.
- Pas d'import direct des liens familiaux depuis ce wizard — les liens parents-enfants se créent ensuite manuellement ou via l'API.
- Sauvegardez d'abord votre base si vous importez sur une base contenant déjà des contacts (mise à jour = écrasement de certaines valeurs).
- Faites un test sur 10 lignes avant un gros import — extrayez les 10 premières lignes dans un fichier séparé, lancez l'import, vérifiez le résultat dans le catalogue, puis lancez le vrai import.