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

# Comment importer des contacts dans CloudTalk depuis un fichier

> Un guide simple pour importer des contacts dans CloudTalk depuis un fichier Excel/CSV

<Note>
  Dans cet article, nous vous guidons pas à pas pour importer un fichier de contacts dans CloudTalk.
</Note>

**Niveau d'utilisateur** :

* Admin

***

<Warning>
  ⚠️ **L'import de contacts via des fichiers CSV peut prendre un certain temps.** Pour de meilleurs résultats, nous vous recommandons de prévoir un délai de traitement supplémentaire aux heures de pointe.

  Si le délai est critique pour votre import, envisagez d'autres méthodes, comme une intégration CRM ou l'API de CloudTalk pour une synchronisation en temps réel.

  📘 **En savoir plus** : [Comment importer des contacts dans CloudTalk ?](/fr/articles/2145547-how-to-import-contacts-into-cloudtalk)
</Warning>

<h2 id="data-preparation">
  Préparation des données
</h2>

<Warning>
  **Une taille maximale de 8 Mo (généralement \~ 80 000 contacts)** est prise en charge. Les fichiers plus volumineux ne pourront pas être importés.
</Warning>

Pour importer des contacts depuis un fichier, un fichier au format **`.csv`** est actuellement requis. Différents logiciels vous permettent d'enregistrer vos données au format CSV. Dans le cas le plus courant, avec Excel, allez dans **Fichier > Enregistrer comme**. Sous le champ *Nom du fichier*, sélectionnez le **CSV** comme format.

