# Champs personnalisés, profil de prospect et notes Chaque contact possède des informations de base : nom, téléphone, e-mail, canal. Mais vous en savez généralement beaucoup plus sur les personnes avec qui vous communiquez : leur entreprise, leur date de naissance, leur dernier achat, la conférence par laquelle ils sont arrivés. Cette page couvre les informations supplémentaires que vous pouvez associer à un contact, et où chacune d'elles se trouve. --- ## Aperçu | Quoi | Idéal pour | Où cela se trouve | |---|---|---| | **Champs personnalisés** | Faits structurés courts (entreprise, poste, date de naissance, forfait, etc.) | Une liste de paires clé/valeur sur le contact | | **Notes (= Profil du prospect)** | Une description libre de qui est cette personne et pourquoi elle est importante — lue par l'IA lors de la personnalisation des réponses | Une zone de texte unique sur le contact | | **Statut** | Suivre l'étape du parcours d'un contact, y compris le marquer comme spam | Une valeur unique sur le contact | > **Si vous utilisez l'application depuis un certain temps :** ce qui était auparavant deux éléments distincts — un « Profil de prospect » détaillé et une liste empilée de notes datées — est désormais fusionné en **un seul champ**, intitulé **Notes** sur la fiche complète du contact. Il n'y a plus de journal de notes horodaté séparé avec des titres ; tout ce que vous écrivez sur un contact va dans cette unique zone. Voir [Notes](#notes-lead-profile) ci-dessous pour savoir ce que cela signifie en pratique. --- ## Définition des champs personnalisés Les champs personnalisés sont réutilisables pour tous vos contacts. Une fois que vous avez créé un champ tel que `company`, il fait partie du schéma de votre compte et apparaît comme suggestion chaque fois que vous modifiez un autre contact. **Type de champ :** Les champs personnalisés sont uniquement en texte libre — il n'existe pas de types menu déroulant, bouton radio ou choix multiple. Si vous souhaitez qu'un champ ne contienne qu'une seule valeur parmi quelques options définies (comme une source de prospect « Newsletter », « Recommandation » ou « Publicité »), saisissez la même valeur de manière cohérente, ou remplissez-la en masse via l'export/import d'un tableur afin que chaque contact utilise exactement la formulation souhaitée. **Règles de nommage :** - Les noms de champs doivent utiliser uniquement des lettres minuscules, des chiffres et des traits de soulignement, et doivent commencer par une lettre ou un trait de soulignement (par exemple `lead_source`, et non `Lead Source`). - **Lettres anglaises non accentuées uniquement** — les espaces, les majuscules et les caractères accentués ou non latins sont rejetés. Même si le reste de votre compte est dans une autre langue, nommez le champ `cumpleanos` ou `birthday`, et non `cumpleaños`. Seul le nom est restreint ; la valeur que vous y stockez peut être dans n'importe quelle langue. - Un compte peut avoir jusqu'à **50 champs personnalisés**. - Choisissez le nom avec soin — une fois qu'un champ est utilisé dans un modèle ou une campagne, vous ne pouvez pas le supprimer sans avoir d'abord supprimé ces références. --- ## Remplissage des champs personnalisés sur un contact 1. Dans la barre latérale gauche, cliquez sur **Contacts**. 2. Cliquez sur la ligne d'un contact pour ouvrir le [panneau de vue rapide](creating-contacts.md), puis cliquez sur **Modifier** — ou cliquez sur **Nouveau contact** pour en créer un nouveau. 3. Dans le formulaire de contact, recherchez la section **Champs personnalisés**. 4. Tapez un nom dans **Ajouter un champ** (les noms de champs existants apparaissent sous forme de suggestions — cliquez sur l'un d'eux pour le réutiliser), cliquez sur **Ajouter**, puis tapez la valeur. 5. Cliquez sur **Enregistrer** sur le formulaire pour le stocker. Les champs qui ont déjà une valeur apparaissent sur le panneau de vue rapide et sur la fiche complète du contact sous forme de lignes en lecture seule — pour modifier une valeur, rouvrez **Modifier**. **Supprimer un champ** du formulaire de modification supprime cette valeur du contact. Il n'est toujours pas possible de supprimer un champ de tous les contacts et du schéma de votre compte tant qu'il est référencé par un modèle ou une campagne. --- ## Laisser l'IA remplir les champs personnalisés pour vous Votre agent IA peut enregistrer des informations directement dans des champs personnalisés au fur et à mesure qu'elles apparaissent dans la conversation — un anniversaire, le nom d'un partenaire, une exigence alimentaire, une préférence de table — afin que vous puissiez les utiliser ultérieurement dans une diffusion ou un suivi. Cette option est désactivée par défaut et elle n'écrit que dans les champs que vous avez explicitement choisis. Deux conditions doivent être remplies, et **les deux** sont nécessaires — c'est la raison la plus courante pour laquelle les utilisateurs constatent que rien n'a été enregistré : **1. Créez d'abord les champs.** L'IA ne peut écrire que dans des champs qui existent déjà sur votre compte. Ajoutez-les de la manière habituelle (voir [Remplir les champs personnalisés sur un contact](#filling-in-custom-fields-on-a-contact) ci-dessus) — par exemple `customer_birthday`, `partner_name`, `dietary_notes`. N'oubliez pas les règles de nommage : uniquement des lettres minuscules, des chiffres et des traits de soulignement. **2. Donnez l'autorisation à l'agent et choisissez les champs.** 1. Cliquez sur **Agents IA** dans la barre latérale et ouvrez l'agent. 2. Allez dans l'onglet **Capacités de l'IA**. 3. Sous **Mises à jour des contacts**, activez **Autoriser l'IA à collecter des informations supplémentaires**. 4. Une carte intitulée **Collecter des informations supplémentaires lors de la réservation** apparaît, listant vos champs personnalisés. Activez le bouton à côté de **chaque** champ que l'IA est autorisée à remplir — créer un champ ne suffit pas en soi, et tout champ laissé de côté est ignoré silencieusement. (Si la carte indique que vous n'avez pas encore de champs personnalisés, revenez en arrière et créez-les d'abord.) 5. Cliquez sur **Enregistrer**, puis sur **Publier** l'agent. Les modifications restent dans le brouillon jusqu'à ce que vous publiiez, donc une modification non publiée n'affectera pas les conversations en direct. La publication met en ligne **toutes** les modifications en attente, pas seulement celle-ci, alors jetez un œil aux autres onglets si vous avez effectué des modifications. **Bon à savoir :** - **Cela fonctionne tout au long de la conversation, pas seulement lors de la réservation.** Malgré le libellé de la carte — les réservations sont là où la fonctionnalité a commencé — l'IA enregistre une valeur dès que le contact la mentionne, qu'un rendez-vous soit impliqué ou non. Vous n'avez pas besoin que les réservations soient activées du tout. - **Chaque champ peut être marqué comme obligatoire.** Obligatoire signifie seulement "doit être collecté avant que l'IA ne confirme un rendez-vous" — cela ne bloque jamais une conversation normale, et cela n'a aucun effet sur un agent qui ne prend pas de réservations. - **Le fait que l'IA dise qu'elle a "noté" quelque chose n'est pas la même chose que l'enregistrer.** Si le champ n'est pas créé et activé, l'IA peut toujours répondre poliment qu'elle a pris note, mais rien n'atterrit sur le contact. Vérifiez la fiche de contact pour confirmer qu'une valeur a bien été enregistrée. - **Dites à l'agent quand demander.** Dans les instructions de l'agent, décrivez quand chaque champ s'applique ("si l'invité mentionne une allergie ou un régime, enregistrez-le dans `dietary_notes`"). L'IA lit cela en langage clair, elle n'interrogera donc pas tout le monde avec la même liste. - **Rien n'est rempli rétroactivement.** Seules les conversations à partir du moment où vous publiez sont capturées — les détails déjà mentionnés dans les discussions passées ne sont pas remplis rétroactivement. - **Configurez cela sur le compte qui possède les contacts.** Les champs personnalisés appartiennent à un seul compte, donc dans une configuration d'agence, créez-les dans le sous-compte dont l'agent effectue la conversation, et non sur le compte de l'agence parente. - **Les notes libres appartiennent aussi à un champ.** L'IA conversationnelle ne peut pas écrire dans la case **Profil du prospect / Notes** d'un contact (voir ci-dessous) — celle-ci est pour vous et votre équipe, bien que les [Automatisations](../automations/automations.md) et l'API puissent y écrire. Si vous voulez que l'IA elle-même enregistre quelque chose comme "a demandé un plat sans gluten", faites-en un champ personnalisé tel que `dietary_notes`. --- ## Ce que l'IA peut lire pendant une conversation Si vous essayez de décider où placer une information pour que l'IA puisse **l'utiliser pendant la discussion**, voici la différence importante : - **Champs personnalisés : l'IA les lit à chaque réponse.** Toutes les valeurs des champs personnalisés d'un contact sont accessibles à l'IA tout au long de la conversation, quelle que soit la manière dont le champ a été rempli (par vous, par l'IA précédemment, via une importation ou l'API). Ainsi, une règle dans les instructions de votre agent comme « saluer les clients fidèles par leur `preferred_barber` » fonctionne, car l'IA peut voir la valeur à ce moment-là. - **Tags : l'IA ne les voit pas pendant la discussion.** L'étiquetage s'effectue lors d'une étape distincte après l'envoi de la réponse de l'IA — l'IA applique des tags en fonction de vos descriptions, mais elle ne voit pas quels tags un contact possède déjà pendant la conversation. Les instructions du type « si le contact possède le tag VIP, proposez la remise » ne fonctionneront **pas**. La règle d'or : tout ce que l'IA doit lire et utiliser au cours d'une conversation doit être placé dans un **champ personnalisé**. Les **tags** sont destinés à tout ce qui se passe autour de la conversation : filtrer et segmenter les contacts, cibler les diffusions et déclencher des [webhooks de tag](../integrations/webhooks.md) vers vos autres systèmes au moment où l'IA en applique un. --- ## Chargement en masse des champs personnalisés Le mappage de colonnes de l'assistant d'importation ne reconnaît que les **prénom, nom, téléphone, e-mail, tags et notes** — il n'existe pas d'étape permettant de « mapper cette colonne de feuille de calcul vers un champ personnalisé » (les tags, en revanche, sont importés en tant que véritables tags). Pour charger en masse des valeurs de champs personnalisés aujourd'hui, utilisez l'API — la méthode à suivre dépend du fait que les contacts existent déjà ou non. **Vous ajoutez de nouveaux contacts ?** Le point de terminaison d'importation de contacts en masse de l'API accepte les valeurs de champs personnalisés directement dans le même appel, vous n'avez donc pas besoin d'une seconde étape. Incluez un objet `custom_fields` sur chaque enregistrement aux côtés du nom, du téléphone et de l'e-mail, et les contacts arriveront avec leurs champs personnalisés déjà remplis. Le format de requête est documenté dans la section Contacts de la référence de l'API. **Vous remplissez des informations pour des contacts que vous possédez déjà ?** 1. Listez vos contacts via l'API pour obtenir l'ID de chaque contact. L'export CSV n'inclut pas de colonne d'ID de contact ni de colonnes de champs personnalisés. Consultez [Accès à l'API](../integrations/api-access.md) pour savoir comment obtenir une clé et appeler le point de terminaison. 2. Remplissez les valeurs dans votre feuille de calcul. 3. Utilisez le point de terminaison de mise à jour de contact de l'API (voir [Accès à l'API](../integrations/api-access.md)) pour les réécrire contact par contact, car l'assistant d'importation lui-même ne dispose pas encore de mappage de colonnes pour les champs personnalisés. Chaque mise à jour ne modifie que les clés que vous envoyez — tous les champs personnalisés que vous omettez conservent leurs valeurs actuelles. --- ## Notes (= Profil du prospect) Sur la **fiche complète** d'un contact (cliquez sur **Ouvrir la fiche complète** depuis le panneau de vue rapide), le panneau **Notes** est une zone de texte libre unique — le même champ sous-jacent est également appelé "Profil du prospect" ailleurs. Dans le formulaire **Modifier** du contact, la même case est intitulée **Profil du prospect**, décrite comme "Notes internes sur ce contact", alors ne cherchez pas un deuxième champ. Écrivez tout ce qui est pertinent pour la conversation : type d'entreprise, points de douleur, taille de l'entreprise, activité récente, tout ce qui aide à personnaliser la prise de contact. **Comment l'IA l'utilise :** dans un modèle de message — un message diffusé, un suivi, les instructions d'un agent IA — vous pouvez inclure un espace réservé comme `{{personal_context|write a one-line opener that references their business}}`. Lorsque ce modèle est envoyé à un contact spécifique, l'IA lit ses Notes et rédige une ligne personnalisée en utilisant ce qui s'y trouve. Si un contact n'a pas de Notes, l'espace réservé est simplement supprimé du message. L'IA n'écrit **pas** cela pour vous — vous ou votre équipe le remplissez. Considérez-le comme la fiche mémo que vous voudriez qu'un commercial lise avant de décrocher le téléphone. Si vous voulez que l'IA elle-même enregistre quelque chose qu'elle apprend dans une conversation, utilisez plutôt un champ personnalisé — voir [Laisser l'IA remplir les champs personnalisés pour vous](#letting-the-ai-fill-custom-fields-for-you). La modification est simple : tapez dans la zone, puis cliquez sur **Enregistrer la note** (ou sur **Ignorer** pour annuler les modifications non enregistrées). Il n'y a pas de titre ou de date distincts par entrée — il s'agit d'un bloc de texte continu par contact. Si vous souhaitez un journal daté, ajoutez vous-même la date au début de chaque ajout. --- ## Statut Chaque contact possède un badge **Statut** indiquant où il en est dans son parcours : | Statut | Signification | |---|---| | **Nouveau** | Vient d'arriver, pas encore engagé. | | **Engagé** | En pleine conversation. | | **Prospect** | Montre un intérêt pour l'achat. | | **Client** | Converti. | | **Perdu** | Était client, n'est plus actif. | | **Spam** | Masqué de vos listes principales ; le robot IA ne s'engagera pas avec lui, le mode « Ne pas déranger » est activé et il est exclu des campagnes. | Cliquez directement sur le badge **Statut** dans le tableau des contacts pour le modifier en ligne — pour tout statut sauf Spam, que vous définissez via l'action groupée **Marquer comme spam** (et sa confirmation), car il entraîne des effets secondaires supplémentaires. Le retrait du statut spam est disponible de la même manière, sous le nom **Démarquer comme spam**. --- ## Assigner un contact à un membre de l'équipe L'attribution de propriété — assigner un contact à un membre de l'équipe pour éviter que d'autres ne répondent par erreur — se définit depuis l'écran **Chats** plutôt que depuis la page Contacts : ouvrez la conversation et utilisez le contrôle d'assignation qui s'y trouve. Voir [Interface de chat](../chats/chat-interface.md) pour la procédure complète. Seuls les propriétaires de compte et les utilisateurs disposant des autorisations appropriées peuvent modifier une assignation. --- ## Utilisation des champs personnalisés dans les diffusions et les modèles Les champs personnalisés sont très utiles dans les messages sortants. Partout où vous pouvez rédiger un message — messages de diffusion, modèles WhatsApp, instructions de l'agent IA — vous pouvez insérer un espace réservé comme : ``` Hey {{first_name}}, hope things are going well at {{company}}! ``` Lorsque le message est envoyé, `{{first_name}}` et `{{company}}` sont remplacés par les valeurs de chaque contact. Si un contact n'a pas ce champ renseigné, l'espace réservé reste vide. Quelques conseils : - **Utilisez des noms en minuscules avec des traits de soulignement** — l'espace réservé doit correspondre exactement au nom du champ (`{{company}}`, pas `{{Company}}`). - **Les champs intégrés fonctionnent aussi** — `{{first_name}}`, `{{last_name}}`, `{{email}}` et `{{phone_number}}` fonctionnent sans avoir besoin d'être configurés comme champs personnalisés. - **Combinez avec les Notes** — pour des lignes personnalisées par l'IA, utilisez `{{personal_context|your instruction}}` au lieu d'un champ personnalisé fixe ; l'IA rédige quelque chose de nouveau en se basant sur les notes du contact. - **Vous ne pouvez pas supprimer un champ en cours d'utilisation** — si un modèle utilise `{{company}}`, le système empêche la suppression de `company` tant que vous ne l'avez pas retiré de ces modèles. --- ## Besoin d'aide ? Une bonne règle empirique pour savoir quoi mettre où : - Un **fait court et structuré sur lequel vous filtrerez ou fusionnerez** → champ personnalisé. - Un **paragraphe de contexte à lire pour l'IA ou votre équipe** → Notes. - **Qui est responsable de la conversation** → le responsable, défini depuis Discussions. Vous avez encore des difficultés ? Contactez le support et nous vous aiderons à le configurer. --- ## Étapes suivantes - [Ajouter un nouveau contact](creating-contacts.md) — ajoutez des contacts un par un, et découvrez une visite complète de l'écran Contacts. - [Importer des contacts depuis un fichier](importing-contacts.md) — importez une feuille de calcul. - [Interface de chat](../chats/chat-interface.md) — là où se trouve l'assignation des contacts.