Modèles HTML

Un modèle contient tout ce dont Frontmail a besoin pour transformer un ensemble de paramètres en e-mail finalisé. Vous le modifiez dans Modèles du tableau de bord ; chaque enregistrement crée une nouvelle version.

Contenu d’un modèle

Partie	Remarques
Nom, description, langue par défaut	N’importe quelle langue (en, fr, hu, pt-BR, …). La langue dans laquelle un e-mail est envoyé détermine la sortie de formatDate, formatNumber et formatMoney.
Variantes linguistiques	Traductions facultatives de l’objet, du HTML, du texte et du nom de l’expéditeur – voir Traductions des modèles.
Objet	Peut contenir des paramètres : Commande {{order_id}} confirmée.
À, CC, BCC	Adresses séparées par des virgules. Paramètres autorisés uniquement avec Autoriser un destinataire dynamique (voir plus bas). 50 destinataires au maximum au total.
Nom de l’expéditeur, e-mail de l’expéditeur	L’e-mail de l’expéditeur doit être autorisé par le service connecté (domaine ou expéditeur vérifié).
Reply-To	Souvent {{email}}, pour pouvoir répondre directement au visiteur.
Corps HTML	Un document HTML complet, avec <head> et <style>.
Version texte	Générée automatiquement à partir du HTML ; désactivez la génération automatique pour la modifier à la main.
Paramètres	Le schéma typé – voir Paramètres et types.
Service et service de secours	Quel service l’envoie, et lequel prend le relais en cas d’échec.
Sécurité	CAPTCHA exigé (activé par défaut lorsque votre organisation a des clés Turnstile, désactivé sinon ; un false explicite dans un fichier est conservé), Autoriser un destinataire dynamique (désactivé par défaut).
Pièces jointes	Fichiers statiques, pièces jointes dynamiques activées ou non, images intégrées – voir Pièces jointes.
Réponse automatique, collecte des contacts	Voir Réponse automatique et Collecte des contacts.

L’éditeur

L’éditeur est divisé en deux :

• À gauche : l’éditeur de code HTML, avec coloration Handlebars et autocomplétion de vos paramètres (tapez {{ pour les voir). Un éditeur visuel est disponible pour les modèles simples ; vous pouvez repasser au HTML à tout moment.
• À droite : l’aperçu en direct dans une iframe isolée (sandbox). Basculez entre largeur ordinateur / mobile, fond clair / sombre et version HTML / texte. L’aperçu se met à jour pendant la saisie.

Sous l’aperçu se trouve le panneau des paramètres – un formulaire généré à partir du schéma, où vous modifiez les valeurs d’exemple utilisées par l’aperçu et par les envois de test.

CSS en ligne

De nombreux clients de messagerie (notamment Gmail sur certaines plateformes et Outlook) ignorent les blocs <style>. Avec Intégrer le CSS en ligne à l’enregistrement activé, Frontmail copie vos règles dans des attributs style="" à l’enregistrement, et conserve les media queries dans <style> pour les clients qui les prennent en charge.

Vérifications du modèle

Le panneau des vérifications s’exécute à chaque modification et signale :

• les paramètres manquants – utilisés dans le modèle mais non définis dans le schéma,
• les paramètres inutilisés – définis mais jamais utilisés,
• le Handlebars invalide – blocs non fermés, helpers inconnus (seuls les helpers intégrés sont disponibles),
• les images sans alt – mauvais pour l’accessibilité et pour les clients qui bloquent les images,
• une taille supérieure à ~100 ko – Gmail tronque les messages de plus de 102 ko environ et masque le reste derrière « Afficher l’intégralité du message ».

Les avertissements ne bloquent jamais l’enregistrement, mais un modèle qui ne compile pas ne peut pas être envoyé.

Destinataires dynamiques

Par défaut, À, CC et BCC doivent être des adresses fixes. Si un champ de destinataire contient un paramètre (par exemple To: {{email}}), les envois sont refusés avec dynamic_recipient_not_allowed, sauf si vous activez Autoriser un destinataire dynamique sur le modèle.

Pourquoi c’est désactivé par défaut

Un modèle avec un destinataire dynamique et une clé publique pourrait être détourné pour envoyer n’importe quel e-mail à n’importe qui. Ne l’activez qu’avec les domaines autorisés, Turnstile et des rate limits raisonnables – ou n’envoyez ces modèles que depuis votre serveur avec une clé privée.

Avec la clé publique, un modèle à destinataire dynamique n’est envoyé qu’avec un contenu verrouillé : CAPTCHA exigé, champs d’expéditeur fixes, aucun paramètre HTML, textes de 500 caractères au maximum, liens uniquement vers des domaines autorisés et au plus 5 e-mails par destinataire et par jour.

Pour le cas courant « remercier le visiteur », utilisez plutôt une réponse automatique.

Paramètres dans les attributs

Un paramètre de type HTML utilisé à l’intérieur d’une balise (<a href="{{bio}}">, <img alt="{{bio}}">) ou dans <style> y est inséré comme texte brut échappé, pour que son balisage ne puisse pas sortir de l’attribut. L’éditeur le signale dans les Vérifications.

Pied de page du forfait Free

Les e-mails envoyés avec le forfait Free comportent un petit pied de page « Envoyé via Frontmail », dans la langue de l’e-mail lorsqu’il s’agit de l’une des huit langues du tableau de bord, sinon en anglais. Les forfaits payants n’en ont pas.

Import et export

• Import : collez du HTML ou téléversez un fichier .html ; Frontmail détecte les paramètres à partir des espaces réservés {{…}}.
• Export : téléchargez le modèle (HTML, texte, paramètres, schéma des paramètres et variantes linguistiques) au format JSON, p. ex. pour le déplacer vers une autre organisation.