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, 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. En haut à droite figure un bouton pour chaque canal activé dans le projet, par exemple E-mail ou Telegram. Cliquez sur celui qui vous intéresse.
- 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 | Par exemple marketing ou news. 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. À réserver aux confirmations de commande, réinitialisations de mot de passe et messages similaires |
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 |
Nom du projet et lien de désabonnement |
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.
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 et Mode sombre.
- 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.
É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. Vous pouvez afficher de 1 à 12 produits sur 1 à 4 colonnes, avec prix et bouton. S'il n'y a aucun produit adapté, le bloc n'apparaît pas dans l'e-mail |
| HTML | Votre propre code tel quel |
| Pied de page | Texte et lien de désabonnement |
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.
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.
