# Come funziona Emailit

> Il modello di Emailit in una pagina. Workspace, domini e chiavi API, i modi per inviare e ricevere, il ciclo di vita di un’email, i crediti e la modalità sandbox.

Questa pagina spiega i componenti principali di Emailit e come si combinano. Leggila una volta prima di sviluppare qualsiasi cosa: il resto della documentazione dà per scontato che tu conosca questi termini.

## Account e workspace

Il tuo **account** sei tu: un indirizzo email, una password e, facoltativamente, l’autenticazione a due fattori o le passkey. Tutto ciò che invii si trova in un workspace. Un account può appartenere a più workspace, e passi dall’uno all’altro con il selettore dei workspace in cima alla barra laterale. Una configurazione comune prevede un workspace per prodotto o per ambiente, ad esempio `Acme` e `Acme Staging`.

Ogni workspace ha i propri:

| Risorsa | Cos’è |
| --- | --- |
| Domini di invio | I domini che verifichi con i record DNS perché Emailit possa inviare per loro conto. Ogni indirizzo From deve essere su un dominio di invio verificato. |
| Chiavi API | Secret che iniziano con `secret_`. Autenticano l’API REST, il server MCP e l’SMTP relay. Una chiave è **Full Access** o **Sending Only**. |
| Membri | Le persone che possono aprire il workspace, con ruolo **Admin** o **Member**. Gli amministratori gestiscono anche impostazioni, chiavi API, membri e fatturazione. |
| Fatturazione | Un piano, un saldo di crediti, le impostazioni della ricarica automatica e le fatture. |
| Dati | Email, eventi, log, contatti, liste, template, webhook e soppressioni. |

Chiavi API, domini, contatti e crediti appartengono a un solo workspace. Una chiave API non funziona mai in un altro workspace.

## Modi per inviare, e uno per ricevere

| Canale | A cosa serve | Come |
| --- | --- | --- |
| API REST | Email transazionali dal tuo codice: registrazioni, reimpostazioni della password, ricevute | `POST https://api.emailit.com/v2/emails` con una chiave API, o un [SDK](/it/docs/sdks/) |
| SMTP relay | App, framework e strumenti che parlano già SMTP | Host `smtp.emailit.com`, nome utente `emailit`, la tua chiave API come password |
| Campagne e automazioni | Newsletter, annunci e sequenze di onboarding per i tuoi contatti | Si creano nel pannello, in **Email Marketing** |
| Email in entrata | Ricezione di email sul tuo dominio, per risposte o assistenza | Un record MX su `inbound.<your domain>`. Ogni messaggio genera `email.received`. |

Tutti i canali usano gli stessi domini verificati e la stessa lista di soppressione. L’API e l’SMTP relay condividono anche le chiavi API, i log delle richieste e un unico insieme di limiti di invio. Per scegliere tra i due, vedi [API o SMTP](/it/docs/get-started/api-or-smtp/).

## Il ciclo di vita di un’email

Ogni email segue lo stesso percorso, in qualunque modo la invii:

1. **Accettata.** L’API o l’SMTP relay controlla la richiesta: una chiave API valida, un indirizzo From su un dominio verificato, le regole della sandbox, i limiti di invio e i crediti. Ogni destinatario diventa un’email separata con il proprio ID `em_` e lo stato `accepted`, oppure `scheduled` se hai impostato un orario di invio. L’API genera `email.accepted` o `email.scheduled`.
2. **In coda e controllata.** Un worker di consegna prende l’email e la controlla di nuovo. Un destinatario nella [lista di soppressione](/it/docs/suppressions/) rende l’email `suppressed`. Un dominio in pausa, un workspace sospeso o un saldo di crediti esaurito la rendono `held`.
3. **Firmata e valutata.** Emailit firma il messaggio con DKIM per il tuo dominio e imposta il return path su `emailit.<your domain>`. Se il tracciamento è attivo, riscrive i link e aggiunge un pixel di apertura. Poi esegue un controllo antispam. Un messaggio con punteggio pari o superiore a 7 diventa `held`, e le regole corrispondenti compaiono in **Spam Checks** nella pagina dell’email.
4. **Tentativi di consegna.** Emailit si collega al server di posta del destinatario. Un rifiuto permanente (una risposta 5xx) rende l’email `bounced`. Un errore temporaneo (una risposta 4xx o un timeout) la rende `attempted`, ed Emailit ritenta fino a 7 volte nell’arco di circa 21 ore prima di rinunciare e segnarla come `bounced`.
5. **Consegnata.** Il server ricevente ha accettato il messaggio, quindi l’email è `delivered`. Un report di bounce che arriva in seguito può comunque trasformarla in `bounced`, e una segnalazione di spam dal provider di posta la rende `complained`. Gli indirizzi con bounce o segnalazioni possono essere aggiunti automaticamente alla lista di soppressione.
6. **Aperta e cliccata.** Se il dominio ha un [sottodominio di tracciamento](/it/docs/tracking/) verificato, le aperture rendono l’email `loaded` e i clic la rendono `clicked`.

Ogni cambio di stato viene registrato come **evento**. Gli eventi compaiono nella pagina dell’email e in **Email API → Events**. Vengono anche inviati ai tuoi [webhook](/it/docs/webhooks/) come JSON firmato, in batch di massimo 100 eventi per richiesta.

| Gruppo | Stati |
| --- | --- |
| In viaggio | `accepted`, `scheduled`, `attempted` |
| Arrivate | `delivered`, `loaded`, `clicked`, `received` (in entrata) |
| Fermate | `bounced`, `failed`, `rejected`, `suppressed`, `complained`, `canceled`, `held` |

