Smartletter
Centre d'aide
← Centre d'aide

Contacts

Champs des contacts et personnalisation

Garde ce que tu sais de chaque abonné, comme son offre ou sa ville. Puis utilise-le dans tes emails avec des balises comme {{first_name}}.

Créer des champs perso

Chaque contact a des champs de base : email, prénom, nom, nom complet et langue. Les champs perso ajoutent tes propres données.

  1. Va sur Champs des contacts.
  2. Dans le formulaire Nouveau champ, donne-lui un Libellé (ce que tu vois) et une Clé (ce que tu tapes dans les balises et l'API).
  3. Choisis un Type, puis une Valeur par défaut si tu veux.
  4. Clique sur Ajouter le champ.

Pour changer les valeurs d'un contact, ouvre-le depuis la liste Audience.

Types de champs et limites

  • Texte : jusqu'à 1 000 caractères.
  • Nombre : 12, 1 234,5 ou 1,234.5 passent dans un CSV.
  • Date : au format AAAA-MM-JJ, comme 2026-10-22.
  • Oui / non : dans un CSV, oui, yes, vrai ou 1 veulent dire oui ; non, no, faux ou 0 veulent dire non.
  • Choix : de 1 à 50 options, une par ligne. Dans un CSV, une valeur trouve son option même avec d'autres majuscules.

Un workspace peut avoir jusqu'à 50 champs. Une clé commence par une lettre minuscule, puis prend des minuscules, des chiffres ou _, jusqu'à 40 caractères. Les noms utilisés par l'app, comme email ou status, sont interdits.

La clé et le type ne changent plus après la création. Supprimer un champ efface aussi ses valeurs sur tous les contacts.

Active Proposé dans les formulaires d'inscription pour que les nouveaux abonnés remplissent le champ en s'inscrivant. Un formulaire ne peut écrire que les champs où c'est activé.

Les balises de personnalisation

Une balise est remplacée par la valeur de chaque abonné au moment de l'envoi. Elle marche dans l'objet, le texte d'aperçu et le corps.

{{first_name}}
{{last_name}}
{{name}}
{{email}}
{{language}}
{{custom.plan}}

Les noms restent en anglais : first_name est le prénom, last_name le nom, name le nom complet. Pour tes champs perso, écris custom. puis la clé. Les espaces dans les accolades ne gênent pas : {{ first_name }}.

Dans l'éditeur visuel, tape / et choisis une entrée Variable. Tu peux ajouter le texte à afficher si la valeur est vide.

Un contact sans prénom mais avec un nom complet ? {{first_name}} prend le premier mot du nom complet.

Valeurs de secours et filtres

Ajoute des filtres après un signe |. Il y en a quatre :

  • default: "texte" : affiche ce texte si la valeur est vide. Jusqu'à 200 caractères. Guillemets simples ou doubles, au choix.
  • upper : tout en majuscules.
  • lower : tout en minuscules.
  • capitalize : une majuscule au début. Le reste ne change pas.
Salut {{first_name | default: "toi"}}
=> Salut Anna  (ou "Salut toi" si le prénom est vide)

{{first_name | default: "l'ami" | capitalize}}
=> anna devient Anna, vide devient L'ami

{{custom.ville | upper}}
=> lyon devient LYON

Les filtres s'appliquent de gauche à droite. Donc {{first_name | upper | default: "toi"}} affiche toi en minuscules si le prénom est vide.

La valeur par défaut d'un champ perso sert quand le contact n'a pas de valeur. Le filtre default: de la balise sert quand les deux sont vides.

Les cas particuliers

  • Une balise avec une faute, un champ inconnu ou un filtre inconnu reste telle que tu l'as tapée. Regarde bien ton email de test.
  • Sur la page d'archive publique d'une édition, chaque balise affiche sa valeur de secours, ou rien. Un visiteur ne voit jamais les données d'un abonné.
  • Avant l'envoi, la dernière vérification te prévient si une balise sans valeur de secours serait vide pour beaucoup d'abonnés.
  • Une valeur est coupée après 1 000 caractères. Dans l'objet, les retours à la ligne sont retirés.
Mets toujours une valeur de secours aux balises de l'objet. Un prénom vide donne des objets comme « Salut , ».