> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Importer des contacts

> Importez des contacts dans Audience depuis un fichier CSV, avec mappage de colonnes et validation

L'import CSV est le moyen le plus rapide d'ajouter de nombreux contacts en une fois — que vous partiez d'une liste neuve ou que vous complétiez Audience à partir d'un export de tableur.

## Préparer votre fichier

* **CSV uniquement** (pas Excel), encodé en UTF-8, jusqu'à 12 Mo.
* Séparé par des virgules ou des points-virgules — Famulor détecte lequel à partir de la première ligne, si bien que les exports de tableurs européens fonctionnent tels quels.
* Une ligne d'en-tête est fortement recommandée : Famulor s'en sert pour pré-associer les colonnes évidentes. Un fichier sans en-tête s'importe quand même ; les colonnes sont alors simplement nommées Column 1, Column 2, etc.
* Chaque ligne a besoin d'un numéro de téléphone. Tout le reste — nom, e-mail, tags, champs personnalisés — est facultatif.

```csv theme={null}
phone,name,email,tags,company
+491701234567,Ada Lovelace,ada@example.com,vip;renewal,TechStart Solutions
+14155551234,Grace Hopper,grace@example.com,,Acme Corp
```

## Étapes d'import

Sélectionnez **Import** dans Audience. Le guide d'import comporte trois étapes.

<Steps>
  <Step title="Upload File">
    Glissez votre CSV ou sélectionnez-le depuis le disque. Il vous sera demandé de certifier que ces contacts ont consenti à être contactés et ne proviennent pas d'une liste achetée — c'est votre responsabilité, Famulor ne le valide pas à votre place.
  </Step>

  <Step title="Match Columns">
    Associez chaque colonne à une cible : un champ de contact (**Phone**, **Name**, **Email**, **Tags**), une variable d'assistant (lors d'un import direct dans une campagne avec un assistant assigné), un **attribut personnalisé** de l'espace de travail, ou une clé personnalisée libre. Les correspondances évidentes — une colonne littéralement nommée « phone » ou « email » — sont présélectionnées ; vérifiez et ajustez le reste, et réglez tout ce dont vous n'avez pas besoin sur **Ignore this column**.

    Cette étape porte aussi deux réglages pour l'ensemble du lot. **Default country for phone numbers** est ajouté à tout numéro qui n'inclut pas déjà d'indicatif pays (`01701234567` → `+491701234567`), pour ne pas avoir à scinder votre fichier par pays au préalable. **Tags** ajoute les mêmes tags à chaque contact du lot.
  </Step>

  <Step title="Preview">
    Vérifiez les cinq premiers contacts mappés, contrôlez les compteurs **Ready to import** et **Skipped (invalid phone)**, puis confirmez.
  </Step>
</Steps>

## Où atterrissent les contacts importés

Un import depuis **Audience** crée des contacts non assignés, disponibles pour toutes les campagnes et tous les segments de l'espace de travail. Le même bouton **Import** se trouve aussi sur la page propre à une campagne — utilisé là, il ajoute directement les contacts à la file d'attente de cette campagne au lieu de les laisser non assignés.

<Tip>
  Pour ajouter des contacts Audience déjà existants à une campagne au lieu de les réimporter, utilisez **Assign leads** sur la campagne — choisissez un segment enregistré ou sélectionnez des contacts un par un. Voir [Configurer une campagne](/fr/campaigns/overview#configurer-une-campagne).
</Tip>

## Référence de mappage des colonnes

| Cible                    | Provenance des valeurs                                                                                                             |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| Phone, Name, Email, Tags | Champs de contact intégrés. Une colonne **Tags** peut contenir plusieurs tags séparés par des virgules ou des points-virgules      |
| Variable d'assistant     | Proposée uniquement lors d'un import dans une campagne avec un assistant assigné                                                   |
| Attribut personnalisé    | Champs définis par l'espace de travail sous **Settings → Workspace → Custom Attributes**                                           |
| Clé personnalisée        | Libre : lettres minuscules, chiffres et tirets bas, en commençant par une lettre. `phone`, `name`, `email` et `tags` sont réservés |

## Garder des données propres

* Préférez le format téléphonique E.164 (`+491701234567`) aux formats locaux (`0170 123 4567`, `(030) 123-4567`) — cela lève toute ambiguïté sur le pays.
* Enregistrez le fichier en CSV UTF-8. Si vous exportez depuis Excel, convertissez les formules en valeurs et évitez les cellules fusionnées avant d'enregistrer.
* **Dédupliquez avant d'importer.** Les numéros de téléphone et adresses e-mail sont uniques par espace de travail, et un import ne fusionne pas avec les fiches existantes comme le fait le formulaire de contact unique — une ligne dont le téléphone ou l'e-mail appartient déjà à un contact échoue à la place. Retirez d'abord ces lignes du fichier, ou mettez à jour ces contacts individuellement dans Audience.
* Donnez à chaque lot d'import un tag commun (par exemple `import-2026-08`) à l'étape Match Columns, pour pouvoir retrouver ce lot dans Audience par la suite.

## Dépannage

| Symptôme                                               | Solution                                                                                                                                                                                                                                         |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| L'import est rejeté d'emblée                           | Le fichier doit être en `.csv`, encodé en UTF-8, et faire 12 Mo ou moins — Excel (`.xlsx`) n'est pas pris en charge ; exportez ou enregistrez d'abord en CSV                                                                                     |
| Aucun contact importé                                  | Vérifiez qu'une colonne est associée à **Phone** — une ligne sans numéro de téléphone valide est toujours ignorée                                                                                                                                |
| Moins de contacts que de lignes dans le fichier        | Vérifiez le compteur **Skipped (invalid phone)** à l'étape d'aperçu ; ces lignes avaient un numéro de téléphone qui n'a pas pu être interprété                                                                                                   |
| L'import s'arrête avec une erreur d'identité en double | Le téléphone ou l'e-mail d'une ligne appartient déjà à un autre contact de cet espace de travail. Retirez les lignes en double et réimportez — les contacts déjà créés avant l'échec sont conservés                                              |
| Un mauvais indicatif pays a été ajouté                 | Seuls les numéros sans indicatif pays reçoivent le pays par défaut — définissez le bon pays par défaut avant de confirmer, ou corrigez ces numéros pour inclure `+<indicatif pays>` dans le fichier                                              |
| Une clé personnalisée est rejetée                      | Les clés doivent être composées de lettres minuscules, de chiffres et de tirets bas, en commençant par une lettre. `phone`, `name`, `email` et `tags` sont réservés ; renommez la colonne ou choisissez plutôt un attribut personnalisé existant |

Voir aussi [Contacts](/fr/audience/contacts) pour modifier et fusionner des fiches après import, et [Campagnes et leads](/fr/campaigns/overview) pour affecter des contacts à vos actions de prospection.