Soppressioni

Smetti di scrivere agli indirizzi che ti danneggiano.

Configurazione in:

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 nell<hub>Email API di Bird</hub>, non è una lista che mantieni a mano. I provider di posta puniscono i mittenti che continuano a colpire indirizzi morti e reclami da spam-trap; Bird ferma quegli invii per te, automaticamente, nel momento 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.

    Elenca, verifica, aggiungi e rimuovi le soppressioni in modo programmatico, così i tuoi sistemi restano 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 intervenire sull'elenco perché funzioni; bounce e reclami sopprimono da soli. Ma quando serve, l'intero elenco è un'API: aggiungi un indirizzo che sai già non essere valido, cercalo o reintegra un destinatario tornato valido.

suppressions.ts
200
// Suppress an address you already know is bad.
await bird.email.suppressions.create({ email: "ada@example.com" });

// Look up why an address is on the list.
const { data } = await bird.email.suppressions.list({
  email: "ada@example.com",
});
// → [{ reason: "hard_bounce", applies_to: "all", created_at }]

// Reinstate one that recovered.
await bird.email.suppressions.remove("ada@example.com");

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.

FAQ sulle soppressioni

Cosa viene soppresso automaticamente?+
Hard bounce, reclami spam e disiscrizioni. Quando un destinatario ne attiva uno, Bird lo aggiunge alla tua lista di soppressione e lo salta negli invii futuri.
Posso rimuovere un indirizzo dalla lista di soppressione?+
Sì, la soppressione è reversibile. Se un indirizzo torna valido, rimuovilo dall'elenco dalla dashboard o via API e riprendi a inviargli email.
Posso aggiungere le mie soppressioni?+
Sì. Aggiungi indirizzi manualmente, ad esempio un elenco di indirizzi già noti come non validi che stai importando, e verranno saltati esattamente come le voci automatiche.
La soppressione vale sia per le email transazionali che marketing?+
Gli hard bounce e gli inserimenti manuali bloccano ogni invio. I reclami e le disiscrizioni hanno ambito solo marketing, quindi un messaggio transazionale come il reset della password raggiunge comunque chi ha rinunciato alle tue campagne.
Come faccio a testare la soppressione senza bruciare un indirizzo reale?+
Invia all'indirizzo sandbox suppressed@messagebird.dev. Interrompe l'invio esattamente come se il destinatario fosse nel tuo elenco (rifiutato con recipient_suppressed), senza scrivere nulla nell'elenco, quindi è riutilizzabile.

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: