# Liste

> Le liste sono i destinatari delle tue campagne. Crea liste, gestisci gli iscritti, controlla il limite di iscritti del piano e usa le liste con l’API.

Una lista è un elenco di contatti con un nome, ad esempio «Newsletter» o «Novità di prodotto». Scegli una o più liste come destinatari di una [campagna](/it/docs/campaigns/), e puoi aggiungere persone a una lista a mano, con un’importazione, con l’API o con un URL di iscrizione ospitato.

## Come funzionano le liste

Ogni persona in una lista è un **iscritto**: un collegamento tra un [contatto](/it/docs/contacts/) e la lista, con un proprio indicatore **Subscribed**. Lo stesso contatto può essere in più liste, iscritto ad alcune e disiscritto da altre.

- Le **campagne** vengono inviate agli iscritti con l’indicatore **Subscribed** attivo, il cui contatto non è disiscritto a livello globale e il cui indirizzo non è soppresso. Un contatto presente in più liste selezionate riceve una sola copia.
- La **disiscrizione** disattiva l’indicatore ma lascia l’iscritto nella lista, così ne conservi la cronologia. Vedi [Disiscrizioni](/it/docs/audiences/unsubscribes/).
- **Eliminare un iscritto** rimuove la persona dalla lista. Il contatto resta nel workspace.

## L’elenco Audiences

Vai a **Email Marketing → Audiences** per vedere le liste con le colonne **Name**, **Subscribers** e la data **Created**. La colonna **Subscribers** mostra quanti iscritti ha ogni lista rispetto al limite del piano, ad esempio `1.2k/10k`. Il menu della riga di ogni lista offre **Manage subscribers**, **Rename** e **Delete**.

Per crearne una, seleziona **Create audience**, compila il campo **Name** e seleziona **Create**. I nomi devono essere unici nel workspace.

## La pagina della lista

Apri una lista per gestirne gli iscritti. L’intestazione mostra il numero di iscritti e il badge del limite, con queste azioni:

| Azione | Cosa fa |
| --- | --- |
| **Rename** | Cambia il nome della lista. |
| **Subscribe URL** | Mostra l’URL di iscrizione ospitato di questa lista e ti permette di reimpostarlo. Vedi [URL di iscrizione](/it/docs/audiences/subscribe-url/). |
| **Add subscriber** | Aggiunge una persona tramite indirizzo email. Viene sostituito da **Upgrade** quando una lista con Pay as you go è piena. |
| **Delete** (nel menu) | Elimina la lista e tutti i suoi iscritti. I contatti restano nel workspace. Questa operazione non si può annullare. |

Più in basso, la tabella degli iscritti elenca **Email**, **First name**, **Last name**, **Subscribed** e **Created**, con ricerca, filtri e, per ogni iscritto, un menu della riga con **Edit** e **Delete**. Vedi [Gestisci gli iscritti](/it/docs/audiences/subscribers/).

## Limiti

Ogni piano limita il numero di iscritti che una lista può contenere. Il numero di liste non è limitato.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Iscritti per lista | 10.000 | 50.000 | 250.000 | Illimitati |

Il limite conta tutti gli iscritti della lista, comprese le persone che si sono disiscritte. Per fare spazio, elimina gli iscritti che non ti servono più, [passa a un piano superiore](/it/docs/billing/plans/) oppure chiedi un limite più alto con **Request Increase** nel riquadro **Sending Limits** della home page del pannello.

Quando una lista è piena, **Add subscriber** è disattivato e ogni modo di aggiungere persone, compresi l’API, le importazioni e l’URL di iscrizione, viene rifiutato con `422` e un messaggio come «Pro includes 50,000 subscribers per audience.». L’errore dell’API include l’`usage` attuale:

```json
{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}
```

## Usa l’API

L’[API delle liste](/it/docs/api-reference/audiences/) ti permette di [creare](/it/docs/api-reference/audiences/create/), [recuperare](/it/docs/api-reference/audiences/get/), [rinominare](/it/docs/api-reference/audiences/update/), [elencare](/it/docs/api-reference/audiences/list/) ed [eliminare](/it/docs/api-reference/audiences/delete/) le liste, e l’[API degli iscritti](/it/docs/api-reference/audiences/subscribers/) gestisce le persone che contengono. Nell’URL puoi usare il nome di una lista al posto del suo ID `aud_`. L’API richiede una chiave API con **Full Access**.

```bash
curl https://api.emailit.com/v2/audiences \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Newsletter" }'
```

Le risposte sulle liste includono `subscribers_count` e un oggetto `usage` con `used`, `limit` e `plan`. Creazione, recupero e aggiornamento di una lista restituiscono anche il suo `token`, la parte segreta del suo [URL di iscrizione](/it/docs/audiences/subscribe-url/). Un nome duplicato restituisce `409`.

## Eventi

Le modifiche a liste e iscritti generano eventi che puoi ricevere con i [webhook](/it/docs/webhooks/) e che avviano le [automazioni](/it/docs/automations/):

| Evento | Quando |
| --- | --- |
| [`audience.created`, `audience.updated`, `audience.deleted`](/it/docs/webhooks/events/audience/) | Una lista viene creata, rinominata o eliminata. L’eliminazione di una lista non invia un evento per ciascuno dei suoi iscritti. |
| [`subscriber.created`](/it/docs/webhooks/events/subscriber/) | Qualcuno viene aggiunto a una lista dal pannello o con l’API. Avvia le automazioni **Added to audience**. |
| [`subscriber.updated`](/it/docs/webhooks/events/subscriber/) | Cambiano i dati di un iscritto o il suo indicatore **Subscribed**. |
| [`subscriber.deleted`](/it/docs/webhooks/events/subscriber/) | Un iscritto viene rimosso. Avvia le automazioni **Removed from audience**. |

Le importazioni e l’URL di iscrizione non inviano eventi sugli iscritti.

## Passaggi successivi

  - [Gestisci gli iscritti](/it/docs/audiences/subscribers/): Aggiungi, modifica, disiscrivi e rimuovi persone.
  - [URL di iscrizione](/it/docs/audiences/subscribe-url/): Raccogli iscrizioni dal tuo sito.
  - [Disiscrizioni](/it/docs/audiences/unsubscribes/): Come funzionano gli opt-out tra le liste.
  - [Invia una campagna](/it/docs/campaigns/create/): Scrivi agli iscritti delle tue liste.

---
Fonte: https://emailit.com/it/docs/audiences/