# Template

> Progetta un’email una volta e riusala negli invii con l’API, nelle automazioni e nelle campagne. Alias, versioni, tre editor, variabili Temple e API dei template.

Un template memorizza l’oggetto, i dati del mittente e il contenuto di un’email, così puoi progettarla una volta e riusarla. Crea i template nel pannello con un editor drag and drop, rich-text o HTML, oppure gestiscili con l’API, poi inviali tramite alias e compila i dati personali al momento dell’invio.

## Come funziona

1. **Crea un template** in **Email Marketing → Templates** o con l’API. Assegnagli un nome e un alias, ad esempio `welcome-email`.
2. **Progetta il contenuto** in uno dei tre editor, con segnaposto come `{{first_name}}` dove vanno i dati personali.
3. **Pubblicalo.** Il primo template con un nuovo alias viene pubblicato automaticamente. I template che aggiungi in seguito con lo stesso alias diventano versioni in bozza, da pubblicare quando sono pronte.
4. **Invialo.** Chiama `POST /emails` con `"template": "welcome-email"` e un oggetto `variables`. Emailit elabora la versione pubblicata con [Temple](/it/docs/templates/temple/) e la invia.

Poiché il tuo codice fa riferimento all’alias e non a un template specifico, puoi cambiare il design e pubblicare una nuova versione senza distribuire codice.

## Cosa contiene un template

| Campo | Dettagli |
| --- | --- |
| Nome | Un’etichetta per il tuo team, fino a 191 caratteri. |
| Alias | L’identificatore usato dal tuo codice, fino a 191 caratteri tra `a–z`, `0–9`, `_` e `-`. Tutte le versioni di un template condividono lo stesso alias. |
| Editor | **Dragit** (drag and drop), **Rich Text** o **HTML**. |
| Oggetto | L’oggetto predefinito, fino a 191 caratteri. Può contenere segnaposto. |
| From | Il mittente predefinito, ad esempio `Acme <hello@acme.com>`. |
| Reply-To | Uno o più indirizzi di risposta facoltativi. |
| Contenuto | Il corpo HTML, un corpo in testo semplice facoltativo (tramite l’API) e, per i template Dragit, il design in JSON Dragit. |

## Dove puoi usare i template

| Dove | Come usa il template | Segnaposto |
| --- | --- | --- |
| [API email](/it/docs/email-api/send-email/#send-with-a-template) | `template` accetta un alias (versione pubblicata) o un ID `tem_` (quella versione esatta). Oggetto, HTML, testo e Reply-To vengono dal template, a meno che la richiesta non li sovrascriva. Il `from` della richiesta è sempre obbligatorio. | [Temple](/it/docs/templates/temple/), compilati da `variables` |
| [Automazioni](/it/docs/automations/steps/) | Il passaggio **Send email** invia un template. Vengono usati From, oggetto e Reply-To del template, a meno che il passaggio non li sovrascriva. | Temple, compilati dal contatto e dal trigger |
| [Campagne](/it/docs/campaigns/create/) | **Choose from templates** copia il contenuto di un template nella campagna come punto di partenza. **Save as template** trasforma una campagna in un template. | [Tag di unione delle campagne](/it/docs/campaigns/merge-tags/) |
| [SMTP relay](/it/docs/smtp/) | Non disponibile. SMTP invia il messaggio esattamente come l’hai costruito. | Nessuno |

## Cosa puoi fare

  - [Editor](/it/docs/templates/editors/): Crea i template e progettali con Dragit, Rich Text o HTML.
  - [Il linguaggio Temple](/it/docs/templates/temple/): Variabili, valori predefiniti e condizioni, e dove vengono elaborati.
  - [Versioni](/it/docs/templates/versions/): Prepara una nuova versione con lo stesso alias e pubblicala quando è pronta.
  - [Importazione ed esportazione](/it/docs/templates/import-export/): Importa pacchetti JSON Dragit, HTML o ZIP ed esportali di nuovo.

## API dei template

Gestisci i template dal codice con l’[API dei template](/it/docs/api-reference/templates/):

| Endpoint | A cosa serve |
| --- | --- |
| [Crea un template](/it/docs/api-reference/templates/create/) | Aggiungere un template o una nuova versione di un alias esistente. |
| [Recupera un template](/it/docs/api-reference/templates/get/) | Ottenere una versione, con il suo contenuto e l’elenco delle altre versioni. |
| [Aggiorna un template](/it/docs/api-reference/templates/update/) | Modificare i campi o il contenuto di una versione. |
| [Elenca i template](/it/docs/api-reference/templates/list/) | Elencare la versione pubblicata di ogni alias. |
| [Pubblica un template](/it/docs/api-reference/templates/publish/) | Rendere una versione quella attiva per il suo alias. |
| [Elimina un template](/it/docs/api-reference/templates/delete/) | Eliminare una versione. |

L’API richiede una chiave **Full Access**. Le modifiche generano gli eventi webhook `template.created`, `template.updated` e `template.deleted`. L’importazione e l’esportazione di file sono disponibili solo nel pannello.

## Disponibilità

I template sono disponibili in tutti i piani senza costi aggiuntivi. Memorizzare i template non consuma crediti; ogni email che invii con un template viene addebitata come qualsiasi altro invio.

## Inizia

  - [Crea un template](/it/docs/templates/editors/#create-a-template): Imposta nome, alias ed editor, poi progettalo.
  - [Invia con un template](/it/docs/email-api/send-email/#send-with-a-template): Invia dal tuo codice tramite alias con le variabili.

---
Fonte: https://emailit.com/it/docs/templates/