Your AI Connector Docs

Importer des contacts depuis un fichier

Si vous disposez d’une liste de contacts dans une feuille de calcul, vous pouvez les importer tous en une seule fois au lieu de les ajouter un par un. L’application utilise un assistant en 3 étapes — Importer → Mapper les colonnes → Vérifier — qui fonctionne avec le fichier CSV dont vous disposez déjà, sans avoir besoin de télécharger un modèle au préalable.

Comment importer des contacts

  1. Cliquez sur Contacts dans la barre latérale gauche, puis cliquez sur Importer en haut de la page.
  2. Télécharger. Faites glisser votre fichier CSV dans la zone de dépôt, ou cliquez dessus pour le rechercher. Il n’y a pas de modèle à télécharger au préalable — utilisez le fichier que vous possédez déjà.
  1. Mappage des colonnes. L’assistant lit la ligne d’en-tête de votre fichier et tente de faire correspondre automatiquement chaque colonne à un champ cible : Prénom, Nom, Téléphone, E-mail, Tags, Notes ou Ne pas importer. Vérifiez la suggestion pour chaque colonne et corrigez celles qui sont incorrectes à l’aide du sélecteur situé à côté. Un tableau de prévisualisation affiche les premières lignes exactement telles qu’elles seront importées.
    • Une colonne de numéro de téléphone est obligatoire — vous ne pouvez pas continuer sans en mapper une.
    • Une colonne mappée sur Tags devient de vrais tags sur chaque contact. Plusieurs tags dans une même cellule sont acceptés — séparez-les par une virgule ou un point-virgule (vip; newsletter; hotmart). Les tags qui n’existent pas encore sont créés pour vous ; les tags existants sont réutilisés, sans tenir compte de la casse.
  1. Révision. Choisissez :
    • Canal par défaut — WhatsApp Business, WhatsApp Web ou SMS. Cela s’applique à tout contact importé qui ne précise pas déjà de canal.
    • Liste — choisissez une liste existante dans le menu déroulant ou saisissez un nom pour en créer une nouvelle sur place. Vous ne pouvez faire que l’un ou l’autre, pas les deux.
    • Mettre à jour les contacts existants — désactivé par défaut. Si cette option est désactivée, les lignes correspondant à un contact que vous possédez déjà (même numéro de téléphone) sont ignorées en tant que doublons : rien n’est modifié sur ce contact et il n’est pas ajouté à la liste. Si elle est activée, ces lignes mettent à jour le contact : le nom, l’e-mail et les notes de votre fichier écrasent les données existantes (les cellules vides laissent la valeur actuelle inchangée), tous les tags de la ligne sont ajoutés et le contact est ajouté à la liste que vous avez choisie. C’est ainsi que vous réimportez un fichier pour corriger ou enrichir des contacts que vous avez déjà.
  1. Cliquez sur Importer [count]. Vous arriverez sur un écran de résultat indiquant combien de contacts ont été créés, combien de contacts existants ont été mis à jour (lorsque cette option est activée) et, si des lignes ont été ignorées, une explication détaillée (numéro de téléphone invalide, numéro de téléphone manquant, doublon, limite de contacts atteinte, etc.).

Détails du mappage des colonnes

  • Téléphone est la seule colonne obligatoire. Les lignes sans numéro de téléphone sont supprimées avant l’importation et comptabilisées séparément sur l’écran de résultat.
  • Prénom / Nom / E-mail correspondent directement aux champs de base du contact.
  • Notes correspond au champ Notes / Profil du prospect du contact.
  • Tags crée (ou réutilise) de vrais tags et les applique au contact — les mêmes tags que ceux utilisés pour filtrer, cibler des diffusions et déclencher des webhooks. Mettez-en plusieurs dans une cellule séparés par des virgules ou des points-virgules. Avant le 19 août 2026, cette colonne était enregistrée sous forme de champ personnalisé nommé tags ; si vous avez importé avant cette date, réimportez le même fichier avec Mettre à jour les contacts existants activé et les tags seront correctement appliqués (le champ personnalisé tags restant ne pose aucun problème ; contactez le support si vous souhaitez qu’il soit supprimé de chaque contact).
  • Il n’existe actuellement aucun mappage de colonne pour les champs personnalisés arbitraires (comme les colonnes custom_<fieldname> classiques) — consultez Chargement en masse des champs personnalisés pour la solution de contournement actuelle.

Conseils

  • Vérifiez que les numéros de téléphone incluent l’indicatif pays. Sans cela, les messages ne seront pas distribués — et les lignes sans numéro de téléphone utilisable sont entièrement ignorées.
  • Vous n’avez pas besoin de supprimer les espaces, tirets ou parenthèses des numéros de téléphone — l’importateur tolère le formatage courant, mais il nécessite toujours l’indicatif pays.
  • Les fichiers sont entièrement analysés dans votre navigateur, il n’y a donc pas de limite de taille de téléchargement fixe imposée par l’assistant lui-même — mais votre nombre total de contacts est toujours plafonné par votre forfait. Si une importation vous fait dépasser la limite de votre forfait, ces lignes sont rejetées et apparaissent sur l’écran de résultat sous la mention contact_limit_reached.
  • Si un contact avec le même numéro de téléphone existe déjà, cette ligne est ignorée par défaut — elle apparaît comme duplicate sur l’écran de résultat. L’importation ne crée jamais de doublon. Pour modifier en masse des contacts que vous avez déjà (corriger des noms ou des e-mails, ajouter des tags, les mettre dans une liste), activez Mettre à jour les contacts existants à l’étape de révision et réimportez le fichier.

Foire aux questions

Mon CSV contient une colonne custom_company provenant d’une ancienne exportation — sera-t-elle mappée correctement ? Pas automatiquement. L’outil de correspondance automatique de l’assistant ne reconnaît que les en-têtes nom/téléphone/e-mail/tags/notes ; tout le reste est défini par défaut sur Ne pas importer, donc une colonne custom_company ne remplira pas le champ personnalisé company d’elle-même. Ajoutez les valeurs ultérieurement via les Champs personnalisés, ou via l’API.

Où est passé le bouton “Télécharger le modèle” ? Il a disparu — l’assistant fonctionne directement avec n’importe quel CSV que vous possédez déjà et vous permet de corriger les colonnes mal appariées lors de l’étape de mappage.

J’ai déjà importé mes contacts — comment ajouter des tags ou corriger des champs pour tous en même temps ? Réimportez le même fichier (ou un fichier mis à jour) avec Mettre à jour les contacts existants activé à l’étape de révision. Les lignes qui correspondent à un numéro de téléphone existant mettent à jour ce contact — nom, e-mail, notes, tags et liste — au lieu d’être ignorées. Seuls les numéros de téléphone sont utilisés pour la correspondance, alors gardez cette colonne exactement telle qu’elle était.

Puis-je importer des contacts Instagram ou Messenger à partir d’un fichier ? Non. L’importation ne prend en charge que WhatsApp Business, WhatsApp Web et les SMS, car ces canaux permettent de joindre les personnes par numéro de téléphone. Instagram et Messenger identifient les personnes par leur compte social ; ces contacts sont donc créés automatiquement lorsqu’une personne vous envoie un message sur ce canal.

Puis-je importer des contacts en tant qu’inactifs pour le bot ? Il n’existe pas de colonne par ligne pour cela. Importez le lot d’abord, puis utilisez l’action en masse Bot désactivé sur les contacts importés — consultez Exclure des contacts du bot IA.

Étapes suivantes