Personnaliser les Modèles d’E-mail

Auris envoie des e-mails transactionnels aux moments critiques du cycle de vie utilisateur : vérification d’e-mail, réinitialisation de mot de passe, connexion par magic link, invitations, alertes de sécurité et plus encore. Par défaut, ces e-mails utilisent un modèle épuré rendu avec le branding de ton tenant (nom d’entreprise, logo, couleur primaire). Les personnaliser te donne le contrôle total du HTML, pour que chaque point de contact — du premier e-mail de vérification à une alerte de connexion suspecte des mois plus tard — soit cohérent avec ton produit.

Ce guide t’accompagne dans la modification des modèles depuis la Console, l’utilisation des variables dynamiques et des blocs conditionnels, l’aperçu et le test des changements, la gestion des langues et la gestion programmatique via l’API.

Types de Modèles

Auris inclut treize types de modèles d’e-mail. Chacun est déclenché automatiquement au bon moment.

Chaque modèle se personnalise indépendamment, et indépendamment par langue.

Étape 1 : Ouvre l’Éditeur de Modèles

1. Ouvre la Console Auris et va dans Paramètres, puis Modèles d’E-mail
2. Tu verras les treize types de modèles avec leur statut actuel (défaut ou personnalisé)
3. Clique sur le type de modèle que tu veux modifier

Étape 2 : Choisis un Mode d’Édition

L’éditeur propose trois modes :

• Éditeur de thème — personnalise l’identité (logo, nom de marque, texte du footer), les couleurs, la typographie, les boutons, la mise en page et le contenu via des panneaux visuels.
• Builder visuel — compose l’e-mail par blocs sur un canvas.
• Éditeur de code — modifie le HTML et le CSS bruts. Une bibliothèque de snippets fournit des points de départ prêts à l’emploi.

Quel que soit le mode, le résultat est un document HTML complet enregistré par type de modèle et par langue. La plupart des clients e-mail ont un support CSS limité : les styles inline et les mises en page en tableaux sont l’approche la plus fiable.

Étape 3 : Utilise les Variables des Modèles

Les variables utilisent la syntaxe {{nomVariable}}. Quand Auris envoie l’e-mail, chaque placeholder est remplacé par la valeur réelle pour cet utilisateur et cet événement. Dans le corps, les valeurs sont échappées automatiquement en HTML ; dans l’objet, elles sont insérées en texte brut.

Variables Globales (disponibles dans tous les modèles)

Variables par Type

Conditionnels et Interpolation Brute

