Template Email
Auris invia email transazionali per gli eventi di autenticazione e account: verifica email, reset password, login con magic link, inviti, avvisi di sicurezza e altro. La Console include un editor di template che ti permette di personalizzare oggetto, contenuto e design di ogni tipo di email — per ogni lingua — senza scrivere codice.
Accedi all’editor da Console -> Impostazioni -> Template Email.
Tipi di Template
Auris include tredici template email transazionali, ognuno attivato da un evento specifico:
| Tipo di template | Trigger |
|---|---|
verification | Un nuovo utente si registra e deve verificare l’indirizzo email |
password_reset | Un utente richiede il reset della password |
invitation | Un utente viene invitato a unirsi a un tenant |
mfa_code | L’autenticazione a due fattori via email invia un codice di verifica |
magic_link | Un utente richiede il login senza password via magic link |
login_alert | Viene rilevato un nuovo accesso sull’account |
welcome | Un utente verifica con successo il proprio indirizzo email |
password_changed | La password di un utente viene cambiata (notifica di conferma) |
account_locked | Un account viene bloccato dopo troppi tentativi di accesso falliti |
suspicious_login | Viene rilevato un accesso da posizione, dispositivo o IP inusuali |
email_changed | L’email principale viene cambiata (inviata al vecchio indirizzo) |
license_issued | Viene emessa una chiave di licenza per un cliente |
ciba | Un’applicazione richiede l’approvazione dell’accesso via flusso CIBA (backchannel) |
Ogni template può essere modificato in modo indipendente, in ogni lingua. Le modifiche si applicano a tutte le applicazioni del tenant.
Se non hai personalizzato un template, Auris usa un template predefinito renderizzato con il branding del tuo tenant (nome azienda, logo, colore primario — vedi Branding). Personalizzare un template sostituisce interamente l’HTML predefinito per quel tipo e quella lingua.
L’email magic_link contiene due pulsanti: un link di accesso primario che autentica l’utente sul
dispositivo che apre l’email, e un link di approvazione secondario che conferma la sessione sul
dispositivo da cui è partito il flusso di login.
Usare l’Editor di Template
Seleziona un tipo di template
Apri Impostazioni -> Template Email e clicca sul template che vuoi personalizzare.
Scegli una modalità di modifica
L’editor offre tre modalità:
- Editor tema — regola identità (logo, nome brand, testo footer), colori, tipografia, stile dei pulsanti, layout e contenuto del corpo senza toccare l’HTML completo.
- Builder visuale — componi l’email a blocchi su un canvas.
- Editor codice — modifica direttamente HTML e CSS. Una libreria di snippet offre punti di partenza pronti.
Modifica oggetto e corpo
Sia l’oggetto sia il corpo supportano i placeholder {{variabile}}. Nel corpo, clicca su una variabile per inserirla alla posizione del cursore — l’editor elenca esattamente le variabili disponibili per il tipo di template selezionato.
Gestisci le lingue
Ogni template può avere una versione separata per lingua. Cinque lingue hanno template predefiniti integrati: inglese, italiano, francese, tedesco e spagnolo. Puoi aggiungere qualsiasi altro codice locale (per esempio pt-BR) dal selettore lingua; le lingue senza default integrato ricadono sull’inglese finché non salvi una versione personalizzata.
Al momento dell’invio Auris risolve il template in questo ordine: template personalizzato nella lingua dell’utente -> template personalizzato in inglese -> default integrato nella lingua dell’utente -> default integrato in inglese.
Visualizza l’anteprima
L’anteprima live renderizza il template con dati di esempio mentre modifichi. Usa il selettore dispositivo per controllare i layout desktop, tablet e mobile, oppure apri l’anteprima a schermo intero.
Invia un’email di test
Clicca Invia test. Auris renderizza il template con dati di esempio e lo invia al tuo indirizzo email (l’amministratore autenticato). L’oggetto è prefissato con [TEST] per distinguerlo facilmente dalle email transazionali reali.
Salva il template
Clicca Salva per applicare le modifiche. Il template ha effetto immediato per tutte le email future di quel tipo e di quella lingua. Usa Ripristina default per eliminare la versione personalizzata della lingua corrente e tornare al template integrato.
I client email hanno un supporto HTML e CSS incoerente. Usa CSS inline e layout a tabelle per le strutture complesse, e invia email di test a client reali prima di salvare template di produzione. L’HTML salvato viene sanificato lato server (script, gestori di eventi e frame incorporati vengono rimossi) e ha un limite di 500 KB.
Variabili dei Template
Variabili Globali
Queste variabili di data vengono iniettate automaticamente in ogni render:
| Variabile | Descrizione | Valore di esempio |
|---|---|---|
{{year}} | Anno corrente | 2026 |
{{month}} | Mese corrente (due cifre) | 07 |
{{day}} | Giorno corrente (due cifre) | 23 |
{{date}} | Data corrente in formato YYYY-MM-DD | 2026-07-23 |
Variabili per Template
Ogni tipo di template ha il suo set di variabili:
| Template | Variabili |
|---|---|
verification | email, link, expiresIn |
password_reset | email, link, expiresIn |
invitation | email, orgName, role, inviterEmail, link, expiresIn |
mfa_code | email, code, expiresIn |
magic_link | email, link, approveLink, expiresIn, tenantName |
login_alert | email, device, ipAddress, location, time |
welcome | email, name, orgName, dashboardLink |
password_changed | email, name, time, ipAddress |
account_locked | email, name, lockDuration, attempts, ipAddress, time |
suspicious_login | email, name, device, ipAddress, location, time, reason |
email_changed | email, name, newEmail, time |
license_issued | key, jwtToken, product, expiresAt, features |
ciba | email, appName, bindingMessage, approveUrl, denyUrl |
Sintassi dei Template
{{variabile}}— sostituita con il valore, con escape HTML per sicurezza. Nell’oggetto (testo semplice, non HTML) i valori vengono inseriti senza escape.{{{variabile}}}— interpolazione raw senza escape HTML. Usala solo per frammenti HTML fidati costruiti lato server.{{#if variabile}}...{{/if}}— il contenuto racchiuso viene mantenuto solo quando la variabile ha un valore non vuoto. Utile per elementi opzionali come il pulsanteapproveLinkinmagic_link.
Non esiste la dot notation ({{user.name}} non è supportato) e non esistono cicli. I nomi delle variabili sono case-sensitive.
I placeholder sconosciuti restano invariati nell’output. Se un’email inviata contiene {{testo}}
letterale, controlla il nome della variabile nella tabella qui sopra.
Consegna Email e Footer
Auris invia le email tramite la configurazione SMTP del tuo tenant quando presente e attiva; in caso contrario usa il mittente predefinito della piattaforma. Le impostazioni SMTP, un test di connessione e le opzioni del footer si trovano in Console -> Impostazioni -> Email:
- Email white-label — rimuove l’attribuzione “Powered by Altovar” dal footer dei template predefiniti.
- Nascondi footer — omette del tutto la fascia del footer.
Questi interruttori si applicano ai template predefiniti (non personalizzati); un template personalizzato sostituisce l’intero HTML, footer incluso. Vedi Branding per i dettagli.
Riferimento API
I template email possono essere gestiti anche via API REST. Vedi l’API Template Email per richieste e risposte complete.
/api/email-templates/api/email-templates/{type}/api/email-templates/{type}/api/email-templates/{type}/api/email-templates/{type}/preview/api/email-templates/{type}/testPermessi
| Permesso | Descrizione |
|---|---|
manage:security | Richiesto per elencare, vedere, modificare, eliminare, visualizzare in anteprima e testare i template email. |
Guide Correlate
- Personalizzare i Template Email — Guida passo passo alla personalizzazione
- API Template Email — Gestione programmatica dei template
- Configurazione Branding — Logo, colori, footer email white-label
- Login con Magic Link — Riferimento tecnico dell’autenticazione via magic link