Vai al contenuto

Per iniziare

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.

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.

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:

StatoSignificato
AttivoIscritto. I broadcast alla lista raggiungono questo contatto.
In attesaIn attesa della conferma del double opt-in. Non riceve email finché non conferma.
DisiscrittoHa revocato l’iscrizione. È escluso dai broadcast, a meno che un broadcast sia impostato per includerlo.
RespintoL’indirizzo ha generato un bounce. Non riceve mai email.
Ha reclamatoIl 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.

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.

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.

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.

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.

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.

Quale usare?

VuoiUsa
Inviare una newsletter o un annuncio a una listaBroadcast
Scrivere a una persona per qualcosa che ha fatto nella tua app, come reimpostare la passwordNotifica transazionale
Inviare una sequenza che parte da sola, come una serie di benvenuto o un’email per riconquistare i clientiAutomazione

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.

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 e l’avvio rapido self-hosted spiegano come fare, e ogni provider ha una propria pagina, come SMTP e Amazon SES.