Il est très important de préparer votre fichier CSV conformément à notre **modèle de fichier CSV**. Pour accéder à ce modèle, rendez-vous dans votre compte **[CloudTalk Dashboard](https://dashboard.cloudtalk.io/)** puis accédez à ***Contacts*** *> **Liste** > **Importer des contacts en masse*** et cliquez sur **Télécharger le modèle** en bas à gauche. Notez que vous pouvez supprimer sans risque les colonnes inutilisées du modèle.Si vous devez importer uniquement des informations de base comme **name**, **phone** ou **email**, vous pouvez retirer toutes les autres colonnes sans aucun problème.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/2dadc89fbf39-screenshot-2026-03-18-at-11-36-16.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=7c677bcda4a98521e4afc2be17bbe2fe" alt="" width="1258" height="824" data-path="images/help-center/articles/3422012/2dadc89fbf39-screenshot-2026-03-18-at-11-36-16.png" />
</Frame>

<Info>
  #### Exigences relatives au fichier CSV

  Il est **fortement recommandé** de télécharger et de suivre le modèle. Surtout, veillez à :

  * Écrire tous les noms de colonnes en **minuscules** (les attributs personnalisés peuvent différer)

  * **Éviter les polices spéciales ou le texte stylisé** (par exemple les polices cursives, calligraphiques ou décoratives) dans les noms de contacts ou les autres champs. Elles peuvent empêcher le bon import de votre fichier.

  * Utiliser uniquement des **caractères ASCII standard** dans le nom et le contenu du fichier. Les imports CSV peuvent échouer si des caractères spéciaux ou non ASCII (par ex. ö, ü, ç) sont utilisés.

  * Renseigner les valeurs **`name`** et **`phone`** ou **`email`** pour **chaque contact.**

  Le non-respect de ces consignes peut entraîner des lignes en échec ou des imports incomplets.\
  Certains problèmes (comme des en-têtes ou une structure de fichier incorrects) peuvent empêcher complètement le démarrage de l'import.
</Info>

<Warning>
  **Important : code de pays par défaut**\
  Le pays par défaut défini dans vos **Paramètres du compte** détermine quel indicatif international (`+`) sera automatiquement appliqué aux numéros de téléphone importés qui n'en comportent pas déjà un.

  Avant d'importer votre fichier, vérifiez bien que le pays sélectionné dans **Compte > Paramètres > Code de pays par défaut** correspond au pays des numéros de téléphone de votre CSV.

  Si le pays par défaut est différent, vos numéros risquent d'être importés avec un préfixe international erroné.
</Warning>

<h3 id="h_603d66a186">
  Exemples de colonnes dans votre feuille de calcul
</h3>

<table>
  <tbody>
    <tr>
      <td>
        **Colonne**
      </td>

      <td>
        **Description**
      </td>

      <td>
        **Exemple**
      </td>
    </tr>

    <tr>
      <td>
        `name`
      </td>

      <td>
        Prénom et nom du contact. Ce champ doit contenir au moins un caractère.
      </td>

      <td>
        `Jane Smith`
      </td>
    </tr>

    <tr>
      <td>
        `phone`
      </td>

      <td>
        Les numéros de téléphone peuvent être fournis au format international (E.164) ou au format local. Si un numéro ne comporte pas d'indicatif de pays, CloudTalk applique le code de pays par défaut défini dans les paramètres de votre compte.

        Pour de meilleurs résultats, il est recommandé d'utiliser le format E.164. Vous pouvez indiquer **plusieurs numéros de téléphone** séparés par deux-points (`:`).
      </td>

      <td>
        `+14155550123`

        `0908678545`

        `+14155550123:+12125550189`
      </td>
    </tr>

    <tr>
      <td>
        `email`
      </td>

      <td>
        Adresse e-mail principale. Vous pouvez indiquer **plusieurs adresses e-mail** dans ce champ, séparées par deux-points (`:`).
      </td>

      <td>
        [`jane.smith@company.com`](mailto:jane.smith@company.com)

        [`jane@company.com`](mailto:jane@company.com)`:j.smith@company.com`
      </td>
    </tr>

    <tr>
      <td>
        `email2`
      </td>

      <td>
        Adresse e-mail supplémentaire. Ce champ est conservé pour des raisons de **rétrocompatibilité** avec le système d'origine.
      </td>

      <td>
        [`jane.alt@company.com`](mailto:jane.alt@company.com)
      </td>
    </tr>

    <tr>
      <td>
        `title`
      </td>

      <td>
        Intitulé de poste du contact.
      </td>

      <td>
        `Head of Sales`
      </td>
    </tr>

    <tr>
      <td>
        `company`
      </td>

      <td>
        Nom de l'entreprise à laquelle appartient le contact.
      </td>

      <td>
        `Acme Corp`
      </td>
    </tr>

    <tr>
      <td>
        `address`
      </td>

      <td>
        Adresse du contact.
      </td>

      <td>
        `Main Street 1, San Francisco`
      </td>
    </tr>

    <tr>
      <td>
        `favorite_agent`
      </td>

      <td>
        Adresse e-mail d'un agent CloudTalk à attribuer comme agent favori du contact. Si l'e-mail correspond à un agent existant, l'agent est attribué. Si aucune correspondance n'est trouvée, l'import de cette ligne échoue.
      </td>

      <td>
        [`agent@company.com`](mailto:agent@company.com)
      </td>
    </tr>

    <tr>
      <td>
        `tag`
      </td>

      <td>
        Une ou plusieurs étiquettes à attribuer au contact. Les étiquettes multiples doivent être séparées par deux-points (`:`). Les étiquettes existantes sont réutilisées ; les nouvelles étiquettes sont créées automatiquement si elles n'existent pas.
      </td>

      <td>
        `coldlead:webinar:priority`
      </td>
    </tr>

    <tr>
      <td>
        Attributs personnalisés
      </td>

      <td>
        Tous les champs supplémentaires que vous souhaitez importer. Ils doivent d'abord être créés en tant qu'attributs personnalisés dans les Paramètres du compte, et les noms de colonnes doivent correspondre exactement.
      </td>

      <td>
        `industry` → `Santé`
      </td>
    </tr>
  </tbody>
</table>

<h4 id="h_fe7c42c7f4">
  Colonne country (formats pris en charge)
</h4>

Si votre fichier CSV comporte une colonne `country`, CloudTalk accepte plusieurs formats de pays pour faciliter les imports.

Vous pouvez utiliser :

* **Des codes pays à deux lettres**, par exemple : `US`, `GB`, `DE`

* **Des codes pays à trois lettres**, par exemple : `USA`, `FRA`, `DEU`

* **Des noms de pays complets en anglais**, par exemple : `United States`, `Germany`, `France`

* **Des variantes courantes et non ambiguës**, par exemple : `United States of America`, `Great Britain`, `Trinidad & Tobago`

CloudTalk normalise automatiquement les différences de format les plus courantes, notamment :

* les valeurs en majuscules et en minuscules

* les espaces superflus avant, après ou à l'intérieur de la valeur

* l'utilisation de `&` à la place de `and` (et inversement)

Si la valeur du pays ne peut pas être reconnue, la ligne échoue avec un message d'erreur clair indiquant une valeur de pays non valide.

<h4 id="h_202c0f0772">
  Attributs personnalisés
</h4>

Pour que les champs de contact supplémentaires de votre fichier CSV s'affichent correctement sur les contacts, vous devez les ajouter en tant qu'*[attributs personnalisés](/fr/articles/2144934-custom-attributes)* dans les paramètres de votre Dashboard.

1. Depuis le Dashboard, accédez à **Compte > Paramètres**.

2. Dans l'onglet *Paramètres généraux*, faites défiler jusqu'à la section *Contacts*.

3. C'est ici que vous pouvez ajouter vos noms de champs personnalisés en sélectionnant `+ Ajouter un attribut personnalisé`. Assurez-vous que les noms saisis ici correspondent à ceux de votre CSV, tant pour l'orthographe que pour la casse.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/4850012ef211-screenshot-2024-12-13-at-16-49-46.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=a015e03e061b2611efa613f935921644" alt="" width="2155" height="598" data-path="images/help-center/articles/3422012/4850012ef211-screenshot-2024-12-13-at-16-49-46.png" />
</Frame>

<h2 id="importing-contacts-from-a-file">
  Importer des contacts depuis un fichier
</h2>

Une fois le fichier CSV complété et enregistré au bon format, il est prêt à être importé.

1. Allez dans **Contacts > Liste > Importer des contacts en masse.**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/f91509de118b-screenshot-2026-01-08-at-15-43-57.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=0eec35d6d5fb6ceea39b5c54d7e61384" alt="" width="350" data-path="images/help-center/articles/3422012/f91509de118b-screenshot-2026-01-08-at-15-43-57.png" />
   </Frame>

2. Importez le fichier CSV.

3. **Étiquetez vos contacts** : créez une étiquette servant d'identification pour les contacts que vous importez. Cette étiquette est importante pour les [campagnes du Numéroteur](/fr/articles/8428838-setting-up-campaigns-legacy-dialer) et peut servir à filtrer les contacts.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/1439c01d7f67-screenshot-2024-12-13-at-14-32-52.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=5e302a417b9525143b19e4db27742204" alt="" width="330" data-path="images/help-center/articles/3422012/1439c01d7f67-screenshot-2024-12-13-at-14-32-52.png" />
   </Frame>

4. Sélectionnez `Confirmer` pour démarrer l'import.

Une fois le fichier envoyé, l'import apparaît dans **Contacts > Fichiers importés**, où vous pouvez suivre sa progression et consulter les résultats.

<h3 id="h_8ecaab147c">
  Fichiers importés
</h3>

CloudTalk conserve un historique clair de tous les imports CSV afin que vous puissiez facilement suivre ce qui s'est passé, repérer les problèmes et les corriger sans contacter le support.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/fb7aedb0243a-screenshot-2026-01-08-at-17-01-15.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=3d5d8da94cc5adcf32045b1a36a8b883" alt="" width="2398" height="488" data-path="images/help-center/articles/3422012/fb7aedb0243a-screenshot-2026-01-08-at-17-01-15.png" />
</Frame>

Lorsque vous ouvrez une tâche d'import, CloudTalk affiche un détail complet, notamment :

* Le nombre total de lignes du fichier

* Le nombre de contacts importés avec succès

* Le nombre de contacts en échec (le cas échéant)

* Un statut ligne par ligne avec des messages de résultat clairs. Chaque ligne en échec comporte une raison précise expliquant pourquoi le contact n'a pas pu être importé.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/661d3101fb1a-screenshot-2026-01-08-at-14-47-34.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=83f8e6224f56f95c8f949e3db3f1e927" alt="" width="2852" height="1139" data-path="images/help-center/articles/3422012/661d3101fb1a-screenshot-2026-01-08-at-14-47-34.png" />
</Frame>

<h2 id="h_bb7f784856">
  Que se passe-t-il en cas d'échec d'un import
</h2>

<h3 id="h_3e4dc60c74">
  Erreurs globales d'import
</h3>

Si l'import échoue avant le traitement des lignes, un message d'erreur global vous en indique la raison, par exemple :

* Le fichier n'a pas pu être chargé

* Panne de service temporaire (elle se résout généralement d'elle-même après un court délai. Si le problème persiste ou se reproduit plusieurs fois en quelques heures, le [support CloudTalk](mailto:support@cloudtalk.io) peut vous aider à approfondir l'analyse)

* La taille du fichier dépasse 8 Mo

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/fb6879d5840a-screenshot-2026-03-18-at-15-45-34.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=b108cea23b1f53953bc1068920aacff3" alt="" width="500" data-path="images/help-center/articles/3422012/fb6879d5840a-screenshot-2026-03-18-at-15-45-34.png" />
</Frame>

<h3 id="h_21e352821e">
  Imports partiels
</h3>

CloudTalk ne rejette plus l'intégralité du fichier à cause d'un seul contact non valide.

* Les contacts valides sont importés correctement

* Les contacts non valides sont marqués comme **Échoué**

* Un import ayant ce résultat s'affiche avec un **statut « Terminé » orange**, indiquant que l'import s'est achevé mais que certaines lignes ont échoué.

* Si trop de lignes échouent (le seuil est de **1000** enregistrements en échec), l'import peut s'arrêter pour éviter des données incorrectes.

Vous pouvez télécharger le rapport d'erreurs, corriger uniquement les lignes en échec et les réimporter.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3422012/2b0125eb2640-screenshot-2026-01-08-at-15-10-53.png?fit=max&auto=format&n=6Hiy83aLw1wFZVvu&q=85&s=2ea927d02e569d430aa07eaecfcfe2a5" alt="" width="2416" height="1176" data-path="images/help-center/articles/3422012/2b0125eb2640-screenshot-2026-01-08-at-15-10-53.png" />
</Frame>

<h3 id="h_f4f028935e">
  Comment corriger les lignes en échec
</h3>

1. Ouvrez **Contacts > Fichiers importés**

2. Cliquez sur **Voir les détails** pour l'import en échec

3. Consultez la raison de l'échec pour chaque contact

4. Téléchargez le rapport d'erreurs (s'il est disponible)

