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

# Migration depuis d'autres CRM

> Guide pas à pas pour migrer vos données de n'importe quel CRM vers Twenty.

## Vue d'ensemble

Ce guide vous accompagne pour migrer vos données depuis n'importe quel CRM vers Twenty. Le processus consiste à auditer vos données, à préparer votre espace de travail sur Twenty, à exporter depuis votre système actuel et à importer dans Twenty.

<Note>Les vues, les flux de travail et les autorisations doivent être recréés manuellement après la migration. Prévoyez du temps pour ce travail de configuration.</Note>

## Étape 1 : Auditez vos données actuelles

La migration est une occasion de repartir sur de bonnes bases. N'importez pas de données superflues.

**À conserver :**

* Contacts et entreprises actifs
* Opportunités et affaires ouvertes
* Notes et activités importantes
* Champs personnalisés que vous utilisez réellement

**À laisser de côté :**

* Contacts obsolètes (aucune activité depuis plus de 2 ans)
* Doublons
* Données de test
* Champs personnalisés inutilisés

## Étape 2 : Cartographiez votre modèle de données

Créez un document de correspondance entre votre CRM actuel et Twenty :

| Votre CRM             | Twenty                 |
| --------------------- | ---------------------- |
| Compte / Organisation | **Entreprise**         |
| Contact / Personne    | **Personnes**          |
| Affaire / Opportunité | **Opportunité**        |
| Activité              | **Tâche** ou **Note**  |
| Objet personnalisé    | **Objet personnalisé** |

**Pour chaque champ, documentez :**

* Le nom du champ source
* Le champ Twenty cible
* Toute transformation de format nécessaire (dates, numéros de téléphone, etc.)

<Note>Gardez ce document de mappage à portée de main pendant l'importation — vous vous y référerez lors de la mise en correspondance des colonnes.</Note>

## Étape 3 : Configurez votre espace de travail Twenty

Avant d'importer des données, préparez votre espace de travail Twenty :

### Créez des objets et des champs personnalisés

1. Allez dans **Paramètres → Modèle de données**
2. Créez tous les objets personnalisés dont vous avez besoin
3. Ajoutez des champs personnalisés aux objets standard et personnalisés
4. Configurez les paramètres des champs (unique, obligatoire, options de sélection, etc.)

<Warning>
  **Les champs doivent exister avant l'importation.**

  L'import CSV crée des enregistrements, pas des champs. Créez tous les champs personnalisés dans **Paramètres → Modèle de données** avant l'importation.
</Warning>

### Invitez votre équipe

<Warning>
  **Invitez les utilisateurs AVANT d'importer des données.**

  Si vos données incluent des références à des utilisateurs (propriétaire du compte, assigné, etc.), ces utilisateurs doivent exister dans Twenty avant l'importation. Sinon, ces relations ne pourront pas être mises en correspondance.
</Warning>

1. Allez dans **Paramètres → Membres**
2. Invitez tous les membres de l'équipe
3. **Attendez que tout le monde accepte** son invitation
4. Vérifiez que tous les utilisateurs apparaissent dans votre liste des membres

## Étape 4 : Exportez depuis votre CRM actuel

Exportez vos données depuis votre CRM actuel :

1. Recherchez une fonction **Export** (généralement dans Paramètres, Gestion des données ou Admin)
2. Exportez au **format CSV** lorsque c'est possible
3. Exportez chaque type d'objet séparément (Entreprises, Contacts, Affaires, etc.)
4. Incluez tous les champs que vous souhaitez migrer

**Exportez ces objets (dans cet ordre à titre de référence) :**

1. Entreprises / Comptes / Organisations
2. Contacts / Personnes
3. Affaires / Opportunités
4. Notes et activités
5. Objets personnalisés

## Étape 5 : Nettoyez et mettez en forme vos données

Ouvrez chaque CSV exporté dans une application de tableur et préparez-le pour Twenty.

### Supprimez les doublons

1. Triez par le champ unique (e-mail pour les Personnes, domaine pour les Entreprises)
2. Supprimez ou fusionnez les lignes en double
3. Vérifiez qu'il n'existe pas déjà de doublons dans Twenty

### Formatez correctement les champs

