> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Come si compone Notifuse

> Gli oggetti su cui si basa Notifuse, dai workspace ai contatti fino ai tre modi di inviare un'email, e come si collegano tra loro.

Un workspace di Notifuse contiene i tuoi contatti, le liste a cui si iscrivono e i template che scrivi. Puoi scrivere ai contatti in tre modi: un broadcast, una notifica transazionale o un'automazione. Ogni email inviata viene registrata nella cronologia dei messaggi, e la consegna vera e propria la fa il provider email che colleghi.

## Workspace

Un workspace è un tenant isolato. Ha un proprio database, proprie integrazioni, propri membri e proprie impostazioni.

Usa un workspace per ogni prodotto, brand o cliente. Un'installazione self-hosted può averne tre senza licenza, e ogni piano di Notifuse Cloud include un proprio numero di workspace.

Vedi [Workspace](https://www.notifuse.com/it/docs/features/workspaces.md).

## Contatti

Un contatto è una persona a cui puoi scrivere. L'indirizzo email identifica il contatto ed è l'unico campo obbligatorio.

Un contatto può avere anche un `external_id`, per esempio l'ID utente della tua app. È facoltativo e non univoco, quindi due contatti possono condividerlo.

L'importazione dei contatti e l'invio di una notifica transazionale associano i contatti tramite l'indirizzo email: il contatto viene creato se non esiste ancora e aggiornato se esiste già.

Vedi [Contatti](https://www.notifuse.com/it/docs/features/contacts.md).

## Liste e stati di iscrizione

Una lista è un gruppo di contatti che si sono iscritti a qualcosa, come una newsletter o gli aggiornamenti di prodotto. Una lista pubblica compare nel centro notifiche, dove i contatti possono iscriversi da soli. Una lista privata accoglie solo i contatti aggiunti dal workspace. Entrambi i tipi possono richiedere il double opt-in, con un proprio template di conferma.

Ogni contatto ha uno stato in ciascuna lista di cui fa parte:

| Stato        | Significato                                                                                              |
| ------------ | -------------------------------------------------------------------------------------------------------- |
| Attivo       | Iscritto. I broadcast alla lista raggiungono questo contatto.                                            |
| In attesa    | In attesa della conferma del double opt-in. Non riceve email finché non conferma.                        |
| Disiscritto  | Ha revocato l'iscrizione. È escluso dai broadcast, a meno che un broadcast sia impostato per includerlo. |
| Respinto     | L'indirizzo ha generato un bounce. Non riceve mai email.                                                 |
| Ha reclamato | Il contatto ha segnalato un'email come spam. Non riceve mai email.                                       |

Nella console, le liste si trovano nella pagina **Contatti**, nella colonna di sinistra.

Vedi [Liste](https://www.notifuse.com/it/docs/features/lists.md).

## Segmenti

Un segmento è un insieme di contatti che soddisfano delle regole. Le regole si combinano con AND e OR e possono considerare i campi del contatto, l'appartenenza alle liste, l'attività nella timeline del contatto, gli eventi personalizzati e gli obiettivi.

I segmenti si aggiornano quasi in tempo reale. Quando qualcosa viene scritto nella timeline di un contatto, Notifuse mette in coda quel contatto e un'attività in background ricalcola i suoi segmenti. Per impostazione predefinita l'attività viene eseguita ogni 30 secondi.

Una regola con una data relativa, come "ha aperto un'email negli ultimi 30 giorni", cambia con il passare del tempo anche se al contatto non succede nulla. Un'altra attività in background ricalcola questi segmenti.

Vedi [Segmenti](https://www.notifuse.com/it/docs/features/contacts.md#contact-segmentation-engine).

## Template

Un template è il contenuto di un'email: oggetto, mittente e corpo. Il corpo è in MJML, con Liquid per la personalizzazione, come `{{ contact.first_name }}`. I template hanno delle versioni, e ogni email inviata registra la versione che ha usato.

Scrivi un template in uno dei due editor. Lo scegli quando crei il template e poi non si può più cambiare:

- **Visuale**: blocchi da trascinare e rilasciare.
- **Codice (MJML)**: scrivi tu stesso il codice MJML.

Ogni template ha una categoria, per esempio marketing, transazionale, benvenuto oppure opt-in.

Vedi [Template](https://www.notifuse.com/it/docs/features/templates.md).

## Tre modi di inviare

### Broadcast

Un broadcast invia un template a una lista, una sola volta, subito o a un orario programmato.

Richiede esattamente una lista. Puoi restringerlo con dei segmenti: il broadcast va allora ai membri della lista che appartengono ad almeno uno dei segmenti. Più segmenti quindi si sommano, invece di restringere ulteriormente il pubblico.

I contatti respinti o che hanno reclamato sono sempre esclusi, così come i contatti in attesa di una lista con double opt-in. Anche i contatti disiscritti sono esclusi, a meno che tu non disattivi **Escludi i destinatari disiscritti** per un avviso che tutti i membri devono ricevere.

I broadcast passano per il provider marketing del workspace. Vedi [Broadcast](https://www.notifuse.com/it/docs/features/broadcast-campaigns.md).

### Notifiche transazionali

Una notifica transazionale è un'email che la tua app attiva per una persona: un reset della password, una conferma d'ordine, un invito. La crei nella console sotto **Transazionale**, le assegni un ID e un template, poi la invii dal tuo codice con `POST /api/transactional.send`.

Ogni richiesta indica un contatto. Notifuse crea o aggiorna quel contatto, poi invia l'email.

Le notifiche transazionali passano per il provider transazionale del workspace. Vedi [API transazionale](https://www.notifuse.com/it/docs/features/transactional-api.md).

### Automazioni

Un'automazione è un flusso in cui un contatto entra quando un evento arriva nella sua timeline. Tra i trigger ci sono la creazione o l'aggiornamento di un contatto, l'iscrizione a una lista o la disiscrizione, l'ingresso in un segmento o l'uscita, l'apertura o il click di un'email e un evento personalizzato inviato dalla tua app.

Il flusso è composto da nodi: ritardi, email, rami, filtri, test A/B, webhook, aggiunta a una lista o rimozione. Un trigger può scattare una sola volta per contatto oppure ogni volta che l'evento si verifica.

Le email delle automazioni passano per il provider marketing del workspace. Vedi [Automazioni](https://www.notifuse.com/it/docs/features/automations.md).

### Quale usare?

| Vuoi                                                                                                       | Usa                    |
| ---------------------------------------------------------------------------------------------------------- | ---------------------- |
| Inviare una newsletter o un annuncio a una lista                                                           | Broadcast              |
| Scrivere a una persona per qualcosa che ha fatto nella tua app, come reimpostare la password               | Notifica transazionale |
| Inviare una sequenza che parte da sola, come una serie di benvenuto o un'email per riconquistare i clienti | Automazione            |

## Cronologia dei messaggi e Log

Ogni email inviata da Notifuse occupa una riga nella cronologia dei messaggi. La riga rimanda a ciò che l'ha inviata (un broadcast, un'automazione o una notifica transazionale), alla lista quando c'è, e alla versione del template.

La riga registra anche quando l'email è stata consegnata, aperta e cliccata, e se ha generato un bounce, un reclamo o una disiscrizione.

Consulti la cronologia dei messaggi in **Log**, nella scheda **Messaggi**. Vedi [Log](https://www.notifuse.com/it/docs/features/logs.md).

## I provider email e i loro due ruoli

Notifuse non consegna le email da solo. Ogni workspace collega uno o più provider: SMTP, Amazon SES, Postmark, Mailgun, SendGrid, SparkPost o Mailjet.

Un workspace ha due ruoli di invio, e a ciascuno assegni un provider:

- **Email di marketing**: broadcast ed email delle automazioni.
- **Email transazionali**: notifiche inviate tramite l'API, Zapier o Supabase.

Un solo provider può svolgere entrambi i ruoli. Un ruolo senza provider non invia nulla. Mailjet può svolgere solo il ruolo transazionale.

Imposti i ruoli in **Impostazioni**, sotto **Integrazioni**. L'[avvio rapido Cloud](https://www.notifuse.com/it/docs/quickstart/cloud.md) e l'[avvio rapido self-hosted](https://www.notifuse.com/it/docs/quickstart/self-hosted.md) spiegano come fare, e ogni provider ha una propria pagina, come [SMTP](https://www.notifuse.com/it/docs/integrations/smtp.md) e [Amazon SES](https://www.notifuse.com/it/docs/integrations/amazon-ses.md).
