Vai al contenuto
Docs

Guida pratica

Aggiungi e importa persone in una lista, modificale, attiva o disattiva il loro indicatore Subscribed, rimuovile e fallo anche in blocco, dal pannello o con l’API degli iscritti.

Aggiornato il 9 ott 2026

Un iscritto è l’appartenenza di un contatto a una lista. Questa pagina mostra come aggiungere iscritti, modificarli, disiscriverli o reiscriverli e rimuoverli, e cosa comporta ogni modifica per il contatto collegato.

Prima di iniziare

  • Crea prima la lista. Vedi Liste.
  • Controlla quanto spazio ha la lista. Il limite conta tutti gli iscritti, compresi quelli disiscritti. Vedi Limiti.
  • Per l’API, usa una chiave API con Full Access.

Aggiungi un iscritto

  1. Apri la lista. Vai a Email MarketingAudiences e seleziona la lista.

  2. Aggiungi la persona. Seleziona Add subscriber, compila il campo Email e, se vuoi, First name e Last name.

  3. Salva. Seleziona Add. Se per l’indirizzo non esiste un contatto, Emailit lo crea.

Quando la lista ha il double opt-in attivo, la casella Ask them to confirm by email first (double opt-in) è spuntata: la persona riceve l’email di double opt-in ed entra nella lista quando fa clic sul suo link. Togli la spunta per aggiungerla subito. Quando la lista ha un’email di conferma, Send the confirmation email la invia alla persona che aggiungi.

Puoi anche aggiungere contatti esistenti da Email MarketingContacts: apri un contatto e seleziona Add to audience, oppure seleziona più contatti e usa Actions > Add to audience. Per aggiungere molte persone in una volta, importa un file.

Quando la persona è già nella lista

Aggiungere un indirizzo già presente nella lista ha un esito diverso a seconda del suo stato attuale:

Stato attuale Risultato Risposta API
Non è nella lista Viene creato un nuovo iscritto con Subscribed attivo. 201
Nella lista, Subscribed attivo Non cambia nulla. Il pannello mostra «Contact is already subscribed to this audience». 409 con l’iscritto in existing
Nella lista, disiscritto L’iscritto viene reiscritto: Subscribed si attiva, subscribed_at viene impostato sull’ora attuale e unsubscribed_at viene svuotato. 200
La lista è piena Non viene aggiunto nulla. 422 con usage

Una reiscrizione tramite questo endpoint invia gli eventi subscriber.updated e subscriber.resubscribed e avvia le automazioni Added to audience, come per un nuovo iscritto.

Importa iscritti

Per aggiungere molte persone in una volta, apri la lista e seleziona Import. Carica un file CSV o Excel con un massimo di 2500 righe, associa le sue colonne ai campi del contatto, controlla l’anteprima e seleziona Import. Tutte le persone del file vengono aggiunte a questa lista; i contatti che non esistono ancora vengono creati.

Le importazioni vengono eseguite in background, quindi i nuovi iscritti compaiono dopo qualche istante. Non chiedono il double opt-in, non inviano l’email di conferma e non inviano eventi sugli iscritti. Per importare in più liste in una volta, usa l’importazione dall’elenco dei contatti. Vedi Importa ed esporta i contatti.

Modifica un iscritto

Nella tabella degli iscritti della lista, apri il menu della riga e seleziona Edit. Puoi cambiare First name, Last name e l’interruttore Subscribed. Qui l’indirizzo email è in sola lettura.

Con l’API, chiama Aggiorna un iscritto. Identifica l’iscritto con il suo ID sub_ o con l’indirizzo email e invia uno o più tra email, first_name, last_name, custom_fields e subscribed:

Terminal
curl https://api.emailit.com/v2/audiences/Newsletter/subscribers/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "Augusta", "subscribed": false }'

Nome, cognome, email e campi personalizzati appartengono al contatto, non all’iscritto. Modificarli qui aggiorna il contatto ovunque, anche nelle altre liste in cui si trova. Solo subscribed è specifico di questa lista.

