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. Mappez les 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, l’un de vos champs personnalisés, 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 dont l’en-tête correspond au nom de l’un de vos champs personnalisés est automatiquement associée à ce champ. Les majuscules et les accents n’ont pas d’importance, ainsi une colonne CPF trouvera un champ nommé cpf. Vous pouvez également choisir manuellement n’importe quel champ personnalisé pour n’importe quelle colonne.
    • Une colonne qui ne correspond pas encore à l’un de vos champs personnalisés peut le devenir : choisissez Nouveau champ personnalisé : dans son sélecteur et le champ sera créé lors de l’importation.
    • Si un champ personnalisé a un type (Nombre, Case à cocher, Liste déroulante) et que certaines valeurs de la colonne ne correspondent pas, l’assistant vous avertit du nombre de lignes concernées avant l’importation. Ces lignes sont entièrement ignorées, nom et e-mail inclus. Cliquez sur Passer en Texte sur l’avertissement pour modifier le type du champ en une seule étape, ou corrigez les valeurs, ou réglez la colonne sur Ne pas importer.
    • 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 des tags réels 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. Examen. Choisissez :
    • Canal par défaut — WhatsApp Business, WhatsApp Web ou SMS. Ceci s’applique à tout contact importé qui ne précise pas déjà de canal.
    • Liste — sélectionnez 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. Si vous ouvrez l’importation alors que la page Contacts affiche l’une de vos listes, cette liste est déjà sélectionnée pour vous ; effacez-la si vous ne la voulez pas.
    • Mettre à jour les contacts existants — désactivé par défaut. Si désactivé, les lignes qui correspondent à un contact que vous avez déjà (même numéro de téléphone) sont ignorées en tant que doublons : rien ne change sur ce contact, bien que si vous avez choisi une liste, le contact que vous avez déjà y est tout de même ajouté. Si activé, ces lignes mettent à jour le contact à la place : le nom, l’e-mail et les notes dans votre fichier écrasent ce qui s’y trouve (les cellules vides laissent la valeur actuelle intacte), toutes les étiquettes de la ligne sont ajoutées, 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), combien de contacts que vous aviez déjà ont été ajoutés à la liste que vous avez choisie et, si des lignes ont été ignorées, une explication détaillée des raisons (numéro de téléphone invalide, numéro de téléphone manquant, doublon, limite de contacts atteinte, etc.). Si Mettre à jour les contacts existants était désactivé et que certaines lignes correspondaient à des contacts que vous avez déjà, l’écran de résultat l’indique et propose Mettre à jour ces contacts : un seul clic renvoie uniquement ces lignes avec l’option activée, vous n’avez donc pas besoin d’importer à nouveau le fichier.

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).
  • Champs personnalisés — chacun de vos champs personnalisés est sa propre cible. Un en-tête correspondant au nom d’un champ est sélectionné pour vous ; la valeur est enregistrée sur le contact exactement telle qu’elle apparaît dans le fichier (un champ Nombre, Date, Case à cocher ou Liste déroulante convertit les formats reconnaissables comme 19,99, 01/02/1990 ou yes). Choisissez Nouveau champ personnalisé pour créer un champ à partir d’une colonne. Avec Mettre à jour les contacts existants activé, les valeurs des champs personnalisés dans le fichier mettent également à jour les contacts que vous possédez déjà ; les cellules vides laissent la valeur actuelle inchangée.
  • Une colonne contenant des identifiants avec des points, des tirets ou des zéros non significatifs (un CPF, un numéro fiscal, un code postal) doit être placée dans un champ Texte. Dans un champ Nombre, ces valeurs ne correspondent pas et la ligne est ignorée.

Conseils

  • Vérifiez bien 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’outil d’importation tolère le formatage courant, mais il a tout de même besoin de 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 devait vous faire dépasser la limite de votre forfait, ces lignes sont rejetées et apparaissent sur l’écran de résultat comme 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 deuxième copie d’une personne. Choisir une liste fonctionne toujours sur ces lignes : le contact que vous avez déjà est ajouté à la liste et compté séparément sur l’écran de résultat, donc réimporter le même fichier est la façon de remplir une liste avec des personnes déjà présentes dans votre compte. Pour également actualiser leurs champs (corriger les noms ou e-mails, ajouter des étiquettes), activez Mettre à jour les contacts existants à l’étape Examen et réimportez le fichier.

Foire aux questions

Mon CSV contient une colonne custom_company issue d’une ancienne exportation — sera-t-elle mappée correctement ? Pas automatiquement, car l’en-tête n’est pas exactement company. Choisissez Champ personnalisé : company dans le sélecteur de cette colonne et elle sera importée dans le champ company. Renommer l’en-tête en company avant le téléchargement permet à l’assistant de le faire correspondre pour vous.

Certaines lignes ont été ignorées avec le message « Une valeur de champ personnalisé ne correspond pas au type de ce champ » — pourquoi ? La colonne est mappée sur un champ personnalisé typé (par exemple Nombre) et ces lignes contiennent autre chose, comme 001.576.401-08 dans un champ Nombre. Cliquez sur Passer en Texte sur l’avertissement lors de l’étape de mappage des colonnes (ou modifiez le type dans Champs personnalisés) et importez à nouveau le fichier avec Mettre à jour les contacts existants activé.

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