Modelli email, HTML e pagina di arrivo
La scheda Modelli contiene il catalogo disponibile nell'ambiente e I miei modelli del tenant. Il catalogo si filtra per categoria; la ricerca considera nome, riepilogo e categoria del catalogo, oppure nome e oggetto dei modelli personali. Anteprima non invia email. Usa modello crea la copia utilizzabile dal tenant.
La modifica richiede campaign.manage. Ogni salvataggio di un modello esistente crea una nuova versione: le campagne già create conservano quella scelta. L'adozione di una nuova versione nella bozza è un'azione esplicita.
Scegliere il percorso di creazione
| Obiettivo | Percorso | Conseguenza |
|---|---|---|
| Adattare una struttura già disponibile | Catalogo → Anteprima → Usa modello | Crea una copia nel tenant e apre la personalizzazione; la modifica non cambia il catalogo |
| Scrivere un messaggio da zero | Nuovo modello → HTML email | Il nuovo editor contiene uno starter HTML con collegamento gestito; completare anche learning e landing |
| Correggere il testo per le campagne future | I miei modelli → Modifica → Salva nuova versione | La libreria espone la nuova versione; le campagne esistenti mantengono quella scelta |
| Aggiornare una bozza alla nuova versione | Wizard → Messaggio → Usa versione … | Aggiorna la scelta della bozza e richiede una nuova verifica |
| Togliere il modello dalle nuove scelte | Rimuovi dai miei modelli | Archivia senza riscrivere campagne e bozze storiche |
| Conservare modifiche a un modello archiviato da un'altra sessione | Salva bozza come nuovo modello | Crea una risorsa distinta, invece di aggiungere versioni al modello archiviato |
Personalizzare un modello del catalogo
- Nella scheda Modelli, filtrare categoria o testo e aprire Anteprima del modello desiderato.
- Verificare oggetto, corpo e Dati formativi. Premere Usa modello: la copia entra nei modelli del tenant e si apre l'editor.
- Compilare nome e oggetto. In Guidato, modificare i campi esposti e aprire Altri dettagli dell'email quando presente. In HTML, seguire la policy descritta sotto.
- Aprire Dettagli formativi e verificare tutti i cinque elementi: obiettivo, pubblico, indizi, difficoltà e pertinenza. Adattare il contenuto al pubblico effettivo.
- Aprire Pagina di arrivo e rivedere titolo, testo, pulsante e simulazione form. Questi campi sono distinti dall'email HTML.
- Controllare anteprima Desktop e Mobile e attendere l'ultima validazione. Usare Salva nuova versione.
- Tornare al wizard e scegliere la versione appena salvata; verificare nell'anteprima della campagna che il contenuto sia quello atteso.
Esito atteso: modello salvato con una versione esplicita, anteprima valida e campagna collegata alla versione desiderata. Se cambia solo la libreria, la bozza non adotta automaticamente la modifica.
Campi comuni e contenuti
| Campo | Vincoli | Funzione |
|---|---|---|
| Nome del modello | Non vuoto, massimo 160 caratteri | Nome interno nella libreria e nella scelta della campagna |
| Oggetto email | 1–200 caratteri; nessun ritorno a capo | Oggetto del messaggio; soggetto alla policy sui contenuti in uscita |
| Lingua | Italiano o inglese, conservata nel modello | Un cambio della lingua della console non traduce i testi già personalizzati |
| Campi guidati | Etichette e lunghezze specifiche del modello di catalogo | Modificano soltanto i nodi di testo previsti dal modello; aprire anche Altri dettagli dell'email |
| Codice HTML dell'email | Formato html-v1, massimo 65.536 byte UTF-8 | Contenuto dell'email HTML; distinto dalla pagina di arrivo |
| Immagini | Massimo 5 risorse distinte | Caricamento verificato e ricodificato dal servizio |
| Obiettivo didattico | Testo non vuoto, massimo 2.000 caratteri | Competenza che si vuole esercitare |
| Pubblico | Testo non vuoto, massimo 2.000 caratteri | Destinatari e contesto formativo |
| Indizi, uno per riga | Da 1 a 30 indizi; ciascuno non vuoto, massimo 2.000 caratteri | Elementi da riconoscere nel messaggio; righe vuote eliminate al salvataggio |
| Difficoltà | Testo non vuoto, massimo 2.000 caratteri | Motivazione della difficoltà dello scenario |
| Pertinenza | Testo non vuoto, massimo 2.000 caratteri | Perché lo scenario è adeguato al pubblico |
| Pagina di arrivo: Titolo | 1–300 caratteri | Titolo dopo l'apertura del collegamento della simulazione |
| Pagina di arrivo: Testo | 1–12.000 caratteri | Corpo della pagina di arrivo |
| Pagina di arrivo: Pulsante | 1–100 caratteri | Etichetta dell'azione gestita dalla piattaforma |
| Simulazione di invio form | Booleano; iniziale disattivato | Abilita l'interazione simulata di invio form |
Un modello nuovo precompila soltanto alcuni testi della pagina di arrivo. Nome, oggetto e dettagli formativi devono essere completati. La validazione dell'anteprima può usare segnaposto temporanei per mostrare l'email mentre si compila: vedere l'anteprima non significa che tutti i campi necessari al salvataggio siano completi.
Nei modelli storici senza contenuto HTML separato, Titolo, Messaggio e Pulsante alimentano anche l'email legacy. Nei modelli html-v1, i campi della pagina di arrivo non modificano l'email.
Modalità guidata e HTML
La modalità Guidato è disponibile quando il catalogo definisce campi modificabili sulla struttura conservata. I limiti dipendono dal modello e sono controllati anche sulla lunghezza UTF-8 del valore.
HTML email consente di incollare contenuto, usare Importa .html oppure Crea email HTML. Dopo una personalizzazione strutturale dell'HTML non è possibile ritornare liberamente a Guidato senza perdere la corrispondenza dei campi: la console disabilita tale passaggio.
Inserisci variabile → Collegamento simulazione inserisce il segnaposto {{simulation_url}}, da usare nell'attributo href di un collegamento. La piattaforma sostituisce il segnaposto al momento dell'invio. Non inserire un URL di stage, un link di una campagna precedente o un destinatario reale nel modello.
Importare HTML e immagini
- Selezionare HTML email → Importa .html, oppure incollare il codice nel campo dedicato.
- Sostituire le destinazioni dei collegamenti con il segnaposto della simulazione. Eliminare risorse remote e contenuti non ammessi; il validatore rifiuta l'intero contenuto non conforme.
- Se servono immagini, caricarle da Immagini, posizionare il cursore nell'HTML e scegliere Inserisci nell'HTML per ciascuna risorsa.
- Attendere l'anteprima. Se viene indicata un'immagine mancante, confrontare il riferimento
asset:con gli identificativi effettivamente caricati. - Verificare Desktop/Mobile e salvare. Per eliminare un'immagine, togliere prima i suoi riferimenti dall'HTML e poi premere Rimuovi.
L'anteprima non è una conversione automatica di HTML esterno arbitrario: text_destination, css_value, asset_missing, document_structure, html_size e node_limit richiedono una correzione della parte indicata.
<!doctype html>
<html lang="it">
<body>
<table role="presentation" width="100%">
<tr><td style="font-family:Arial,sans-serif;font-size:16px;padding:24px">
<h1>Documento condiviso</h1>
<p>È disponibile una nuova comunicazione del gruppo di lavoro.</p>
<a href="{{simulation_url}}">Apri la comunicazione</a>
</td></tr>
</table>
</body>
</html>
L'esempio mostra solo il contenuto HTML. Per salvare il modello occorre compilare anche oggetto, pagina di arrivo e contesto formativo.
Policy HTML applicata dal servizio
Il servizio valida e compila l'HTML; non è un editor per pagine web arbitrarie.
| Elemento | Supporto e limiti |
|---|---|
| Tag | html, body, tabelle (table, thead, tbody, tfoot, tr, td, th), div, span, p, br, hr, h1–h6, strong, b, em, i, u, ul, ol, li, a, img |
| Collegamenti | Da 1 a 8; ogni a deve avere href="{{simulation_url}}" |
| Immagini HTML | Massimo 20 occorrenze, riferite alle risorse del modello con src="asset:IDENTIFICATIVO" |
| Risorse caricate | Tutte le risorse dichiarate devono comparire nell'HTML; nessun riferimento a risorse mancanti |
| Dimensione | HTML originale e canonico entro 65.536 byte UTF-8; anche il testo prodotto deve rientrare nel limite |
| Struttura | Massimo 2.000 nodi, profondità 32, massimo 20 attributi per elemento |
| Attributi descrittivi | alt e title entro 300 caratteri e senza destinazioni esterne o variabili |
| Lingua e direzione | lang valido, dir uguale a ltr, rtl o auto |
| Ruolo | Solo role="presentation" |
| Allineamento | align: left/right/center; valign: top/middle/bottom/baseline |
| Dimensioni HTML | width/height fino a 1.200 o 100%; dimensione minima delle immagini 2; celle e spaziature hanno limiti dedicati |
| Celle e bordi | colspan/rowspan 1–32; cellpadding/cellspacing 0–120; border 0–10 |
Script, form HTML, input, iframe, SVG, oggetti, risorse remote, eventi JavaScript e attributi non previsti vengono rifiutati. Il head non può contenere metadati, stylesheet o altro contenuto attivo. Le immagini si caricano dalla sezione Immagini, non da URL remoti o stringhe data URI incollate nell'editor.
Il testo di oggetto, email, titolo, corpo e pulsante della landing non può contenere URL, indirizzi email, domini, IP o schemi di collegamento esterni. Il controllo considera anche forme codificate e Unicode. Per il debrief vale la stessa regola su canale, contenuto e supporto: usare il nome del canale, ad esempio “Portale formazione”, senza indirizzo.
CSS inline ammesso
Usare l'attributo style; non sono supportati fogli di stile, funzioni CSS, variabili, url(), escape o !important. Ogni stile è limitato a 2.048 byte e 32 dichiarazioni, senza proprietà duplicate.
| Gruppo | Proprietà e valori |
|---|---|
| Colori | color, background-color, colori del bordo e dei suoi lati; esadecimali a 3/6 cifre o nomi supportati |
| Font | font-family: Arial, Helvetica, Segoe UI, Calibri, Verdana, Georgia, Times New Roman, Tahoma, Courier New, sans-serif, serif, monospace; massimo 8 famiglie |
| Dimensione testo | font-size da 8 a 72 pixel equivalenti, unità px/pt/em/rem |
| Peso e stile | font-weight: normal, bold oppure 100–900 a passi di 100; font-style: normal/italic |
| Interlinea | line-height: normal, numero 1–3 o lunghezza/percentuale ammessa dal validatore |
| Testo | text-align: left/right/center/justify; text-decoration: none/underline/line-through; vertical-align: top/middle/bottom/baseline |
| Display | block, inline, inline-block, table, table-row, table-cell |
| Dimensioni | width/min-width/max-width/height/min-height/max-height: auto oppure lunghezza positiva fino a 1.200 pixel equivalenti o 100% |
| Spaziatura | margin/padding e singoli lati fino a 120 pixel equivalenti; margin ammette auto |
| Bordi | width fino a 10 pixel equivalenti; style none/solid/dashed/dotted; colori ammessi; shorthand con dimensione, stile e colore oppure 0 |
| Tabelle | border-collapse: collapse/separate; border-spacing fino a 120 pixel equivalenti |
| Angoli | border-radius fino a 100 pixel equivalenti |
Per i colori nominali sono supportati black, white, red, green, blue, gray/grey, silver, navy, teal, purple, maroon, olive, yellow, aqua, fuchsia e orange. Se il compilatore rifiuta lo stile, ridurre la regola alla proprietà e all'unità supportate e aggiornare l'anteprima.
Immagini
Sono accettati PNG, JPEG e WebP statici, fino a 5 MiB per file in ingresso e 16 milioni di pixel. Il servizio orienta e ridimensiona dentro 1.200 × 1.200 senza ingrandire, ricodifica in PNG e richiede un risultato entro 2 MiB. Il totale delle risorse email non può superare 5 MiB.
Caricare l'immagine, quindi usare Inserisci nell'HTML nella posizione desiderata. La console inserisce il riferimento alla risorsa. Prima di Rimuovi eliminare quel riferimento dall'HTML; altrimenti il modello resterebbe incoerente. L'identificativo non è un URL da distribuire.
Anteprima, salvataggio e archiviazione
Controllare Desktop e Mobile; l'anteprima è validata dal servizio, i collegamenti di invio non sono attivi e non viene inviata alcuna email. Un rendering nella preview non garantisce identica resa in tutti i client di posta: usare la prova del mittente e il percorso di verifica previsto per l'esercitazione.
Salva nuova versione usa la versione corrente come base. Se un'altra sessione l'ha modificata o archiviata, leggere il conflitto e conservare il lavoro locale prima di ricaricare o salvare come nuovo modello.
Rimuovi dai miei modelli archivia il modello per le nuove scelte. Bozze e campagne che lo usano conservano la versione già selezionata. La rimozione dalla libreria non riscrive email o contenuti storici delle campagne.