# I modelli di messaggio (template) {% hint style="warning" %} Le funzioni descritte in questa pagina sono disponibili solo per l'admin e il service manager {% endhint %} Dal dettaglio dell'evento è possibile consultare il modello di messaggio (*template*) di default configurato. {% hint style="info" %} Per modello di messaggio si intende il testo base di un messaggio, con segnaposto, disponibile per ogni evento e canale abilitato. {% endhint %} Ogni evento può avere un *template* distinto per App IO e per Email, ciascuno modificabile in modo indipendente o sincronizzato. I template con l'indicazione "**Fornito dalla piattaforma**" sono quelli suggeriti dalla piattaforma e sono sufficientemente astratti per essere utlizzati nella maggior parte dei casi d'uso. Tramite la funzione "**Cambia template di default**" è possibile scegliere un altro template (fornito o meno dalla piattaforma) compatibile con il tipo di evento.
## Creare un nuovo template I template forniti dalla piattaforma non sono modificabili; è possibile tuttavia crearne una copia e personalizzarla tramite l'icona "✏️" accanto al nome del template. Dopo aver associato un nome al nuovo template, bisogna scegliere se questo sarà uguale per tutti i canali di invio o se si preferisce personalizzarlo in base al canale. Si scrivono quindi l'oggetto e il testo del messaggio, inserendo, se serve, dei [campi variabili](#campi-variabili-dellevento). Infine, è possibile configurare uno o due pulsanti contenenti un link che rimanderà ad una pagina web. Un'anteprima a destra dà un'idea del risultato finale. {% hint style="success" %} Un messaggio ben scritto è costituito da frasi brevi e dirette e da un linguaggio semplice e non burocratico. L'oggetto del messaggio è il primo elemento che il cittadino vede. Per questo, deve essere specifico e descrittivo, non generico, ma comunque breve. Le informazioni più importanti nel testo devono emergere a colpo d'occhio, senza che il cittadino debba faticare per cercarle. Allo stesso tempo, il testo deve contenere tutto il necessario senza inutili appesantimenti, per evitare di perdere l'attenzione di chi legge. Per approfondire: [Linee guida di design per i servizi digitali della PA](https://docs.italia.it/italia/designers-italia/writing-toolkit/) {% endhint %}
## Campi variabili dell'evento {% hint style="info" %} I campi variabili sono dei dati variabili nel modello di messaggio che la piattaforma sostituisce con i dati reali del cittadino al momento dell'invio (es. importo, data appuntamento). {% endhint %} La sezione **Campi variabili dell'evento** elenca i campi facoltativi del messaggio e quelli che invece devono essere sempre presenti; se questi ultimi mancano, la piattaforma non genera il messaggio.
I campi obbligatori servono a garantire le funzionalità "in app" dei messaggi. Nel caso dei pagamenti, per esempio, la mancanza di un campo "IUV" non permetterà di effettuare il pagamento direttamente dall'App IO. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.opencityitalia.it/manuale-di-utilizzo-di-oc-connect/le-funzioni/i-modelli-di-messaggio-template.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.