# Gestisci le soppressioni

> Consulta, filtra, aggiungi, importa, esporta ed elimina le soppressioni nel pannello o con l’API, configura la soppressione automatica e invia di nuovo le email soppresse.

Questa guida copre tutte le operazioni sulla lista di soppressione: trovare le voci, aggiungerle una alla volta o da un file CSV, esportarle, rimuoverle e controllare la soppressione automatica. Per sapere come funzionano le soppressioni, vedi [Soppressioni](/it/docs/suppressions/).

## Prima di iniziare

- Qualsiasi membro del workspace può gestire la lista nel pannello. Per modificare le impostazioni della soppressione automatica serve un amministratore.
- Per l’API, usa una chiave API con **Full Access**.

## Consulta e filtra la lista

**Pannello**

  Vai a **Email API → Suppressions**. La tabella elenca **Email**, **Reason** e **Created at** di ogni soppressione, a partire dalla più recente.

  - **Search** cerca nell’indirizzo email e nel motivo.
  - **Filters** aggiunge regole su **Email**, **Reason**, **Type** o **Created at**, come *Type equals complaint*. Premi Invio o seleziona **Apply**.
  - **Display options > Edit columns** mostra la colonna **Type**.
  - Seleziona l’intestazione di una colonna per ordinare in base a quella colonna.

**API**

  Chiama [Elenca le soppressioni](/it/docs/api-reference/suppressions/list/). Puoi filtrare su `email`, `reason`, `type`, `created_at` e `keep_until`:

```bash
curl -G https://api.emailit.com/v2/suppressions \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type.exact=complaint" \
  --data-urlencode "limit=100"
```

  Per cercare un singolo indirizzo, chiama [Recupera una soppressione](/it/docs/api-reference/suppressions/get/) con il suo ID `sup_` o con l’indirizzo email. Vedi [Filtri e ordinamento](/it/docs/api-reference/filtering/) per tutti gli operatori.

## Aggiungi una soppressione

**Pannello**

  1. **Apri la lista.** Vai a **Email API → Suppressions** e seleziona **Add suppression**.

  2. **Inserisci i dati.** Compila il campo **Email** e, se vuoi, un **Reason** che riconoscerai in seguito.

  3. **Seleziona Create.** L’indirizzo viene aggiunto con il tipo `recipient`, che blocca tutte le email verso di esso.

  Per aggiungere un altro tipo, o una soppressione che scade, usa l’API o un’importazione CSV.

**API**

  Chiama [Crea una soppressione](/it/docs/api-reference/suppressions/create/):

```bash
curl https://api.emailit.com/v2/suppressions \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "type": "unsubscribe",
    "reason": "Opted out by phone",
    "keep_until": "2027-01-01T00:00:00Z"
  }'
```

  | Campo | Obbligatorio | Descrizione |
  | --- | --- | --- |
  | `email` | Sì | L’indirizzo da sopprimere. |
  | `type` | No | `recipient` (predefinito), `bounce`, `complaint` o `unsubscribe`. |
  | `reason` | No | Testo libero. |
  | `keep_until` | No | Quando scade la soppressione: ISO 8601, un timestamp Unix o un’espressione in inglese come `in 30 days`. Omettilo per una soppressione permanente. |

  Lo stesso indirizzo con lo stesso tipo può essere aggiunto una sola volta. Un duplicato restituisce `409 Suppression already exists for this email and type`.

## Importa un file CSV

Usa un’importazione per trasferire una lista di soppressione da un altro provider o per aggiungere molti indirizzi in una volta.

1. **Prepara il file.** Usa un file `.csv` con le colonne `email`, `type` e `reason`:

```csv title="suppressions.csv"
email,type,reason
ada@example.com,bounce,Hard bounce at previous provider
grace@example.com,unsubscribe,Unsubscribed in 2025
alan@example.com,,Requested removal
```

   - `email` è obbligatorio. `type` e `reason` sono facoltativi.
   - Un `type` vuoto o sconosciuto diventa `recipient`.
   - La riga di intestazione è facoltativa. Senza intestazione, Emailit legge le colonne nell’ordine `email`, `type`, `reason`.
   - Il file deve pesare meno di 8 MB e avere al massimo 10.000 righe.

2. **Caricalo.** In **Email API → Suppressions**, seleziona **Import**, poi scegli il file o trascinalo su **Select a file or drag it here**.

