Esempio:
- Newsletter Subscribers
- VIP Customers
- Event Attendees
- Product Updates
Le liste nella console
Le liste si trovano nella pagina Contatti, nella colonna di sinistra sotto Liste; non esiste una pagina Liste separata. Il + accanto a Liste (Nuova lista) ne crea una.
Se selezioni una lista vedi:
- Il numero di iscritti per stato: clicca su uno stato per mostrare solo quei contatti. I conteggi dei disiscritti, dei bounce e dei reclami mostrano anche la loro quota sulla lista.
- Le sue impostazioni: visibilità, double opt-in con il relativo template di conferma, e l’ID della lista. Modifica lista apre il modulo.
- I suoi membri, con lo stato di ciascuno nella lista e la data da cui vale.
Importa nella lista importa un CSV direttamente nella lista, e il menu … la elimina.
Stati dei contatti
Lo stato di un contatto in una lista decide se può ricevere email:
| Stato | Recapito delle email | Descrizione |
|---|---|---|
| Attivo | ✅ Può ricevere email | Iscritti confermati che possono ricevere i broadcast |
| In Attesa | ❌ Non può ricevere email | In attesa della conferma del double opt-in |
| Disiscritto | ❌ Non può ricevere email | Ha scelto di non ricevere più comunicazioni |
| Respinte | ❌ Non riceve mai email | L’indirizzo email non è valido o non è raggiungibile |
| Ha reclamato | ❌ Non riceve mai email | Ha segnalato delle email come spam |
Importante: i broadcast escludono i contatti disiscritti della lista, a meno che il broadcast non imposti
exclude_unsubscribedsufalse(Escludi i destinatari disiscritti disattivato nella console), per esempio per un avviso di sicurezza o legale. Le email di un broadcast di questo tipo non hanno l’headerList-Unsubscribe, quindi i client di posta non mostrano il pulsante di disiscrizione. Una richiesta API senzaexclude_unsubscribedli esclude, come fa la console. I contatti con bounce o reclamo non ricevono mai email, qualunque sia l’impostazione.
Un contatto che si disiscrive da un’email inviata per una lista di cui non faceva parte, per esempio un’email di un’automazione, viene registrato su quella lista come disiscritto. Una disiscrizione non sostituisce mai lo stato respinte o ha reclamato.
Visibilità della lista
Liste pubbliche
- Centro notifiche: ✅ compaiono nel centro notifiche
- Accesso degli iscritti: gli utenti possono vedere queste liste e iscriversi dal tuo centro notifiche
- Caso d’uso: newsletter, annunci e comunicazioni generali
Liste private
- Centro notifiche: ❌ non vengono proposte ai contatti che non ne fanno parte. Un contatto vede una lista privata su cui è attivo o in attesa, e da lì può solo lasciarla.
- Accesso degli iscritti: solo il workspace aggiunge i contatti, dalla console o dall’API autenticata (
lists.subscribe). Un contatto non può entrare in una lista privata dal centro notifiche o dall’endpoint pubblico/subscribe, né tornarci dopo averla lasciata; solo il workspace può aggiungerlo di nuovo. Un link nelle sue email gli permette soltanto di confermare un double opt-in in attesa. - Caso d’uso: comunicazioni interne, segmenti VIP, liste transazionali o broadcast una tantum
Configurazione del double opt-in
Attivare il double opt-in
Quando attivi il double opt-in per una lista:
- Contatti importati: i contatti aggiunti tramite importazione CSV o API hanno sempre lo stato “attivo” (saltano il double opt-in)
- Iscritti anonimi: gli utenti che si iscrivono tramite moduli (come l’iscrizione alla newsletter sul tuo sito) hanno lo stato “in attesa”
- Conferma obbligatoria: i contatti in attesa devono cliccare un link di conferma nell’email per passare allo stato “attivo”
- Conformità: aiuta a rispettare il GDPR e riduce le segnalazioni di spam
Esempio: un visitatore compila un modulo di iscrizione alla newsletter sul tuo sito e riceve un’email di conferma. Quando clicca il link (che apre il centro notifiche), il suo stato passa da “in attesa” ad “attivo”.
Template di benvenuto (facoltativo)
Le liste non hanno un template di benvenuto. L’unica email che una lista invia da sola è la conferma del double opt-in. Per dare il benvenuto ai nuovi iscritti, crea un’automazione che parte con list.subscribed o list.confirmed per quella lista.
Template di disiscrizione (facoltativo)
Le liste non hanno nemmeno un template di disiscrizione. Per scrivere ai contatti che lasciano una lista, usa un’automazione che parte con list.unsubscribed.
Gestione delle nuove iscrizioni
Quando un contatto prova a iscriversi a una lista di cui ha già fatto parte, Notifuse agisce in base al suo stato attuale:
| Stato attuale | Comportamento |
|---|---|
| Attivo | Nessuna operazione. Il contatto è già iscritto. Restituisce un esito positivo senza avvisi. |
| In Attesa | Nessun cambio di stato. Invia di nuovo l’email di conferma del double opt-in. |
| Disiscritto | Consentito. Lo stato diventa “in attesa” e viene inviata un’email di conferma, anche se la lista usa il single opt-in. |
| Respinte | Bloccato. Lo stato non cambia e non viene inviata alcuna email. |
| Ha reclamato | Bloccato. Lo stato non cambia e non viene inviata alcuna email. |
Perché i contatti con bounce o reclamo sono bloccati
Inviare di nuovo a indirizzi che hanno dato un hard bounce o hanno segnalato spam danneggia la reputazione del mittente e può far finire il tuo dominio in blacklist. Questi contatti sono esclusi in modo permanente, sia a livello di applicazione sia a livello di database.
Comportamento dell’importazione in blocco
Quando i contatti vengono importati tramite CSV o tramite l’API con subscribe_to_lists, le stesse protezioni valgono a livello di database: lo stato nella lista dei contatti disiscritto, respinte o ha reclamato non viene sovrascritto, così un’operazione in blocco non può riattivare per errore contatti che hanno revocato il consenso.
Privacy fin dalla progettazione
L’endpoint pubblico /subscribe restituisce HTTP 200 qualunque sia lo stato del contatto nella lista, così un malintenzionato non può interrogarlo per scoprire se un indirizzo email è iscritto. Restituisce 400 per una richiesta non valida o una lista non pubblica, 429 quando arrivano troppi tentativi dallo stesso IP e 500 per gli altri errori.
Permessi
Le liste dipendono dal permesso Liste: lettura mostra le liste, le loro impostazioni e il numero di iscritti, e scrittura le crea, le modifica, le elimina e gestisce le iscrizioni. Per elencare gli indirizzi dei membri di una lista serve anche la lettura su Contatti, e per modificare o rimuovere un’iscrizione esistente serve anche la scrittura su Contatti.
Nella console, un membro con la lettura su Liste ma senza la lettura su Contatti arriva comunque alla pagina Contatti: la colonna mostra le liste e i loro conteggi, ma nessun contatto.
Attenzione
La scrittura su Liste equivale di fatto alla scrittura su Contatti. Iscrivere un indirizzo tramite /api/lists.subscribe
crea o sovrascrive l’intero record di quel contatto, con ogni campo presente nella richiesta, senza
bisogno della scrittura su Contatti. Un membro o una API Key che ha solo la scrittura su Liste può quindi riscrivere i dati
dei tuoi contatti. Una chiamata autenticata può anche iscrivere qualcuno a una lista non pubblica. Concedi
la scrittura su Liste solo dove concederesti la scrittura su Contatti. Vedi
Amministratori e API Key.
Buone pratiche
- Controlla regolarmente gli stati dei contatti per mantenere le liste in buona salute.
- Attiva il double opt-in per la conformità e per tenere iscritti che vogliono davvero le tue email.
- Imposta un template di conferma sulle liste con double opt-in, e usa le automazioni per le email di benvenuto.
- Usa liste separate per pubblici diversi (per esempio “Newsletter”, “Product Updates”) e combinale con i filtri dei segmenti per indirizzare i broadcast.