5. Corrigez uniquement les lignes en échec dans votre CSV

6. Réimportez le fichier corrigé

<h3 id="h_9a3fafc70c">
  Liste des erreurs de lignes en échec et comment les résoudre
</h3>

<table>
  <tbody>
    <tr>
      <td>
        **Nom de l'erreur**
      </td>

      <td>
        **Description**
      </td>

      <td>
        **Comment corriger**
      </td>
    </tr>

    <tr>
      <td>
        `The value X in column Y is not a valid phone number.`

        `[phone, columnIndex]`
      </td>

      <td>
        Le numéro n'est pas un numéro de téléphone local ou international valide.
      </td>

      <td>
        Saisissez un numéro de téléphone valide, soit au format international (par ex. `+14155550123`), soit au format local avec un pays par défaut correctement défini.
      </td>
    </tr>

    <tr>
      <td>
        `The value X in column Y is not a valid email address.`

        `[email, columnIndex]`
      </td>

      <td>
        La valeur fournie n'est pas une adresse e-mail valide.
      </td>

      <td>
        Saisissez une adresse e-mail au format valide (par ex. [firstName\_lastName@gmail.com](mailto:firstName_lastName@gmail.com))
      </td>
    </tr>

    <tr>
      <td>
        `The [columnName] value in column 1 is required.`
      </td>

      <td>
        Une colonne obligatoire est manquante ou vide.
      </td>

      <td>
        Vérifiez qu'il n'y a pas d'espaces superflus dans les en-têtes de colonnes et assurez-vous que les colonnes obligatoires sont correctement nommées et renseignées.
      </td>
    </tr>

    <tr>
      <td>
        `The X value in column Y is required.`

        `[fieldName, columnIndex]`
      </td>

      <td>
        Vous essayez d'importer le contact sans numéro de téléphone ni adresse e-mail.

        Le champ **`phone`** ou **`email`** est obligatoire pour que CloudTalk puisse importer ce contact.
      </td>

      <td>
        Vérifiez le contact et assurez-vous qu'au moins un identifiant valide (numéro de téléphone au format E.164 ou adresse e-mail) est renseigné.
      </td>
    </tr>

    <tr>
      <td>
        `The provided X value in column Y exceeds the maximum length of N characters.`

        `[fieldName, columnIndex, max]`
      </td>

      <td>
        Le nombre maximal de caractères autorisé pour une colonne a été dépassé.
      </td>

      <td>
        Raccourcissez la valeur pour qu'elle respecte la limite de caractères autorisée pour ce champ.
      </td>
    </tr>

    <tr>
      <td>
        `The provided X value in column Y must be at least N characters long.`

        `[fieldName, columnIndex, max]`
      </td>

      <td>
        Le nombre de caractères fourni est inférieur à la longueur minimale requise.
      </td>

      <td>
        La colonne **`name`** doit contenir au moins 1 caractère. Ce champ est obligatoire.

        Tous les autres champs (comme **`company`**, **`website`**, **`title`**, **`industry`**, **`address`**, **`city`**, **`zip`**, etc.) sont facultatifs.

        Si un champ facultatif est laissé vide, aucune valeur ne sera importée pour ce champ.
      </td>
    </tr>

    <tr>
      <td>
        `The value X in column Y is not a valid website address.`

        `[columnName]`
      </td>

      <td>
        La valeur de la colonne website n'est pas une adresse de site web valide.
      </td>

      <td>
        Vérifiez et réimportez une adresse de site web valide.
      </td>
    </tr>

    <tr>
      <td>
        `The value X in column Y is invalid.`

        `[displayFieldName, columnIndex]`
      </td>

      <td>
        Il s'agit d'une erreur générique. La valeur de la colonne n'est pas valide.
      </td>

      <td>
        Vérifiez la valeur de ce contact et corrigez les erreurs évidentes. Si vous ne savez pas comment la corriger, contactez notre [équipe support](mailto:support@cloudtalk.io).
      </td>
    </tr>
  </tbody>