3. **Controlla il risultato.** Emailit aggiunge le nuove voci e salta gli indirizzi che hanno già una soppressione dello stesso tipo. Le righe con indirizzi email non validi vengono saltate.

Per più di 10.000 indirizzi, dividi il file. Per importare da codice, chiama [Crea una soppressione](/it/docs/api-reference/suppressions/create/) per ogni indirizzo.

## Esporta la lista

1. **Restringi la selezione.** Se vuoi, cerca o filtra la lista in **Email API → Suppressions**. L’esportazione include solo ciò che è visualizzato.

2. **Esporta.** Seleziona **Export**, poi **Export** nel popover. Emailit scarica `suppressions.csv`.

Il file ha le colonne `email`, `type`, `reason` e `created_at` e contiene fino a 10.000 righe.

## Elimina le soppressioni

Eliminare una soppressione permette a Emailit di inviare di nuovo all’indirizzo. Assicurati che l’indirizzo sia valido e che la persona voglia ricevere le tue email, altrimenti il prossimo invio potrebbe generare un bounce o una segnalazione.

**Pannello**

  - **Una:** seleziona l’icona del cestino nella sua riga e conferma.
  - **Più di una:** seleziona le righe con le caselle di spunta, seleziona **Delete suppressions** e conferma.

**API**

  Chiama [Elimina una soppressione](/it/docs/api-reference/suppressions/delete/) con l’ID `sup_` o con l’indirizzo email:

```bash
curl https://api.emailit.com/v2/suppressions/sup_4Lm8Qr2Tz6Wk \
  -X DELETE \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  Se un indirizzo ha soppressioni di più tipi, usa l’ID `sup_` per eliminare quella giusta.

  Per modificare invece una soppressione, ad esempio per aggiungere una data di scadenza, chiama [Aggiorna una soppressione](/it/docs/api-reference/suppressions/update/) con `type`, `reason` o `keep_until`. Imposta `keep_until` su `null` per rimuovere la scadenza.

## Configura la soppressione automatica

Emailit aggiunge automaticamente alla lista gli indirizzi che generano bounce o segnalazioni. Con Pro e Business, gli amministratori possono modificare questo comportamento.

1. **Apri le impostazioni.** Vai a **Workspace → Settings** e seleziona la scheda **Suppressions**.

2. **Attivala o disattivala.** Usa **Enable automatic suppression**.

3. **Scegli cosa sopprimere.** In **Suppress on**, scegli **Bounces and Complaints** (predefinito), **Bounces only** o **Complaints only**.

Con Pay as you go e con i piani Custom, la soppressione automatica è sempre attiva per bounce e segnalazioni. I controlli mostrano un badge **Pro** e non si possono modificare. I membri che non sono amministratori possono vedere le impostazioni ma non modificarle. Vedi [Bounce e segnalazioni di spam](/it/docs/deliverability/bounces-and-complaints/#automatic-suppression) per sapere esattamente quando Emailit sopprime un indirizzo.

## Ritenta le email soppresse

Un messaggio bloccato da una soppressione resta `suppressed` anche dopo che hai eliminato la soppressione. Per inviarlo:

1. **Elimina la soppressione** dell’indirizzo, come descritto sopra. Altrimenti anche il nuovo tentativo viene soppresso.

2. **Ritenta l’email.** Aprila in **Email API → Emails** e seleziona **Retry**, oppure chiama [Ritenta un’email](/it/docs/api-reference/emails/retry/).

Un nuovo tentativo crea una nuova email con lo stesso contenuto e un nuovo ID, e costa crediti come qualsiasi altro invio. Puoi ritentare le email fino a 30 giorni dopo l’invio, purché il loro contenuto rientri ancora nel periodo di [conservazione dei dati](/it/docs/data-retention/).

## Vedi anche

  - [Soppressioni](/it/docs/suppressions/): Tipi, soppressione automatica e scadenza.
  - [Bounce e segnalazioni di spam](/it/docs/deliverability/bounces-and-complaints/): Quando Emailit sopprime un indirizzo.
  - [API delle soppressioni](/it/docs/api-reference/suppressions/): Tutti gli endpoint delle soppressioni.
  - [Verifica email](/it/docs/email-verification/): Rimuovi gli indirizzi errati prima di inviare.

---
Fonte: https://emailit.com/it/docs/suppressions/manage/