Modèles et éditeur d'e-mails
Un modèle est un message prêt à l'emploi pour un canal : e-mail, message Telegram, SMS, Web Push, push mobile, message in-app, webhook, etc. Un même modèle est utilisé par les parcours, les campagnes et l'envoi manuel depuis la fiche d'un profil. Les variables insèrent dans le texte le nom du client, le montant de la commande et d'autres données.
La section se trouve dans le menu Engagement → Modèles. Tous les rôles peuvent consulter les modèles ; le rôle « Gestionnaire » et les rôles supérieurs peuvent les créer et les modifier.
Créer un modèle
- Ouvrez Modèles, cliquez sur Nouveau modèle en haut à droite et choisissez le canal dans la liste : elle contient tous les canaux activés dans le projet, par exemple E-mail ou Telegram.
- Renseignez les champs communs (tableau ci-dessous).
- Remplissez le bloc Contenu. Les champs dépendent du canal. Pour un e-mail, il s'agit de l'Objet, du Pré-en-tête (texte affiché à côté de l'objet dans la liste des e-mails), de l'Éditeur d'e-mails ou du HTML, ainsi que de la Version texte brut. Si la version texte n'est pas renseignée, elle est générée à partir du HTML.
- Cliquez sur Enregistrer. À chaque enregistrement, le numéro de version augmente (« Version 3 »).
| Champ | Signification |
|---|---|
| Nom | Visible uniquement dans l'interface : dans les listes de modèles, de parcours et de campagnes |
| Canal | Choisi à la création, il ne peut plus être modifié ensuite |
| Thème d'abonnement | Un thème du référentiel, par exemple marketing ou news, ou une nouvelle clé, qui apparaîtra dans le référentiel. Le client peut se désabonner de ce seul thème |
| Message transactionnel | Envoyé sans vérification de l'abonnement, de la fréquence ni des heures de silence, mais pas vers un canal fermé pour le destinataire : boîte ou numéro inexistant, bot bloqué. À réserver aux confirmations de commande, réinitialisations de mot de passe et messages similaires, voir Messages transactionnels et envois en cascade |
Liste des modèles
Le tableau affiche le canal, les versions linguistiques du modèle (la langue principale est mise en couleur), le verdict de délivrabilité, le thème d'abonnement et l'heure de modification avec le numéro de version.
Délivrabilité est le bilan de la vérification de la délivrabilité d'un modèle d'e-mail sur toutes ses versions linguistiques : le moins bon verdict des versions (« Bon », « Points à revoir », « Mauvais ») et le score le plus élevé du filtre antispam (spam à partir de 6). Le détail par langue et l'heure de la vérification s'affichent dans l'infobulle du badge. Le modèle est vérifié en arrière-plan après chaque modification de l'e-mail ; pendant la vérification, le badge indique « Vérification ». Modifier uniquement le nom ou le thème d'abonnement ne relance pas la vérification. Si le verdict est « Points à revoir » ou « Mauvais », ouvrez le modèle et lancez-y la vérification pour voir les points signalés.
Au-dessus du tableau se trouvent une recherche par nom et des filtres par canal, langue et verdict de délivrabilité, par exemple tous les modèles notés « Mauvais » ou tous les modèles qui ont une version allemande. Un clic sur l'en-tête d'une colonne trie le tableau, un second clic inverse l'ordre. Les filtres et le tri sont mémorisés : après la suppression d’un modèle ou le retour depuis l’éditeur, la liste reste la même.

Pour supprimer un modèle, cliquez sur l'icône de corbeille sur sa ligne dans la liste.
Variables
Les modèles s'écrivent en Twig. Une variable se place entre doubles accolades. La liste complète avec des exemples s'affiche en dépliant le bloc Variables sous le contenu.
| Variable | Valeur insérée |
|---|---|
profile.email, profile.phone, profile.user_id |
Identifiants du client |
traits.first_name et les autres traits.* |
Attributs du profil |
event.name, event.properties.amount |
L'événement qui a déclenché le message |
context.data.*, context.nodes.* |
Données du parcours : celles transmises à l'entrée via l'API et la réponse du nœud « Webhook » |
project.name, unsubscribe_url, preferences_url |
Nom du projet, lien de désabonnement et lien vers le centre de préférences |
project.legal_address |
Adresse légale de l'entreprise issue des paramètres du projet ; pratique pour le pied de l'e-mail. Vide si l'adresse n'est pas renseignée |
loyalty.points, loyalty.tier, loyalty.expiring, loyalty.expire_at, loyalty.referral_url |
Compte dans le programme de fidélité : solde, niveau, points qui vont expirer et leur date, lien de parrainage |
wallet_url |
Lien vers la carte de fidélité dans Wallet : le client ajoute la carte à Apple Wallet ou Google Wallet. Valable 90 jours ; vide si les cartes Wallet ne sont pas connectées |
promo_code('welcome') |
Code promo du client issu du lot welcome : attribué à l'envoi, remplacé par un exemple dans l'aperçu |
order.number, order.amount, order.tracking_url |
Commande d'un e-mail de la boutique : numéro, montant, lien de suivi ; montant avec la devise : {{ order.amount|money(order.currency) }} |
product('SKU-1') |
Produit du catalogue dans la langue du message : name, url, image, price, old_price, currency, available, stock, au moment de l'envoi (prix et disponibilité des produits) |
Bonjour {{ traits.first_name|default('cher client') }} !
{% if event.properties.amount > 5000 %}La livraison est offerte.{% endif %}
Les modèles s'exécutent dans un bac à sable sécurisé. Celui-ci propose les conditions if, les boucles for, set, les fonctions date, min, max et les filtres default, date, upper, lower, capitalize, number_format, round, join, replace, striptags, entre autres. Si une variable n'existe pas, une chaîne vide est insérée : pour les endroits importants, définissez donc une valeur avec default. Si vous utilisez une construction interdite, l'erreur « Le modèle utilise une construction interdite » s'affiche à l'enregistrement. Le message final ne peut pas dépasser 512 Ko. L'héritage de modèles (extends, block) n'est pas disponible, et les boucles ainsi que les appels aux produits, recommandations et codes promo sont limités : un modèle qui effectue trop d'opérations ne sera pas enregistré.
Si le modèle contient une variable que la plateforme ne connaît pas — un espace réservé d'une autre maquette comme {{ COMPANY_ADDRESS }} ou une faute de frappe comme {{ first_name }} au lieu de {{ traits.first_name }} —, un avertissement listant ces variables apparaît au-dessus du contenu. Elles seront vides dans le message. L'avertissement est mis à jour à l'ouverture du modèle, à l'enregistrement, dans l'aperçu et lors de l'envoi de test.
Aperçu et envoi de test
- Dans le panneau Aperçu, saisissez l'ID du profil, un e-mail ou un user_id et cliquez sur l'icône en forme d'œil. Si le champ est vide, les données sont prises dans le profil actif le plus récent.
- Pour un e-mail, basculez entre les modes Ordinateur, Téléphone, Mode sombre et Images désactivées. Dans ce dernier, les images sont remplacées par leur texte
alt: c'est ce que voient les destinataires dont les images ne se chargent pas. - Dans le panneau Envoi de test, choisissez une intégration. Indiquez votre adresse ou votre chat id, sinon le message est envoyé à l'adresse du profil. Cliquez sur Envoyer un test : le statut du message s'affiche sous le bouton.
L'envoi de test est accessible au rôle « Gestionnaire » et aux rôles supérieurs. L'abonnement, la fréquence et les heures de silence ne sont pas vérifiés. L'aperçu n'a pas d'événement déclencheur : les variables event.* restent donc vides. Si vous n'avez pas le droit de voir les données personnelles, l'e-mail et le téléphone sont masqués.

Sous l'e-mail de l'aperçu se trouve le bloc Dans la boîte de réception. Il montre l'aspect de l'expéditeur, de l'objet et du pré-en-tête dans la liste des e-mails de Gmail, ordinateur, d'Outlook et d'iPhone, Mail. Un objet ou un pré-en-tête trop long est coupé à peu près comme dans ces clients. Le nom de l'expéditeur provient de l'intégration choisie dans le bloc de vérification de la délivrabilité.

Vérification de la délivrabilité
Avant l'envoi, vous pouvez vérifier un modèle d'e-mail : arrivera-t-il dans la boîte de réception ou dans les spams ? Dans le bloc Vérification de la délivrabilité, choisissez l'intégration par laquelle l'e-mail sera envoyé et cliquez sur Vérifier. L'e-mail est composé comme lors de l'envoi : avec le suivi des ouvertures et des clics et le lien de désabonnement. La version linguistique ouverte est vérifiée, et les données sont insérées à partir du profil indiqué dans l'aperçu.
La vérification porte sur trois points :
- Expéditeur. Pour le service de messagerie de OneTrace.pro, le domaine de l'adresse d'expédition doit être ajouté et vérifié dans la section Domaines d'envoi, de préférence avec un enregistrement DMARC. Pour votre propre serveur SMTP, les enregistrements SPF et DMARC du domaine sont vérifiés ; la signature DKIM se configure chez votre fournisseur de messagerie et ne peut pas être vérifiée d'ici.
- Contenu. L'objet (vide, en majuscules, avec
!!ou$$, trop long), le pré-en-tête, la taille de l'e-mail (Gmail tronque le HTML au-delà de 102 Ko), un e-mail composé uniquement d'images, des images sansalt, des raccourcisseurs de liens, des liens vers une adresse IP et des liens dont le texte est l'adresse d'un autre site, le lien de désabonnement visible dans les e-mails marketing, les éléments que les clients de messagerie suppriment (scripts, formulaires, cadres). - Score du filtre antispam. Le filtre antispam Rspamd analyse l'e-mail dans son ensemble. Un score inférieur au seuil « suspect » est bon ; au-delà du seuil « spam », l'e-mail arrivera très probablement dans les spams. La liste Ce qui a influencé le score indique les règles du filtre et leur poids.
Le résultat est l'un des verdicts suivants : Bon (aucune raison évidente d'arriver dans les spams), Points à revoir (l'e-mail sera délivré, mais il vaut mieux corriger les points signalés) ou Mauvais (risque élevé de spam ou erreur d'expéditeur). Chaque remarque explique ce qui ne va pas et comment le corriger.
Plus bas se trouve Compatibilité avec les clients de messagerie : les techniques de mise en page qui ne fonctionnent pas dans Outlook pour Windows, Gmail, Yandex Mail ou Mail.ru, par exemple les coins arrondis, les ombres, les requêtes média, les polices personnalisées, le SVG et la vidéo. L'e-mail sera délivré dans ces clients, mais s'affichera différemment ; cela n'influence donc pas le verdict.

