Concetto
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 workspaceWorkspaceUn contenitore per tutto ciò che invii: domini, chiavi API, email, contatti, template, membri e fatturazione. Un account può appartenere a più 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 invioDominio di invioUn dominio di tua proprietà che verifichi con record DNS perché Emailit possa inviare da esso con SPF, DKIM e un return path personalizzato. 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 creditiCreditoL’unità con cui Emailit fattura. Ogni azione costa un numero fisso di crediti, ad esempio 1 per un’email via API o SMTP e 2 per un’email di una campagna., 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 |
| 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.
Il ciclo di vita di un’email
Ogni email segue lo stesso percorso, in qualunque modo la invii:
- 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 statoaccepted, oppurescheduledse hai impostato un orario di invio. L’API generaemail.acceptedoemail.scheduled. - In coda e controllata. Un worker di consegna prende l’email e la controlla di nuovo. Un destinatario nella lista di soppressione rende l’email
suppressed. Un dominio in pausa, un workspace sospeso o un saldo di crediti esaurito la rendonoheld. - 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 diventaheld, e le regole corrispondenti compaiono in Spam Checks nella pagina dell’email. - 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 rendeattempted, ed Emailit ritenta fino a 7 volte nell’arco di circa 21 ore prima di rinunciare e segnarla comebounced. - Consegnata. Il server ricevente ha accettato il messaggio, quindi l’email è
delivered. Un report di bounce che arriva in seguito può comunque trasformarla inbounced, e una segnalazione di spam dal provider di posta la rendecomplained. Gli indirizzi con bounce o segnalazioni possono essere aggiunti automaticamente alla lista di soppressione. - Aperta e cliccata. Se il dominio ha un sottodominio di tracciamento verificato, le aperture rendono l’email
loadede i clic la rendonoclicked.
Ogni cambio di stato viene registrato come evento. Gli eventi compaiono nella pagina dell’email e in Email APIEvents. Vengono anche inviati ai tuoi webhook 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.
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 perché la posta di produzione non si fermi mai. Per piani e prezzi, vedi Crediti e la pagina dei prezzi.
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 WorkspaceSettingsRequests. 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.
Ogni workspace ha anche dei limiti di invio, 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 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.