• {{#if variable}}...{{/if}} conserve le contenu englobé seulement quand la variable a une valeur non vide. Sinon le bloc — markup inclus — est supprimé.
• {{{variable}}} insère la valeur brute sans échappement HTML. À réserver aux fragments HTML de confiance construits côté serveur.

Exemple pour un modèle magic_link :

<h1>Connecte-toi à {{tenantName}}</h1>
<p><a href="{{link}}">Se connecter sur cet appareil</a></p>
{{#if approveLink}}
<p><a href="{{approveLink}}">Approuver sur l'appareil où tu as commencé la connexion</a></p>
{{/if}}
<p>Ce lien expire dans {{expiresIn}}.</p>

Étape 4 : Gère les Langues

Les modèles par défaut intégrés existent en cinq langues : anglais (en), italien (it), français (fr), allemand (de) et espagnol (es). Les modèles personnalisés peuvent être enregistrés pour n’importe quel code de locale (par exemple pt-BR) via le sélecteur de langue de l’éditeur.

À l’envoi, Auris résout le modèle dans cet ordre :

1. Modèle personnalisé dans la langue du destinataire
2. Modèle personnalisé en anglais
3. Défaut intégré dans la langue du destinataire
4. Défaut intégré en anglais

Tu peux donc personnaliser seulement les langues qui t’intéressent — les autres continuent de fonctionner avec les défauts.

Étape 5 : Prévisualise

L’aperçu en direct rend le modèle avec des données d’exemple réalistes pendant que tu édites (par exemple [email protected] pour {{email}} et 24 hours pour {{expiresIn}}). Utilise le sélecteur d’appareil pour vérifier les largeurs desktop, tablette et mobile, ou ouvre l’aperçu plein écran.

Étape 6 : Envoie un E-mail de Test

Clique sur Envoyer un test dans l’éditeur. Auris rend le modèle avec des données d’exemple et l’envoie à ta propre adresse e-mail (l’administrateur authentifié), avec l’objet préfixé par [TEST]. Via l’API, tu peux optionnellement indiquer un autre destinataire avec le champ recipientEmail.

Vérifie l’e-mail dans ta boîte de réception :

• Le logo et les images se chargent correctement
• Le bouton d’action est cliquable et bien stylé
• La mise en page est correcte sur desktop et mobile
• Tous les placeholders ont été remplacés (aucun {{texte}} littéral)
• L’e-mail n’atterrit pas dans le dossier spam

Étape 7 : Enregistre

Clique sur Enregistrer pour publier. Les modifications prennent effet immédiatement pour tous les futurs e-mails de ce type et de cette langue — aucun déploiement ni redémarrage nécessaire. Le HTML enregistré est assaini côté serveur (scripts, gestionnaires d’événements, frames intégrées sont supprimés) et doit rester sous 500 Ko.

Pour revenir au modèle par défaut de la langue en cours, clique sur Réinitialiser. Cela supprime la version personnalisée et restaure le modèle intégré avec le branding du tenant.

Envoi des E-mails

Auris envoie les e-mails via la configuration SMTP de ton tenant quand elle est présente et active ; sinon l’expéditeur par défaut de la plateforme est utilisé. Tu peux configurer le SMTP (hôte, port, identifiants, adresse d’expéditeur), lancer un test de connexion et contrôler le footer des e-mails dans Paramètres, puis E-mail :

• E-mails white-label supprime l’attribution “Powered by Altovar” du footer des modèles par défaut.
• Masquer le footer omet entièrement le bandeau du footer.

Pour la délivrabilité, configure les enregistrements DNS SPF, DKIM et DMARC de ton domaine d’expédition — ton fournisseur d’e-mail fournit les valeurs exactes.

Gestion Programmatique des Modèles

Toutes les opérations disponibles dans la Console peuvent aussi être effectuées via l’API Modèles d’E-mail. Tous les endpoints exigent la permission manage:security et l’en-tête x-tenant.

Lister tous les modèles

curl https://auth.tondomaine.com/api/email-templates \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: ton-realm"

Renvoie chaque type avec label, description, variables, hasCustomTemplate, customLocales, plus availableLocales (les cinq langues intégrées).

Récupérer un modèle (avec base par défaut)

curl "https://auth.tondomaine.com/api/email-templates/verification?locale=fr" \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: ton-realm"

Renvoie subject/htmlBody personnalisés pour cette langue (ou null), avec defaultSubject/defaultHtmlBody rendus avec le branding de ton tenant.

Mettre à jour un modèle

curl -X PUT https://auth.tondomaine.com/api/email-templates/verification \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: ton-realm" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Vérifie ton e-mail",
    "htmlBody": "<!DOCTYPE html><html><body><p>Bonjour {{email}},</p><p><a href=\"{{link}}\">Vérifie ton adresse</a> — expire dans {{expiresIn}}.</p></body></html>",
    "locale": "fr"
  }'

Prévisualiser un modèle

curl -X POST https://auth.tondomaine.com/api/email-templates/verification/preview \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: ton-realm" \
  -H "Content-Type: application/json" \
  -d '{ "subject": "Vérifie ton e-mail", "htmlBody": "<p>Bonjour {{email}}</p>" }'

Renvoie { "subject": ..., "html": ..., "variables": { ... } } rendus avec des valeurs d’exemple. Rien n’est envoyé.

Envoyer un e-mail de test

curl -X POST https://auth.tondomaine.com/api/email-templates/verification/test \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: ton-realm" \
  -H "Content-Type: application/json" \
  -d '{ "subject": "Vérifie ton e-mail", "htmlBody": "<p>Bonjour {{email}}</p>", "recipientEmail": "[email protected]" }'

recipientEmail est optionnel — sans lui, le test va dans ta propre boîte (celle de l’administrateur authentifié). La réponse est { "success": true, "sentTo": "..." }.

Supprimer (revenir au défaut)

curl -X DELETE "https://auth.tondomaine.com/api/email-templates/verification?locale=fr" \
  -H "Authorization: Bearer $AURIS_ACCESS_TOKEN" \
  -H "x-tenant: ton-realm"

Avec ?locale=, seule la version personnalisée de cette langue est supprimée. Sans, toutes les langues du type sont supprimées.

Bonnes Pratiques

Garde les modèles simples. Le support HTML des clients e-mail est notoirement incohérent. Utilise des styles inline, des mises en page en tableaux et des polices système pour une compatibilité maximale.

Inclus toujours l’URL d’action en clair. Sous chaque bouton d’action, indique l’URL brute en texte. Certains clients ne rendent pas correctement les boutons HTML, et certains utilisateurs préfèrent inspecter les URL avant de cliquer. Auris dérive aussi automatiquement une partie text/plain de ton HTML, en préservant les liens.

Utilise {{expiresIn}} pour cadrer les attentes. Dis toujours à l’utilisateur combien de temps un lien ou un code reste valide.

Garde le bouton d’approbation conditionnel dans magic_link. Encapsule le bouton secondaire dans {{#if approveLink}}...{{/if}} — la variable est vide pour les flux sans approbation cross-device, et le conditionnel retire le bouton proprement.

N’inclus pas de données sensibles. Ne mets jamais de mots de passe ou de clés API complètes dans les e-mails. Les e-mails peuvent rester indéfiniment dans les boîtes des utilisateurs.

Versionne tes modèles. Si tu gères les modèles via l’API, conserve le HTML source dans ton dépôt : historique, revue et rollback.

Dépannage

Guides Associés

• Modèles d’E-mail (Console) — Référence de l’éditeur et catalogue des modèles
• API Modèles d’E-mail — Référence complète des endpoints
• Branding — Branding du tenant appliqué aux e-mails par défaut
• Connexion par Magic Link — Le flux derrière le modèle magic_link