Les campagnes vérifient de la même façon les e-mails de leurs variantes : voir Vérification des e-mails avant le lancement.
Versions linguistiques
Un modèle peut contenir des versions en plusieurs langues. Chaque destinataire reçoit la version dans la langue de son profil (l'attribut language), ou la version principale s'il n'y en a pas. Les langues disponibles se définissent dans les paramètres du projet.
-
Au-dessus du bloc Contenu, cliquez sur Ajouter une langue et choisissez une langue. Choisissez ensuite comment créer la version :
- Copie de la version ouverte — mise en page, images et liens sont déjà en place, il ne reste qu'à traduire les textes ;
- Traduction par IA — un brouillon de traduction de la version principale, voir plus bas ;
- Importer un e-mail avec l’IA — un e-mail prêt dans cette langue, voir Importer dans une version linguistique.

-
Passez d'une version à l'autre avec les boutons de langue. La version principale porte la mention « principale ».
-
Pour que les destinataires sans version propre reçoivent une autre langue, ouvrez sa version et cliquez sur Définir comme principale. Supprimer la version retire la version ouverte.
-
Cliquez sur Enregistrer. Chaque version est vérifiée séparément ; une version avec des erreurs est signalée par une icône d'avertissement.
Brouillon de traduction
Pour ne pas traduire une version à la main depuis zéro, ouvrez-la et cliquez sur Brouillon de traduction. OneTrace.pro traduit la version principale dans la langue de l'onglet ouvert : objet, pré-en-tête, textes des blocs de l'éditeur, version texte brut, textes des SMS, des notifications push et des messageries. Les variables comme {{ traits.first_name }}, les liens, les images et la mise en forme ne changent pas.
Le brouillon est seulement inséré dans le formulaire. Relisez-le, ajustez les formulations et cliquez sur Enregistrer. Si un champ n'a pas pu être traduit sans perdre de variables, il reste dans la langue source et OneTrace.pro indique combien de champs sont concernés. Si la version diffère déjà de la version principale, une confirmation est demandée avant le remplacement.
Le nombre de brouillons par mois est limité par le forfait : voir Forfaits. Le bouton n'apparaît pas si la traduction n'est pas activée dans votre installation.
La version est choisie ainsi : d'abord la langue exacte, puis la langue sans région (un client en pt-BR reçoit la version pt), puis une autre variante de la même langue. L'aperçu et l'envoi de test montrent la version ouverte, et la variable {{ language }} contient la langue de la version envoyée.
Éditeur d'e-mails
Dans un modèle d'e-mail, cliquez sur Ouvrir l'éditeur dans le champ « Éditeur d'e-mails ». Si le modèle contient déjà du HTML, l'éditeur repart d'un e-mail vierge et l'ancien code est remplacé à l'enregistrement. OneTrace.pro génère lui-même à l'enregistrement le code destiné aux clients de messagerie, y compris Outlook et les téléphones.
À droite du canevas se trouvent trois onglets :
- Blocs : ajouter un bloc. Il se place après le bloc sélectionné ou à la fin de l'e-mail, avant le pied de page.
- Bloc : paramètres du bloc sélectionné sur le canevas. Les blocs peuvent être montés, descendus, déplacés par glisser-déposer, dupliqués et supprimés.
- E-mail : arrière-plan, fond de l'e-mail, couleurs du texte et des liens, police, largeur de l'e-mail (480 à 800 px), marges et mode de diffusion des images.
| Bloc | Usage |
|---|---|
| Titre, Texte | Texte mis en forme avec des variables, par exemple {{ traits.first_name }} |
| Image | Image de la médiathèque : texte alternatif, lien, largeur de 10 à 100 % |
| Bouton | Texte, lien, couleurs et arrondi |
| Séparateur, Espacement | Une ligne et un espace vide |
| Colonnes | 2 ou 3 colonnes avec titres, texte, images, boutons et espacements. Sur téléphone, les colonnes s'empilent |
| Produits | Sélection issue des recommandations : personnalisées, populaires, « Consultés ensemble », « Similaires », etc. Les produits personnalisés, populaires et tendance peuvent être limités à une Catégorie du catalogue. La source Produits sélectionnés affiche jusqu'à 12 produits du catalogue dans l'ordre choisi : recherchez-les par nom ; seuls ceux en stock figurent dans l'e-mail. Vous pouvez afficher de 1 à 12 produits sur 1 à 4 colonnes, avec prix et bouton. Les produits qui ont des avis affichent une note sous leur nom. S'il n'y a aucun produit adapté, le bloc n'apparaît pas dans l'e-mail |
| Commande | Commande d'un e-mail de la boutique : articles, montants, suivi du colis et adresses. Dans les e-mails sans commande, le bloc n'apparaît pas |
| Enquête | Question principale d'une enquête : boutons NPS 0–10 ou cinq étoiles. Le client donne sa note directement dans l'e-mail ; la page de l'enquête l'enregistre et propose les autres questions |
| HTML | Votre propre code tel quel |
| Pied de page | Texte, lien de désabonnement et lien « Gérer les abonnements » |

Le bouton Passer en HTML de l'onglet « E-mail » convertit l'e-mail en code ordinaire. Il n'est ensuite plus possible de revenir à l'éditeur.
Lien ou pièce jointe
| Lien (CDN) | Jointe à l'e-mail | |
|---|---|---|
| Poids de l'e-mail | Léger | Augmenté de la taille des images |
| Affichage | L'image est chargée à l'ouverture. Si la messagerie bloque les images, seule la légende est visible | L'image est visible immédiatement |
Le mode par défaut se définit dans le champ Diffusion des images par défaut de l'onglet « E-mail ». Pour une image donnée, il peut être modifié dans le champ Diffusion. L'ensemble des pièces jointes d'un e-mail ne peut pas dépasser 1 Mo. Si les liens publics ne sont pas configurés sur l'installation, seules les pièces jointes sont disponibles.
L'IA dans l'éditeur d'e-mails
L'IA vous aide pour les textes d'un modèle d'e-mail : elle propose des objets, retouche le texte des blocs et compose un e-mail complet à partir d'une description. Le résultat de l'IA est un brouillon : il arrive dans le formulaire ou dans l'éditeur, et c'est vous qui enregistrez le modèle. L'IA connaît le nom du projet, le secteur de la boutique, la devise, la langue de la version ouverte et le ton et les règles de la marque. Les données des clients ne lui sont pas transmises.
L'IA est disponible avec un forfait payant et est facturée sur le solde du projet selon la consommation. Si l'IA est indisponible pour le moment (période d'essai, solde vide, plafond de dépenses atteint), les boutons restent visibles et la raison est indiquée à côté.
Idées d'objet
Le bouton Idées d'objet se trouve au-dessus des champs « Objet » et « Pré-en-tête ». Choisissez l'Axe (approches différentes, curiosité et clarté, urgence, ton personnel ou avantage pour le lecteur) et, si vous le souhaitez, indiquez vos Souhaits, par exemple « sans emoji ». Cliquez sur Proposer : l'IA suggère cinq paires « objet + pré-en-tête » à partir du texte de la version ouverte de l'e-mail.
Dans la liste, l'objet est affiché tel que le verra un destinataire portant un prénom d'exemple. La mention Avec le prénom du destinataire indique que l'objet contient la variable du prénom. Le bouton Utiliser reprend la paire dans le formulaire.

Retouche du texte d'un bloc
Sélectionnez un titre, un texte ou un bouton sur le canevas de l'éditeur. Dans le panneau du bloc, la section IA : retoucher le texte propose les boutons Raccourcir, Plus chaleureux, Plus formel, Corriger les fautes et Réécrire… (avec votre propre consigne). La proposition de l'IA apparaît sous les boutons : Remplacer la place dans le bloc, Annuler laisse le texte tel quel.
L'IA ne modifie ni les variables du modèle ni les liens. Si une variable a disparu de la réponse ou si un lien a changé, le texte n'est pas remplacé et une explication s'affiche.

E-mail à partir d'une description
Le bouton E-mail avec l'IA se trouve au-dessus de l'éditeur, à côté du bouton « Ouvrir l'éditeur ». Décrivez le sujet de l'e-mail et ce que vous attendez du lecteur, puis ajoutez les liens, par exemple « soldes sur les manteaux jusqu'à dimanche, remises jusqu'à 30 %, lien https://… ». Activez Produits du catalogue si l'e-mail doit contenir des produits : l'IA consulte les catégories du catalogue et trouve des produits en stock. Cliquez sur Composer l'e-mail : cela prend généralement moins d'une minute.
Pour que le nouvel e-mail ressemble à vos autres e-mails, choisissez un E-mail exemple : un modèle d'e-mail du projet créé dans l'éditeur. L'IA reprend sa mise en page et sa structure : couleurs et police, logo et autres images, boutons, blocs HTML comme un encadré avec code promo, et pied de page avec ses variables. Elle rédige les textes d'après la description : les offres, codes promo et liens de l'exemple ne sont pas repris, sauf si vous les indiquez dans la description.
L'e-mail est composé avec les blocs de l'éditeur : titre, texte, bouton, produits et pied de page avec le lien de désabonnement. Si l'éditeur contient déjà un e-mail, OneTrace.pro demande s'il faut le remplacer. L'objet et le pré-en-tête ne sont remplis que si ces champs sont vides. Si quelque chose mérite d'être corrigé, des avertissements apparaissent au-dessus de l'éditeur, par exemple pour indiquer les liens des boutons absents de la description.

Les variantes d'un e-mail pour le test A/B, l'IA les crée directement dans la campagne.
Importer un e-mail déjà conçu
Si l'e-mail est déjà conçu dans un autre service, inutile de le recréer. Sur la page Modèles, cliquez sur Importer un e-mail (IA) :
- Choisissez Fichier et importez un e-mail enregistré depuis votre messagerie (
.eml) ou une page.html. Ou choisissez Code HTML et collez le code de l'e-mail. - Cliquez sur Importer. L'IA traite généralement l'e-mail en moins d'une minute.
- L'éditeur s'ouvre avec un nouveau modèle d'e-mail : l'e-mail est découpé en blocs de l'éditeur, les images sont copiées dans la médiathèque, le nom du destinataire est remplacé par la variable
{{ traits.first_name }}et le lien de désabonnement passe dans le bloc « Pied de page ». Les textes et les liens restent ceux de l'e-mail. - Vérifiez le modèle et cliquez sur Enregistrer. Tant qu'il n'est pas enregistré, le modèle n'existe pas.


Si une partie de l'e-mail n'a pas pu être reprise, une liste apparaît au-dessus du formulaire : images non copiées ou blocs ignorés. Si l'e-mail ne peut pas être découpé en blocs, il est importé en un seul bloc « HTML ». Les pixels de suivi et le lien « Voir dans le navigateur » ne sont pas importés.
OneTrace.pro détecte la langue de l'e-mail d'après l'attribut lang et l'en-tête Content-Language et, s'ils ne correspondent pas au texte, d'après le texte même de l'e-mail. La langue de l'e-mail devient la langue principale du nouveau modèle.
Importer dans une version linguistique
Si vous avez déjà l'e-mail dans une autre langue, inutile de le traduire : dans un modèle d'e-mail ouvert, cliquez sur Ajouter une langue, choisissez la langue puis Importer un e-mail avec l’IA. L'e-mail se charge comme lors de la création d'un modèle et va dans la version de la langue choisie, avec ses propres blocs, images et objet. Vérifiez la version et cliquez sur Enregistrer.
Si la langue de l'e-mail ne correspond pas à celle choisie, une indication apparaît au-dessus de la version, par exemple « L’e-mail semble être en français », ainsi que le bouton En faire la version « français ». Si cette version existe déjà, OneTrace.pro vous demande s'il faut la remplacer.
L'import est disponible avec les forfaits « Croissance » et « Entreprise » ; le nombre d'imports par mois — nouveaux modèles comme versions — dépend du forfait, voir Forfaits. Avec le forfait « Essentiel », le bouton indique à partir de quel forfait la fonction est disponible.
Médiathèque
La médiathèque s'ouvre lorsque vous ajoutez un bloc « Image » ou cliquez sur Choisir une image.
- Téléverser accepte les formats JPEG, PNG, GIF, WebP et AVIF jusqu'à 10 Mo. Les images larges sont réduites à 1200 px. Les formats WebP et AVIF sont réencodés, car tous les clients de messagerie ne les affichent pas. Les GIF restent tels quels, animation comprise.
- Si vous téléversez à nouveau le même fichier, aucune copie n'est créée.
- Une image utilisée dans un modèle ne peut pas être supprimée tant que vous ne l'avez pas retirée du modèle.
- L'espace occupé par les images est décompté de la limite du forfait.