Attiva o disattiva Subscribed

L’indicatore Subscribed decide se le campagne inviate a questa lista raggiungono la persona. Disattivarlo lascia l’iscritto nella lista, registra unsubscribed_at e non tocca le altre liste del contatto. Riattivarlo imposta un nuovo subscribed_at e svuota unsubscribed_at.

Dove Disiscrivere Reiscrivere
Pagina della lista Edit, poi disattiva Subscribed Edit, poi attiva Subscribed
Pagina del contatto Unsubscribe nel menu della riga della lista Resubscribe nel menu della riga
API Aggiorna un iscritto con "subscribed": false Aggiorna con "subscribed": true, oppure aggiungi di nuovo l’indirizzo

Queste modifiche inviano un evento subscriber.updated. Non registrano una disiscrizione su nessuna campagna, quindi non compaiono nella scheda Unsubscribes di una campagna. Quando i destinatari si disiscrivono da soli con il link di una campagna, lasciano tutte le liste in una volta. Vedi Disiscrizioni.

Rimuovi un iscritto

Rimuovere un iscritto elimina l’appartenenza alla lista. Seleziona Delete nel menu della riga nella pagina della lista, Remove from audience nella pagina del contatto, oppure chiama Elimina un iscritto.

Disiscrivere Rimuovere
La persona resta nella lista Sì, con Subscribed disattivato No
Conta per il limite della lista Sì No
Il contatto viene mantenuto Sì Sì
Evento subscriber.updated subscriber.deleted, che avvia le automazioni Removed from audience
Aggiungere di nuovo l’indirizzo Reiscrive l’iscritto esistente Crea un nuovo iscritto

Quando qualcuno fa opt-out, preferisci la disiscrizione, così ne conservi traccia. Rimuovi gli iscritti aggiunti per errore o che non vuoi più tenere. Per eliminare del tutto la persona, elimina il contatto, che viene rimosso da tutte le liste.

Azioni di massa

Seleziona gli iscritti con le caselle di spunta, poi usa Actions:

  • Subscribe attiva Subscribed.
  • Unsubscribe disattiva Subscribed e li lascia nella lista.
  • Remove from audience elimina la loro appartenenza alla lista. I contatti restano.

Per agire su più di una pagina, seleziona l’intera pagina con la casella di spunta dell’intestazione e poi Select all matching subscribers. Così selezioni tutte le persone che corrispondono alla vista attuale (All, Engaged o Unengaged) e alla ricerca, fino a 10.000 persone. Ogni modifica invia gli stessi eventi di una modifica fatta a mano sull’iscritto.

Con l’API, chiama Aggiorna gli iscritti in blocco con un massimo di 1000 ID di iscritti, oppure con "all_matching": true e un filtro engagement o subscribed facoltativo.

Elenca e trova gli iscritti

Nella pagina della lista, cerca per email o nome e filtra per Email, First name, Last name, Subscribed, Subscribed at, Last opened or clicked o Added. Seleziona l’intestazione di una colonna per ordinare in base a quella colonna. Last opened or clicked mostra l’ultima apertura o l’ultimo clic del contatto su una qualsiasi email del workspace, e le viste Engaged e Unengaged dividono le persone iscritte secondo la regola sui contatti inattivi della lista.

Con l’API, Elenca gli iscritti restituisce tutti gli iscritti, compresi quelli disiscritti. Aggiungi subscribed=true o subscribed=false per restringere l’elenco, engagement=engaged o engagement=unengaged per dividerlo in base all’engagement, search per cercare per email o nome, order e direction per ordinarlo, e page e limit (fino a 100) per scorrere le pagine:

Terminal
curl "https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers?subscribed=true&limit=100&page=1" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Per cercare una persona, usa Recupera un iscritto con l’ID sub_ o l’indirizzo email.

Permetti alle persone di iscriversi dal tuo sito.
La persona dietro ogni iscritto.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.