Puoi annullare un’email mentre è `scheduled`, `accepted` o `attempted`. Puoi ritentare un’email `held`, `bounced`, `failed` o `suppressed` dopo averne risolto la causa. Per il significato di ogni stato, vedi [Stati delle email](/it/docs/logs/email-statuses/).

## Crediti

Emailit fattura in crediti. Ogni workspace ha un saldo composto dai crediti inclusi ogni mese nel piano più quelli che acquisti. I crediti inclusi vengono usati per primi. I crediti acquistati non scadono mai.

| Azione | Crediti |
| --- | --- |
| Email inviata con l’API o SMTP (per destinatario) | 1 |
| Email in entrata ricevuta | 1 |
| Email di una campagna (per destinatario) | 2 |
| Esecuzione di un’automazione | 3 |
| Verifica email (per indirizzo) | 5 |

Se il saldo non copre un invio, l’API restituisce `402` e non viene inviato nulla. Le email che arrivano alla coda di consegna senza crediti sufficienti diventano `held`, e puoi ritentarle dopo aver aggiunto crediti. Attiva la [ricarica automatica](/it/docs/billing/auto-refill/) perché la posta di produzione non si fermi mai. Per piani e prezzi, vedi [Crediti](/it/docs/billing/credits/) e la [pagina dei prezzi](/pricing/).

## Sandbox e accesso alla produzione

Ogni nuovo workspace parte in **modalità sandbox**. In modalità sandbox puoi inviare solo agli indirizzi email degli account dei membri del workspace, e le campagne sono bloccate. L’invio a chiunque altro non riesce: l’API restituisce `403 unverified_workspace_recipient` e l’SMTP relay risponde `550`.

Per inviare a destinatari reali, verifica almeno un dominio di invio. Poi un amministratore richiede l’accesso alla produzione dal banner della sandbox o da **Workspace → Settings → Requests**. La richiesta chiede cosa invii, il volume previsto e come le persone danno l’opt-in. Il team di Emailit la esamina e risponde nella stessa conversazione della richiesta. Vedi [Accesso alla produzione](/it/docs/workspaces/production-access/).

Ogni workspace ha anche dei [limiti di invio](/it/docs/limits/), condivisi tra API e SMTP. I nuovi workspace possono inviare 2 email al secondo e 5000 email al giorno. I workspace Pro e Business ricevono aumenti automatici in base alla salute degli invii, e qualsiasi workspace può chiederne di più dal riquadro **Sending Limits** della home page del pannello.

## Il pannello

Il pannello su [dash.emailit.com](https://dash.emailit.com) segue lo stesso modello. La barra laterale ha queste sezioni, dall’alto verso il basso:

| Sezione | Pagina | A cosa serve |
| --- | --- | --- |
| Dashboard | | Checklist di configurazione, azioni rapide, crediti, volume giornaliero, salute degli invii e limiti di invio |
| Email Marketing | Overview | Crescita dei contatti e attività di marketing recente |
| | Audiences | Liste di iscritti con un nome, a cui vengono inviate le campagne |
| | Contacts | Tutte le persone del workspace, con campi personalizzati, importazione ed esportazione |
| | Campaigns | Crea, prova, programma e analizza le campagne |
| | Templates | Design riutilizzabili per l’API, le automazioni e le campagne |
| | Forms | Moduli di iscrizione (accesso anticipato) |
| | Automations | Flussi avviati da contatti, date ed eventi email (beta) |
| Email API | Emails | Ogni email in uscita e in entrata, con stato, contenuto e tentativi di consegna |
| | Analytics | Invii, bounce, segnalazioni, aperture e clic nel tempo |
| | Domains | Aggiungi domini, pubblica i record DNS, controlla verifica e tracciamento |
| | DMARC reports | Chi invia posta a nome del tuo dominio (da Pro in su) |
| | Events | Il flusso di eventi del workspace che ricevono i webhook |
| | Logs | Ogni richiesta API e SMTP, con codici di stato e corpi |
| | API Keys | Crea, rinomina, rigenera ed elimina le chiavi, e consulta le impostazioni SMTP |
| | Webhooks | Endpoint, selezione degli eventi e ogni tentativo di consegna |
| | Suppressions | Gli indirizzi a cui Emailit non invierà, con importazione ed esportazione CSV |
| Email Verification | Emails | Controlla un singolo indirizzo prima di inviare |
| | Lists | Controlla fino a 10.000 indirizzi in una volta |
| Workspace | Billing | Piano, crediti, ricarica automatica, add-on e fatture |
| | Settings | Nome, membri, campi personalizzati, conservazione dei dati, impostazioni delle soppressioni e richieste |

Le impostazioni dell’account (profilo, password, autenticazione a due fattori e passkey) e il tuo link referral si trovano nel menu dell’account in fondo alla barra laterale.

## Passaggi successivi

  - [Avvio rapido con l’API](/it/docs/quickstart/api/): Aggiungi un dominio, crea una chiave e invia la prima email.
  - [Avvio rapido con SMTP](/it/docs/quickstart/smtp/): Collega qualsiasi app o framework via SMTP.
  - [API o SMTP](/it/docs/get-started/api-or-smtp/): Confronta i due modi di inviare email transazionali.
  - [Checklist per andare in produzione](/it/docs/get-started/go-live/): Tutto ciò da fare prima di inviare a destinatari reali.

---
Fonte: https://emailit.com/it/docs/get-started/how-emailit-works/