Skip to Content

Modèles d’E-mail

Auris envoie des e-mails transactionnels pour les événements d’authentification et de compte : vérification d’e-mail, réinitialisation de mot de passe, connexion par magic link, invitations, alertes de sécurité et plus encore. La Console inclut un éditeur de modèles qui te permet de personnaliser l’objet, le contenu et le design de chaque type d’e-mail — par langue — sans écrire de code.

Accède à l’éditeur via Console -> Paramètres -> Modèles d’E-mail.

Types de Modèles

Auris inclut treize modèles d’e-mail transactionnels, chacun déclenché par un événement précis :

Type de modèleDéclencheur
verificationUn nouvel utilisateur s’inscrit et doit vérifier son adresse e-mail
password_resetUn utilisateur demande une réinitialisation de mot de passe
invitationUn utilisateur est invité à rejoindre un tenant
mfa_codeL’authentification à deux facteurs par e-mail envoie un code de vérification
magic_linkUn utilisateur demande une connexion sans mot de passe via magic link
login_alertUne nouvelle connexion est détectée sur le compte
welcomeUn utilisateur vérifie avec succès son adresse e-mail
password_changedLe mot de passe d’un utilisateur est modifié (notification de confirmation)
account_lockedUn compte est verrouillé après trop de tentatives de connexion échouées
suspicious_loginUne connexion depuis une position, un appareil ou une IP inhabituels est détectée
email_changedL’e-mail principal est modifié (envoyé à l’ancienne adresse)
license_issuedUne clé de licence est émise pour un client
cibaUne application demande l’approbation d’une connexion via le flux CIBA (backchannel)

Chaque modèle peut être modifié indépendamment, dans chaque langue. Les modifications s’appliquent à toutes les applications du tenant.

Si tu n’as pas personnalisé un modèle, Auris utilise un modèle par défaut rendu avec le branding de ton tenant (nom d’entreprise, logo, couleur primaire — voir Branding). Personnaliser un modèle remplace entièrement le HTML par défaut pour ce type et cette langue.

L’e-mail magic_link contient deux boutons : un lien de connexion principal qui authentifie l’utilisateur sur l’appareil qui ouvre l’e-mail, et un lien d’approbation secondaire qui confirme la session sur l’appareil qui a lancé le flux de connexion.

Utiliser l’Éditeur de Modèles

Sélectionne un type de modèle

Ouvre Paramètres -> Modèles d’E-mail et clique sur le modèle que tu veux personnaliser.

Choisis un mode d’édition

L’éditeur propose trois modes :

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

Modifie l’objet et le corps

L’objet comme le corps supportent les placeholders {{variable}}. Dans le corps, clique sur une variable pour l’insérer à la position du curseur — l’éditeur liste exactement les variables disponibles pour le type de modèle sélectionné.

Gère les langues

Chaque modèle peut avoir une version distincte par langue. Cinq langues disposent de modèles par défaut intégrés : anglais, italien, français, allemand et espagnol. Tu peux ajouter n’importe quel autre code de locale (par exemple pt-BR) depuis le sélecteur de langue ; les locales sans défaut intégré retombent sur l’anglais tant que tu n’as pas enregistré de version personnalisée.

Au moment de l’envoi, Auris résout le modèle dans cet ordre : modèle personnalisé dans la langue de l’utilisateur -> modèle personnalisé en anglais -> défaut intégré dans la langue de l’utilisateur -> défaut intégré en anglais.

Prévisualise le rendu

L’aperçu en direct affiche ton modèle avec des données d’exemple pendant que tu édites. Utilise le sélecteur d’appareil pour vérifier les mises en page desktop, tablette et mobile, ou ouvre l’aperçu plein écran.

Envoie un e-mail de test

Clique sur Envoyer un test. Auris rend le modèle avec des données d’exemple et l’envoie à ta propre adresse e-mail (l’administrateur authentifié). L’objet est préfixé par [TEST] pour le distinguer facilement des e-mails transactionnels réels.

Enregistre le modèle

Clique sur Enregistrer pour appliquer les modifications. Le modèle prend effet immédiatement pour tous les futurs e-mails de ce type et de cette langue. Utilise Réinitialiser pour supprimer la version personnalisée de la langue en cours et revenir au modèle intégré.

Les clients e-mail ont un support HTML et CSS incohérent. Utilise du CSS inline et des mises en page en tableaux pour les structures complexes, et envoie des e-mails de test à de vrais clients avant d’enregistrer des modèles de production. Le HTML enregistré est assaini côté serveur (scripts, gestionnaires d’événements et frames intégrées sont supprimés) et limité à 500 Ko.

Variables des Modèles

Variables Globales

Ces variables de date sont injectées automatiquement dans chaque rendu :

VariableDescriptionValeur d’exemple
{{year}}Année courante2026
{{month}}Mois courant (deux chiffres)07
{{day}}Jour courant (deux chiffres)23
{{date}}Date courante au format YYYY-MM-DD2026-07-23

Variables par Modèle

Chaque type de modèle a son propre jeu de variables :

ModèleVariables
verificationemail, link, expiresIn
password_resetemail, link, expiresIn
invitationemail, orgName, role, inviterEmail, link, expiresIn
mfa_codeemail, code, expiresIn
magic_linkemail, link, approveLink, expiresIn, tenantName
login_alertemail, device, ipAddress, location, time
welcomeemail, name, orgName, dashboardLink
password_changedemail, name, time, ipAddress
account_lockedemail, name, lockDuration, attempts, ipAddress, time
suspicious_loginemail, name, device, ipAddress, location, time, reason
email_changedemail, name, newEmail, time
license_issuedkey, jwtToken, product, expiresAt, features
cibaemail, appName, bindingMessage, approveUrl, denyUrl

Syntaxe des Modèles

  • {{variable}} — remplacée par la valeur, avec échappement HTML pour la sécurité. Dans l’objet (texte brut, pas HTML) les valeurs sont insérées sans échappement.
  • {{{variable}}} — interpolation brute sans échappement HTML. À réserver aux fragments HTML de confiance construits côté serveur.
  • {{#if variable}}...{{/if}} — le contenu englobé est conservé seulement quand la variable a une valeur non vide. Utile pour les éléments optionnels comme le bouton approveLink dans magic_link.

Il n’y a pas de notation pointée ({{user.name}} n’est pas supporté) ni de boucles. Les noms de variables sont sensibles à la casse.

Les placeholders inconnus restent tels quels dans le rendu. Si un e-mail envoyé contient un {{texte}} littéral, vérifie le nom de la variable dans le tableau ci-dessus.

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é. Les paramètres SMTP, un test de connexion et les options du footer se trouvent dans Console -> Paramètres -> 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.

Ces interrupteurs s’appliquent aux modèles par défaut (non personnalisés) ; un modèle personnalisé remplace tout le HTML, footer inclus. Voir Branding pour les détails.

Référence API

Les modèles d’e-mail peuvent aussi être gérés par API REST. Voir l’API Modèles d’E-mail pour les requêtes et réponses complètes.

GET/api/email-templates
GET/api/email-templates/{type}
PUT/api/email-templates/{type}
DELETE/api/email-templates/{type}
POST/api/email-templates/{type}/preview
POST/api/email-templates/{type}/test

Permissions

PermissionDescription
manage:securityRequise pour lister, voir, modifier, supprimer, prévisualiser et tester les modèles d’e-mail.

Guides Associés

Architecture