</table>

<h4 id="h_fae39d618e">
  Longueur maximale des caractères
</h4>

| Champ | Nombre maximal de caractères |
| - | - |
| `name` | 150 |
| `zip` | 15 |
| `title` | 255 |
| `company` | 100 |
| `industry` | 100 |
| `website` | 100 |
| `address` | 255 |
| `city` | 255 |

Si une valeur dépasse la longueur maximale, réduisez le nombre de caractères et réimportez le fichier.

Tous les autres champs sont facultatifs. Si un champ facultatif est laissé vide, aucune valeur ne sera importée pour ce champ.

<Warning>
  Si vous rencontrez encore des problèmes après avoir corrigé les lignes en échec, ou si vous souhaitez de l'aide sur d'autres symptômes d'import, consultez ces guides de dépannage :

  * **[Import CSV bloqué](/fr/articles/12958920-csv-import-stuck)** – explique pourquoi un import peut rester longtemps *En cours de traitement*, quand c'est normal et quand il faut agir.

  * **[L'import du fichier CSV échoue](/fr/articles/12930295-upload-of-csv-file-fails)** – passe en revue les problèmes courants de format et de structure (comme l'encodage, des en-têtes manquants ou de mauvais séparateurs) et explique comment les résoudre.
</Warning>

***

*Besoin d'aide ou une question ?* Contactez-nous simplement via notre [Portail Support](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — nous sommes là pour vous.


## Related topics

- [Comment importer des contacts dans CloudTalk](/fr/articles/2145547-how-to-import-contacts-into-cloudtalk.md)
- [Échec de l'import d'un fichier CSV](/fr/articles/12930295-upload-of-csv-file-fails.md)
- [Étape de deal Pipedrive : automatisation Zapier](/fr/articles/5724062-pipedrive-deal-stage-zapier-automation.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.