| Type de champ           | Format requis                                         |
| ----------------------- | ----------------------------------------------------- |
| **Domaine**             | `https://domain.com`                                  |
| **Email**               | `name@domain.com` (doit être unique)                  |
| **Date**                | `YYYY-MM-DD`                                          |
| **Téléphone**           | Trois colonnes : numéro, code pays, indicatif d'appel |
| **Booléen**             | `TRUE` ou `FALSE` (majuscules)                        |
| **Champs de sélection** | Utilisez les noms d'API, pas les libellés d'affichage |

<Warning>
  **Le format du domaine est critique.**

  Utilisez `https://domain.com` (pas `domain.com` ni `www.domain.com`). Cela correspond au format de Twenty et évite les doublons lorsque vous connectez la synchronisation e-mail/calendrier.
</Warning>

Voir [Comment préparer vos fichiers CSV](/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files) pour connaître les exigences complètes de formatage pour tous les types de champs.

### Ajoutez des colonnes de relation

Pour lier des enregistrements (par exemple, des Personnes à des Entreprises), ajoutez une colonne avec l'identifiant unique de l'entité parente.

**Exemple : CSV Personnes avec lien vers l'Entreprise**

```csv theme={null}
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```

Voir [Comment importer des relations](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) pour des instructions détaillées sur la liaison des enregistrements.

### Mettez à jour les références utilisateur

Si vos données incluent des attributions d'utilisateur (propriétaire, assigné) :

1. Ajoutez une colonne avec l'**e-mail de l'utilisateur** (pas seulement son ID de l'ancien système)
2. Utilisez les mêmes adresses e-mail que celles utilisées par les utilisateurs pour rejoindre votre espace de travail Twenty

Voir [Comment préparer vos fichiers CSV](/l/fr/user-guide/data-migration/how-tos/prepare-your-csv-files) pour un guide de formatage complet.

## Étape 6 : Importez dans Twenty

<Warning>
  **L'ordre d'importation est important !**

  Importez toujours dans cet ordre :

  1. **Entreprises** d'abord (aucune dépendance)
  2. **Personnes** ensuite (liées aux Entreprises)
  3. **Opportunités** en troisième (liées aux Entreprises/Personnes)
  4. **Notes et tâches** (liées aux enregistrements)
  5. **Objets personnalisés** en suivant leurs dépendances

  L'enregistrement parent doit exister avant que vous puissiez y faire référence.
</Warning>

### Importez chaque objet

Pour chaque fichier CSV, dans l'ordre :

1. Accédez à l'objet dans Twenty
2. Cliquez sur **⋮ → Importer des enregistrements**
3. Téléversez le fichier CSV
4. Faites correspondre les colonnes aux champs :
   * Faites correspondre les colonnes d'e-mail des utilisateurs aux champs de relation appropriés
   * Faites correspondre les colonnes de relation (comme `companyDomain`) aux champs de relation
5. Examinez et corrigez les erreurs éventuelles dans l'interface
6. Confirmez l'importation
7. Vérifiez quelques enregistrements avant de passer au fichier suivant

**Guides détaillés :**

* [Comment importer des entreprises](/l/fr/user-guide/data-migration/how-tos/import-companies-via-csv)
* [Comment importer des contacts](/l/fr/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [Comment importer des relations](/l/fr/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)

## Étape 7 : Grandes migrations (50 000+ enregistrements)

Pour les grandes migrations :

| Volume                          | Approche recommandée                  |
| ------------------------------- | ------------------------------------- |
| Moins de 10 000 enregistrements | Importation CSV unique                |
| 10 000 - 50 000 enregistrements | Fractionnez en plusieurs fichiers CSV |
| 50 000+ enregistrements         | Utilisez l'API                        |

**Pour les importations via l'API :**

* Plus rapide et plus fiable pour les grands jeux de données
* Prend en charge les opérations par lots (jusqu'à 60 enregistrements par appel)
* Voir [Comment importer des données via l'API](/l/fr/user-guide/data-migration/how-tos/import-data-via-api)

## Étape 8 : Configuration post-migration

Après l'importation des données, terminez la configuration de votre espace de travail :

### Recréez les vues

* Configurez des vues enregistrées avec des filtres, des tris et des configurations de colonnes
* Créez toutes les vues kanban ou calendrier dont vous avez besoin

### Recréez les workflows

* Recréez vos automatisations dans **Paramètres → Flux de travail**
* Commencez par les flux de travail les plus critiques
* Testez chacun d'eux avant de vous y fier

### Configurez les rôles et les autorisations

* Configurez les rôles dans **Paramètres → Rôles**
* Affectez les utilisateurs aux rôles appropriés

### Connectez les e-mails et le calendrier

* Chaque utilisateur connecte son propre compte dans **Paramètres → Comptes**
* Twenty commencera à synchroniser les e-mails avec les enregistrements de contacts
* Voir [E-mails et calendrier](/l/fr/user-guide/calendar-emails/overview)

### Formez votre équipe

* Parcourez ensemble la nouvelle interface
* Documentez tous les processus spécifiques à l'équipe

## Problèmes Courants et Solutions

| Problème                           | Cause                                      | Solution                                                                                                             |
| ---------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| **Erreurs de doublons**            | L'e-mail/le domaine existe déjà            | Supprimez les doublons du fichier, ou incluez un identifiant unique pour mettre à jour les enregistrements existants |
| **Relation introuvable**           | L'enregistrement parent n'existe pas       | Importez d'abord les objets parents (Entreprises avant Personnes)                                                    |
| **Champs manquants**               | Le champ personnalisé n'existe pas         | Créez le champ dans **Paramètres → Modèle de données** avant l'importation                                           |
| **Erreurs de champs de sélection** | Utilisation de libellés d'affichage        | Utilisez les noms d'API (activez le mode avancé dans Paramètres pour les trouver)                                    |
| **Relation utilisateur vide**      | L'utilisateur n'a pas accepté l'invitation | Assurez-vous que tous les utilisateurs acceptent les invitations avant d'importer                                    |

Voir [Comment corriger les erreurs d'importation](/l/fr/user-guide/data-migration/how-tos/fix-import-errors) pour des étapes détaillées de dépannage.

## Liste de vérification post-migration

### Intégrité des données

<Check>Tous les enregistrements importés (comparez les nombres avec le système source)</Check>
<Check>Relations fonctionnant correctement (Personnes liées aux Entreprises)</Check>
<Check>Attributions utilisateur correctement mises en correspondance (Propriétaire, Assigné)</Check>
<Check>Champs personnalisés renseignés</Check>
<Check>Aucun doublon inattendu</Check>

### Configuration

<Check>Vues recréées</Check>
<Check>Flux de travail recréés et testés</Check>
<Check>Rôles et autorisations configurés</Check>
<Check>Synchronisation e-mail/calendrier connectée</Check>

### Préparation de l'équipe

<Check>Équipe formée au nouveau système</Check>
<Check>Plan d'accès à l'ancien CRM décidé (le conserver comme référence ? Quand le désactiver ?)</Check>

## FAQ

<AccordionGroup>
  <Accordion title="Puis-je migrer les flux de travail automatiquement ?">
    Pas pour le moment. Les flux de travail doivent être recréés manuellement dans Twenty.
  </Accordion>

  <Accordion title="Qu'en est-il des pièces jointes ?">
    Les pièces jointes ne sont pas incluses dans les exportations CSV. Vous devrez les téléverser à nouveau manuellement, les migrer via l'API ou contacter notre équipe pour obtenir de l'aide.
  </Accordion>

  <Accordion title="Puis-je garder les deux systèmes actifs pendant la migration ?">
    Oui, nous recommandons de garder votre ancien CRM actif jusqu'à ce que vous ayez vérifié que la migration est terminée. Veillez simplement à ne pas créer de nouvelles données aux deux endroits.
  </Accordion>

  <Accordion title="Combien de temps la migration prend-elle généralement ?">
    Cela dépend du volume et de la complexité des données. Les petites migrations (moins de 10 000 enregistrements) peuvent être effectuées en quelques heures. Les grandes migrations peuvent prendre plusieurs jours, y compris le nettoyage des données et les tests.
  </Accordion>
</AccordionGroup>

## Besoin d'aide ?

Pour des migrations complexes ou de grands jeux de données :

* **Configuration guidée :** Réservez un forfait d'intégration de 4 heures
* **Service de migration complet :** Nos partenaires peuvent prendre en charge l'intégralité de la migration

Contactez [contact@twenty.com](mailto:contact@twenty.com) ou découvrez nos [services de mise en œuvre](/l/fr/user-guide/getting-started/capabilities/implementation-services).
