> ## Documentation Index > Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt > Use this file to discover all available pages before exploring further. # Mappage CRM > Synchronisez les champs personnalisés entre Qwoty et votre CRM connecté avec Bidirectionnel, CRM → Qwoty, ou Qwoty → CRM. Si vous avez connecté Qwoty à un CRM (HubSpot, Salesforce, Pipedrive), chaque champ personnalisé sur un objet gérable peut être mappé à un champ CRM. Le mappage détermine la direction dans laquelle les données circulent et quel champ CRM reçoit ou envoie la valeur. Le mappage CRM nécessite une intégration CRM active. Connectez d'abord votre CRM via **Paramètres → Développeurs → Intégration → Nom du CRM**, puis revenez pour mapper les champs personnalisés. ## Emplacement du mappage Le mappage des champs personnalisés est configuré par CRM, dans les paramètres d'intégration : Cliquez sur **Paramètres** dans la barre latérale gauche. Dans la section **Développeurs**, cliquez sur **Intégration**, puis cliquez sur votre CRM connecté (HubSpot, Salesforce, Pipedrive, ou autres). Faites défiler jusqu'à la zone de mappage des champs personnalisés. Chaque champ personnalisé Qwoty sur l'objet synchronisé est listé, préfixé par `Custom:` pour le distinguer des champs système. ## Directions de synchronisation Pour chaque champ personnalisé, vous choisissez l'une des trois directions de synchronisation : | Direction | Ce qu'elle fait | À utiliser quand | | -------------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | **Bidirectionnel** ↔ | Les modifications dans l'un ou l'autre système se propagent vers l'autre | Le champ appartient aux deux systèmes et votre équipe le modifie dans l'un ou l'autre | | **CRM → Qwoty** | Qwoty reçoit les mises à jour du CRM, mais n'en renvoie jamais | Le CRM est la source de vérité (ex. : secteur d'activité du client depuis HubSpot) | | **Qwoty → CRM** | Qwoty envoie les mises à jour vers le CRM, mais ignore les modifications provenant de celui-ci | Qwoty est la source de vérité (ex. : dates d'événements issues des devis qui doivent apparaître dans le CRM) | En cas de doute, commencez par **CRM → Qwoty** (extraction unidirectionnelle). C'est le paramètre le plus sûr car Qwoty n'écrase jamais les données du CRM. Passez en Bidirectionnel uniquement lorsque votre équipe souhaite modifier la valeur dans les deux applications sans avoir à y réfléchir. ## Sélection du champ CRM Chaque ligne de champ personnalisé comporte deux menus déroulants : * **Menu déroulant Direction** — choisissez `Bidirectionnel`, `CRM → Qwoty`, ou `Qwoty → CRM` * **Sélectionner le champ CRM** — choisissez le champ correspondant du côté CRM (seuls les champs de types compatibles sont listés) Les types compatibles suivent ces règles : | Type Qwoty | Types CRM compatibles | | ---------- | --------------------------------------------------------------------------- | | **Texte** | Texte sur une ligne, texte multiligne, liste de sélection, liste déroulante | | **Nombre** | Nombre, entier, décimal, devise (partie numérique uniquement) | | **Date** | Date, date-heure | Si le menu déroulant est vide ou n'affiche pas le champ attendu, vérifiez que le champ CRM existe, que son type est compatible, et que les permissions de l'intégration incluent l'accès en lecture/écriture au champ. ## Fréquence et timing de synchronisation La fréquence de synchronisation de Qwoty dépend de l'intégration : * **Webhooks en temps réel** pour la plupart des CRM modernes (HubSpot, Salesforce) — les modifications se propagent en quelques secondes * **Interrogation périodique** en solution de secours lorsque les webhooks ne sont pas disponibles ou échouent Après l'enregistrement d'un mappage, le prochain cycle de synchronisation prend en compte la nouvelle configuration. Les enregistrements existants commencent à recevoir (ou envoyer) des valeurs selon la nouvelle direction lors de la prochaine synchronisation. ## Lorsque le champ CRM ne contient pas de valeur Si un enregistrement CRM n'a pas de valeur pour le champ mappé, Qwoty reçoit `null` et ne stocke rien — le champ personnalisé apparaît vide sur l'enregistrement. L'inverse est également vrai : si Qwoty n'a pas de valeur et que la direction inclut `→ CRM`, le champ CRM est défini à son état vide. ## Enregistrer les modifications Cliquez sur **Enregistrer les modifications** au bas de la section de mappage pour appliquer votre configuration. Les nouveaux mappages sont pris en compte lors de la prochaine synchronisation. Vous pouvez ajuster les mappages à tout moment sans altérer les données historiques — les valeurs passées restent intactes. ## Modèles de mappage courants | Champ personnalisé | Direction | Pourquoi | | ------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------ | | Secteur d'activité du client | **CRM → Qwoty** | Les commerciaux maintiennent la source de vérité dans le CRM | | Date d'événement (champ personnalisé Devis) | **Qwoty → CRM** | Définie lors de l'établissement du devis, exposée au CRM pour les rapports | | Responsable de compte | **Bidirectionnel** | L'une ou l'autre application peut mettre à jour l'attribution, les deux doivent refléter le changement | | Notes de vente internes | (aucun mappage) | Reste dans Qwoty uniquement — non synchronisé | Tous les champs personnalisés n'ont pas besoin d'un mappage. Laissez le menu déroulant **Sélectionner le champ CRM** vide pour conserver le champ local à Qwoty. ## Voir aussi Obligatoire, Modifiable, Affichage — propriétés qui fonctionnent conjointement avec le mappage CRM. Compatibilité des types entre les champs Qwoty et CRM. Connectez HubSpot, Salesforce ou Pipedrive. Le cas le plus courant pour les champs personnalisés synchronisés avec le CRM.