Comment créer et utiliser des attributs personnalisés ?

Sojan

Sojan

Dernière mise à jour le Jul 31, 2026

Chatwoot vous permet de suivre des informations supplémentaires concernant vos conversations et contacts au-delà des attributs de données standards tels que nom, adresse e-mail et lieu. Ces informations additionnelles sont appelées attributs personnalisés et peuvent correspondre à tout ce que vous souhaitez suivre. Voici quelques exemples d’attributs personnalisés.

  • Abonnement souscrit

  • Date d’abonnement

  • Date d’inscription

  • Article le plus commandé

  • Lien du produit commandé

  • Date de la dernière transaction

Les attributs de données personnalisés vous permettent d’attacher des informations complémentaires à une conversation ou à un client, telles que l’historique d’achat ou le statut du compte. Ces informations peuvent être utilisées pour mieux comprendre et segmenter votre base de clients.

La seule différence entre les attributs personnalisés et standards est que les attributs de données standards sont mis à jour automatiquement.

Comment créer un attribut personnalisé ?

Étape 1. Allez dans Paramètres → Attributs personnalisés. Cliquez sur le bouton “Ajouter un attribut personnalisé”.

Étape 2. Une fenêtre modale s’ouvrira, demandant les détails du nouvel attribut personnalisé. Remplissez ces informations. Voici un exemple :

Voici les champs requis pour créer l’attribut personnalisé :

  1. S’applique à

    Type d’attribut (Conversation/Contact).

  2. Nom d’affichage

    Sert d’étiquette lors de l’affichage de l’attribut personnalisé.

  3. Clé

    Identifiant unique associé à l’attribut personnalisé.

  4. Description

    Description de l’attribut personnalisé.

  5. Type

    Texte, Nombre, Lien, Date, Liste et Case à cocher.

Remarque : Il n’est pas possible de créer un attribut personnalisé avec la même clé à deux reprises dans le compte.

Étape 3. Une fois les détails saisis, cliquez sur le bouton ”Créer”. Si la demande aboutit, un message "Attribut personnalisé ajouté avec succès" s’affichera.

Comment utiliser un attribut personnalisé de conversation ?

Vous pouvez ajouter des attributs personnalisés de conversation à une conversation depuis la barre latérale de cette dernière. Suivez les étapes ci-dessous.

Étape 1. Sur votre tableau de bord, lorsque vous ouvrez une conversation particulière, vous trouverez une section intitulée “Informations sur la conversation”. Cliquez sur le signe + pour la déplier.

Étape 2. Une option “Ajouter des attributs” suivie d’un menu déroulant contenant tous les attributs personnalisés de votre compte s’affichera. Utilisez la barre de recherche pour filtrer le nom de l’attribut recherché, ou cliquez sur un nom pour le sélectionner. Si vous souhaitez en créer un nouveau, cliquez sur le bouton “Créer un nouvel attribut” dans ce même menu déroulant.

Étape 3. Selon le type d’attribut ajouté (liste, case à cocher, texte, etc.), renseignez-le à votre convenance. Voici quelques exemples :

Pour modifier/supprimer/copier un attribut, passez la souris dessus pour afficher les options.

Comment utiliser un attribut personnalisé de contact ?

Il existe deux façons de définir les attributs personnalisés pour les contacts.

Définir des attributs via la méthode SDK

Pour définir un attribut personnalisé de contact, appelez la méthode setCustomAttributes comme suit.

window.$chatwoot.setCustomAttributes({
  key: value,
  // La clé est un identifiant unique déjà défini lors de la création de l’attribut personnalisé
  // La valeur doit correspondre au type (Actuellement pris en charge : Number, Date, String et Number)
  // Vérifiez toujours que vos clés ont des valeurs valides au format JSON
  // Il faut aplatir la structure JSON imbriquée lorsque vous utilisez cette fonction
});

Exemple :

window.$chatwoot.setCustomAttributes({
  key: value,
  // La clé est un identifiant unique déjà défini lors de la création de l’attribut personnalisé
  // La valeur doit correspondre au type (Actuellement pris en charge : Number, Date, String et Number)
  // Vérifiez toujours que vos clés ont des valeurs valides au format JSON
  // Il faut aplatir la structure JSON imbriquée lorsque vous utilisez cette fonction
});

Vous pouvez visualiser ces attributs dans le panneau latéral du contact ou de la conversation.

Pour supprimer un attribut personnalisé, utilisez deleteCustomAttribute comme suit.

window.$chatwoot.deleteCustomAttribute("attribute-key");

Exemple :

window.$chatwoot.deleteCustomAttribute("signUpDate");

Remarque : Avant la version v1.22, tous les attributs étaient affichés comme texte. Veuillez créer une nouvelle définition pour afficher correctement la valeur.

Définir des attributs via le panneau latéral du contact

Pour ajouter des attributs de contact, suivez la même procédure que celle décrite plus haut pour les attributs personnalisés de conversation, mais utilisez cette fois la section Attributs du contact de la barre latérale de discussion. Voici à quoi cela ressemble :

Selon le type d’attribut que vous avez ajouté (liste, case à cocher, texte, etc.), complétez-le à votre convenance. Voici un exemple :