Gestisci le soppressioni

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.

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

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

Aggiungi una soppressione

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"
  }'

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:

   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 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.

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

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 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.

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.

Vedi anche