Skip to main content
Un champ personnalisé Client capture des attributs spécifiques à votre base de comptes — par exemple, un type de client, un identifiant réglementaire, une attribution de responsable de compte ou une région commerciale. Le champ apparaît sur chaque fiche client, peut être filtré dans les vues clients et, surtout, se synchronise avec votre CRM, où résident généralement les données maîtres clients. Ce guide décrit le cycle de vie complet en trois étapes.
Vous devez disposer du rôle Admin avec l’autorisation Données → Lecture & Écriture. Le mapping CRM nécessite également l’accès Développeurs.

​
Ce que vous allez construire

Dans cet exemple, vous allez ajouter deux champs personnalisés utilisés pour qualifier les clients : Les deux seront modifiables par les commerciaux, non affichés au client (ce sont des qualificatifs internes, pas des données visibles par l’acheteur), et synchronisés de manière bidirectionnelle avec votre CRM car les données maîtres clients sont partagées entre les deux systèmes.

​
Étape 1 : Créer le champ dans le modèle de données

1

Ouvrir le modèle de données

Accédez à Paramètres → Données → Modèle de données et cliquez sur l’objet Client.
2

Cliquer sur + Nouveau

En haut à droite de la liste des champs, cliquez sur + Nouveau pour ouvrir le formulaire de création de champ.
3

Renseigner les informations générales pour Type de client

  • Nom : Type de client
  • Nom API : Qwoty génère customer_type. Modifiez-le si vous avez besoin d’un identifiant différent.
  • Type de données : sélectionnez Texte
4

Enregistrer et recommencer

Cliquez sur Enregistrer, puis créez Numéro de TVA avec le type Texte de la même manière.
Deux nouveaux champs apparaissent dans la liste des champs de l’objet Client avec le badge Personnalisé.

​
Étape 2 : Configurer le champ sur le client

Comme pour le Produit, les champs personnalisés Client apparaissent sur chaque fiche client une fois activés — ils ne sont pas conditionnés par un modèle.
1

Ouvrir un client

Accédez à Clients et ouvrez n’importe quelle fiche client (ou créez-en une nouvelle). Les nouveaux champs apparaissent dans la vue détaillée du client.
2

Trouver la section Champs personnalisés

Faites défiler jusqu’à la section Champs personnalisés. Les deux champs apparaissent avec un bouton bascule et trois cases à cocher.
3

Activer le bouton bascule

Cliquez sur le bouton bascule de chaque champ pour l’activer.
4

Configurer les propriétés

Pour notre cas d’usage de qualification client :
  • Obligatoire : cochez pour Type de client (la segmentation doit toujours être renseignée), décochez pour Numéro de TVA (pertinent uniquement pour le B2B / transfrontalier)
  • Modifiable par le commercial ✓ — les commerciaux maintiennent les qualifications clients lors de l’intégration
  • Afficher au client — laissez décoché. Ces champs sont internes — le client n’a pas besoin de voir comment vous le qualifiez
5

Définir les valeurs par client

Saisissez les valeurs pour les clients existants, ou importez les données via CSV si vous en avez beaucoup. Les champs clients sont couramment renseignés en masse lors de la migration depuis un CRM existant.
6

Enregistrer le client

Cliquez sur Enregistrer.
Vos clients disposent des nouveaux champs. Ils alimentent les rapports (filtrables dans les vues clients) et deviennent disponibles pour la synchronisation CRM.

​
Étape 3 : Synchroniser avec votre CRM (recommandé)

Les champs personnalisés Client représentent le cas d’usage n°1 pour la synchronisation CRM. Le CRM est généralement la source de vérité pour les données maîtres clients, et Qwoty a besoin de la même vision pour prendre des décisions de devis intelligentes.
1

Ouvrir votre intégration CRM

Accédez à Paramètres → Développeurs → Intégration et cliquez sur votre CRM connecté.
2

Trouver la section de mapping des champs personnalisés

Faites défiler jusqu’au mapping client. Les champs apparaissent sous la forme Personnalisé : Type de client et Personnalisé : Numéro de TVA.
3

Choisir une direction de synchronisation

Pour les données maîtres clients, nous recommandons fortement :
  • Type de client → Bidirectionnel — les deux systèmes ont besoin de la même segmentation, et l’un ou l’autre peut être modifié
  • Numéro de TVA → CRM → Qwoty — généralement géré par les équipes sales-ops dans le CRM ; Qwoty doit seulement le lire
Évitez Qwoty → CRM pour les données maîtres clients, sauf si Qwoty est vraiment la source de vérité pour ce champ (cas rare).
4

Sélectionner le champ CRM correspondant

Sélectionnez le champ correspondant dans le CRM :
  • HubSpot : une propriété Texte sur une ligne ou Liste déroulante sur l’objet Entreprise
  • Salesforce : un champ Liste de sélection ou Texte sur le compte
  • Pipedrive : un champ Option unique ou Texte libre sur l’Organisation
Types compatibles : Texte → Texte, Liste de sélection, Liste déroulante.
5

Enregistrer les modifications

Cliquez sur Enregistrer les modifications en bas de la page. La synchronisation démarre au prochain cycle.
Les types de clients et les numéros de TVA se synchronisent désormais entre Qwoty et votre CRM. Les nouveaux clients ajoutés dans l’un ou l’autre système apparaissent dans l’autre en quelques secondes.

​
Champs personnalisés Client courants

Au-delà du type et de la TVA, voici des champs qui reviennent fréquemment :
Lors d’une migration depuis un autre CRM, commencez par lister toutes les propriétés personnalisées sur l’objet client/entreprise dans ce CRM, puis créez les champs correspondants dans Qwoty avant d’importer les données clients. L’import renseignera les champs automatiquement. Voir Importer des clients.

​
Dépannage

Actualisez la page. S’il est toujours absent, vérifiez que le bouton bascule est activé dans la section Champs personnalisés.
Vérifiez que l’en-tête de colonne dans votre CSV correspond exactement au Nom API du champ (sensible à la casse). Consultez Importer des clients pour la référence complète des colonnes.
Le type Texte de Qwoty stocke la valeur telle quelle. Si votre CRM envoie Stratégique, Renouvellement, Risque, Qwoty stocke cette chaîne entière. Vous pouvez soit analyser les valeurs dans vos workflows CRM avant la synchronisation, soit créer plusieurs champs Texte dans Qwoty pour chaque étiquette.
La synchronisation bidirectionnelle utilise le principe du dernier écrit gagne. Si deux utilisateurs modifient le même champ dans les deux systèmes au cours d’une même fenêtre de synchronisation, la dernière écriture l’emporte. Pour éviter les conflits, décidez quel système est canonique pour les champs à fort enjeu et utilisez une synchronisation unidirectionnelle (CRM → Qwoty ou Qwoty → CRM) à la place.
Vérifiez que la synchronisation CRM → Qwoty est active, que le webhook CRM se déclenche (visible dans Paramètres → Développeurs → Webhook) et que l’intégration dispose d’un accès en lecture sur l’objet Entreprise / Compte. Les nouveaux enregistrements apparaissent généralement en quelques secondes.

​
Ressources associées

Clients

Gérez votre base clients.

Importer des clients

Renseignez les champs personnalisés en masse via CSV.

Mapping CRM

Toutes les directions de synchronisation et les règles de compatibilité.

Intégration CRM

Connectez HubSpot, Salesforce ou Pipedrive.