# E-mail predefinite

> Come il proprietario e l'amministratore cambiano il testo delle e-mail che la piattaforma invia a nome della community (benvenuto, inviti, importazione, richiesta di accesso approvata, acquisto confermato e iscrizione all'evento), con una versione per lingua, blocchi fissi, variabili consentite, link e cosa succede quando la versione della community non si può usare.

Alcune e-mail la piattaforma le invia da sola, a nome della community: il benvenuto a chi si iscrive, l'invito, la ricevuta dell'acquisto. In **E-mail predefinite**, il proprietario e l'amministratore sostituiscono il loro testo con quello della community, nello stesso editor delle [campagne e-mail](/notificacoes/campanhas-de-email), senza cambiare quando né a chi partono.

**Dove si trova:** **Amministrazione › Campagne › E-mail predefinite**. Solo il proprietario e l'amministratore vedono la scheda; il moderatore e la finanza no.

## Le e-mail che si possono cambiare

Sono sei famiglie, in tre gruppi:

| Gruppo | E-mail | Chi la riceve |
|---|---|---|
| **Ingresso** | **Benvenuto all'iscrizione** | Chi si iscrive alla community |
| **Ingresso** | **Invito (nuovo account)** e **Invito (account esistente)** | Chi viene invitato |
| **Ingresso** | **Importazione (nuovo account)** e **Importazione (account esistente)** | Chi è stato importato da foglio di calcolo |
| **Ingresso** | **Richiesta di accesso approvata** | Chi ha chiesto di creare una community ed è stato approvato |
| **Acquisti** | **Acquisto confermato** | La ricevuta di chi ha acquistato |
| **Eventi** | **Iscrizione all'evento** | La conferma del **Partecipo**, con il biglietto quando c'è il check-in |

L'elenco mostra se ognuna è **Predefinita** o **Personalizzata** e in quali lingue (*"Personalizzata in: …"*). **Acquisto confermato** e **Iscrizione all'evento** portano l'etichetta **Sempre inviata**: non hanno il link di disiscrizione e non accettano blocchi promozionali. Le altre rispettano la categoria dell'e-mail in [E-mail di questa community](/notificacoes/emails-desta-comunidade) e portano il link per disattivarla.

## Come funziona

### Una versione per lingua

Ogni e-mail predefinita ha una versione della community per lingua. Chi legge in una lingua senza versione della community riceve l'e-mail predefinita della piattaforma in quella lingua. **Usa la versione della community**, disattivato, fa partire la predefinita in tutte le lingue, e le versioni restano salvate.

**Ripristina predefinita** elimina la versione della community nella lingua aperta e chiede conferma: chi legge in quella lingua torna a ricevere la predefinita.

### Blocchi fissi

Ogni e-mail ha dei **blocchi fissi**, che la piattaforma compila: il pulsante per impostare la password o per accedere, il pulsante per entrare nella community, l'origine del contatto e il link *"non voglio partecipare"* nell'importazione, il riepilogo dell'acquisto nella ricevuta, e la data, il luogo e il biglietto con codice QR nell'iscrizione all'evento. Nell'editor compaiono come **Fisso**: si possono spostare, ma non togliere. Una versione senza un blocco fisso non viene salvata.

L'e-mail predefinita accetta testo, pulsante, immagine e i blocchi fissi; i blocchi con i contenuti della community (post, corsi, eventi, prodotti) non entrano.

### Variabili

Tutte accettano `{{nome}}`, `{{nome_completo}}`, `{{comunidade}}` e `{{membro_desde}}`, e ognuna ha le proprie:

| E-mail | Variabili proprie |
|---|---|
| Benvenuto all'iscrizione | `{{link_comunidade}}` |
| Invito (nuovo account) | `{{convidado_por}}`, `{{validade_dias}}` |
| Invito (account esistente) | `{{convidado_por}}`, `{{link_login}}` |
| Importazione (nuovo account) | `{{origem}}`, `{{validade_dias}}` |
| Importazione (account esistente) | `{{origem}}`, `{{link_login}}` |
| Acquisto confermato | `{{produto}}`, `{{valor}}`, `{{metodo}}`, `{{link_acesso}}` |
| Iscrizione all'evento | `{{evento}}`, `{{data_hora}}`, `{{local}}`, `{{link_evento}}` |

Una variabile che non è dell'e-mail viene rifiutata al salvataggio, e una variabile non può stare dentro un link o l'indirizzo di un'immagine.

### Link

Link e immagini solo con `https://`. Nella ricevuta (**Acquisto confermato**) e nell'**Iscrizione all'evento**, link e pulsanti possono puntare solo al dominio della community stessa.

### Quando la versione della community non viene usata

Se la versione della community non si può usare al momento dell'invio (per esempio, l'e-mail della libreria collegata è stata eliminata), la persona riceve l'e-mail predefinita della piattaforma, e non manca nulla. I proprietari ricevono un avviso, *"l'e-mail … è uscita come predefinita"*, con il motivo, al massimo una volta al giorno per ogni e-mail.

### Invio e test

L'e-mail predefinita parte nello stesso modo e nello stesso momento in cui partirebbe quella della piattaforma: non conta nella quota delle campagne. **Inviami una prova** invia la versione aperta solo a chi ha effettuato l'accesso.

## Passo dopo passo

1. In **Amministrazione › Campagne**, apri **E-mail predefinite**.
2. Fai clic sull'e-mail che vuoi cambiare e scegli la **Lingua**.
3. Scrivi l'oggetto e il testo, con le variabili dell'elenco e i blocchi fissi dove vuoi.
4. **Salva**. Controlla con **Inviami una prova**.
5. Lascia attivo **Usa la versione della community**.

## Errori comuni e come risolverli

| Messaggio | Perché | Cosa fare |
|---|---|---|
| *Mancano i blocchi fissi: … Non possono essere rimossi.* | È stato rimosso un blocco fisso | Annulla la rimozione o usa **Ripristina predefinita** |
| *La variabile … non esiste in questa e-mail.* | Variabile di un'altra e-mail | Usa solo le variabili della tabella |
| *Link e immagini solo con https://.* | Link o immagine con `http://` | Sostituisci con `https://` |
| *In ricevute e biglietti, link e pulsanti solo verso il dominio della community.* | Link a un altro sito nella ricevuta o nell'iscrizione all'evento | Punta a una pagina della community |
| *L'e-mail predefinita contiene solo testo, pulsante, immagine e i blocchi fissi.* | Blocco con contenuti della community | Togli il blocco |

## Con l'assistente (MCP)

Il proprietario e l'amministratore leggono, modificano, attivano, disattivano, ripristinano e provano le e-mail predefinite con l'assistente; il ripristino chiede conferma, e il test va solo a chi lo chiede. Vedi [Strumenti · Community](/mcp/ferramentas-comunidade#libreria-di-e-mail-ed-e-mail-predefinite).

## Nell'API

`GET /api/email-overrides` elenca le e-mail predefinite; `GET` e `PATCH /api/email-overrides/{emailKey}` leggono e attivano o disattivano la versione della community; `GET`, `PUT` e `DELETE /api/email-overrides/{emailKey}/{language}` leggono, salvano e ripristinano una versione; `POST …/preview` e `POST …/test` mostrano e provano. Solo proprietario e amministratore (`403` per gli altri). I blocchi fissi sono `{ "type": "systemSlot", "slot": "…" }`.

## Correlati

- [Campagne e-mail](/notificacoes/campanhas-de-email)
- [E-mail di questa community](/notificacoes/emails-desta-comunidade)
- [E-mail della piattaforma](/notificacoes/emails-da-plataforma)