Soppressioni

Smetti di scrivere agli indirizzi che ti danneggiano.

Configurazione in:
Cursor

Ogni bounce, reclamo e disiscrizione aggiunge automaticamente il destinatario alla tua lista di soppressione, così non gli scrivi più. La soppressione è reversibile, interrogabile tramite l'API e vale sia per gli invii transazionali che marketing.

welcome.tsx
200 · 1.2s
import { BirdClient } from "@messagebird/sdk";
import { render } from "@react-email/render";
import { WelcomeEmail } from "./emails/welcome";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

const { data, error } = await bird.email.send({
  from:    "Bird <hello@bird.com>",
  to:      ["ada@example.com"],
  subject: "Your invite is ready",
  html:    await render(<WelcomeEmail name="Ada" />),
}).safe();

if (error) throw error;
console.log(data.id);
// → "em_2bX91Yk8h..."

La singola leva più potente sulla tua reputazione.

La soppressione è integrata nella Bird Email API, non è una lista da gestire manualmente. I provider di posta penalizzano i mittenti che continuano a inviare a indirizzi inesistenti e a generare segnalazioni di spam; quegli invii vengono bloccati automaticamente per te, nel momento stesso in cui un destinatario diventa non valido.

Cinque modi in cui la soppressione ti protegge.

Automatica, reversibile e interrogabile.

  1. 01

    Automatica su bounce e reclamo.

    Hard bounce, reclami spam e disiscrizioni sopprimono il destinatario automaticamente. Senza scrivere codice.

  2. 02

    Reversibile.

    Nulla è permanente. Rimuovi un indirizzo se torna valido e riprendi a inviargli email.

  3. 03

    Voci manuali.

    Aggiungi indirizzi tu stesso: ad esempio un elenco di indirizzi già noti come non validi che stai importando da un altro provider.

  4. 04

    Interrogabile tramite API.

    Visualizza l'intera lista, filtra per indirizzo o motivo, aggiungi una voce o eliminane una tramite il suo record id, così i tuoi sistemi restano sempre sincronizzati.

  5. 05

    Una lista, ogni invio.

    La soppressione vale sia per la posta transazionale che marketing, così una campagna non può riscrivere a un indirizzo su cui una ricevuta ha appena fatto bounce.

Automatica di default, sotto il tuo controllo.

Non devi mai toccare la lista perché funzioni: bounce e reclami vengono soppressi automaticamente. Quando ne hai bisogno, l'intera lista è un'API: aggiungi un indirizzo che sai già essere non valido, filtra per indirizzo o motivo, oppure elimina un record per riabilitare un destinatario recuperato. La CLI di Bird gestisce le letture e le rimozioni, e un agente accede alle stesse due operazioni tramite MCP.

suppressions.sh
bird CLI
# Look up why an address is on the list.
$ bird email suppressions list --email ada@example.com \
    | jq -c '.data[] | {id, reason, applies_to}'

{"id":"sup_01krdgeqcxet5s7t44vh8rt9mg","reason":"hard_bounce",
 "applies_to":"all"}

# Reinstate one that recovered, by record id.
$ bird email suppressions remove sup_01krdgeqcxet5s7t44vh8rt9mg --yes

Quattro motivi, due ambiti.

Non tutte le soppressioni bloccano ogni invio. Un destinatario che si è disiscritto dal marketing riceve comunque il reset della password: reclami e disiscrizioni hanno ambito marketing, mentre gli hard bounce e gli inserimenti manuali bloccano tutto.

MotivoAttivato daBlocca
hard_bounceun bounce permanentetutte le email (transazionali + marketing)
complaintun reclamo per spamsolo marketing
unsubscribeuna disiscrizione da elenco o con un clicsolo marketing
manualtu, via API o dashboardtutte le email (transazionali + marketing)

Approfondisci nella documentazione.

Scopri come funzionano la soppressione automatica e manuale nella guida alle soppressioni, e come si inserisce nel quadro più ampio nella guida alla deliverability.

Circa il 40% delle email commerciali nel mondo gira già su Bird.

Email transazionali e marketing su un'infrastruttura che gestiamo da un decennio. La soppressione è una delle funzionalità dell'Email API di Bird: invio, deliverability, IP dedicati e analytics sono inclusi.

Inizia con un canale.
Aggiungi gli altri quando sei pronto.

Una chiave API di test è subito tua. La produzione si sblocca quando aggiungi un metodo di pagamento e verifichi un mittente.

Usi Claude Code, Cursor o Codex? Copia un prompt di configurazione e il tuo agente installerà la CLI e le skill di Bird per te. Scegli il tuo:

Cursor