Supresiones

Deja de enviar a las direcciones que te perjudican.

Configúralo en:
Cursor

Cada rebote, queja y baja de suscripción añade automáticamente al destinatario a tu lista de supresión, para que no le vuelvas a enviar. La supresión es reversible, consultable a través de la API y se aplica en los envíos transaccionales y de 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 mayor palanca individual sobre tu reputación.

La supresión está integrada en la Email API de Bird, no es una lista que mantienes a mano. Los proveedores de buzón castigan a los remitentes que siguen alcanzando direcciones muertas y quejas de spam-trap; Bird detiene esos envíos por ti, automáticamente, en el momento en que un destinatario se vuelve problemático.

Cinco formas en que la supresión te protege.

Automática, reversible y consultable.

  1. 01

    Automática ante rebote y queja.

    Los rebotes duros, las quejas de spam y las bajas suprimen al destinatario automáticamente. Sin necesidad de código.

  2. 02

    Reversible.

    Nada es permanente. Elimina una dirección si se recupera y vuelve a enviarle correo.

  3. 03

    Entradas manuales.

    Añade direcciones tú mismo: por ejemplo, una lista de direcciones incorrectas conocidas que estás importando desde otro proveedor.

  4. 04

    Consultable vía API.

    Lista, comprueba, añade y elimina supresiones de forma programática, para que tus propios sistemas se mantengan sincronizados.

  5. 05

    Una lista, cada envío.

    La supresión se aplica en el correo transaccional y de marketing, de modo que una campaña no pueda reenviar a una dirección que acaba de rebotar un recibo.

Automática por defecto, bajo tu control.

Nunca tienes que tocar la lista para que funcione; los rebotes y las quejas se suprimen por sí solos. Pero cuando lo necesites, toda la lista es una API: añade una dirección que ya sabes que es incorrecta, consulta una o reactiva un destinatario que se haya recuperado.

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");

Cuatro motivos, dos ámbitos.

No toda supresión bloquea todos los envíos. Un destinatario que se dio de baja del marketing sigue recibiendo el restablecimiento de su contraseña: las quejas y las bajas se limitan al marketing, mientras que los rebotes duros y las adiciones manuales lo bloquean todo.

MotivoActivado porBloquea
hard_bounceun rebote permanentetodo el correo (transaccional + marketing)
complaintuna queja por spamsolo marketing
unsubscribeuna baja de lista o con un solo clicsolo marketing
manualtú, a través de la API o del paneltodo el correo (transaccional + marketing)

Profundiza en la documentación.

Lee cómo funcionan la supresión automática y manual en la guía de supresiones, y cómo encaja en el panorama general en la guía de entregabilidad.

Preguntas frecuentes sobre supresiones

¿Qué se suprime automáticamente?
Los rebotes definitivos, las quejas de spam y las bajas de suscripción. Una vez que un destinatario provoca uno de estos, Bird lo añade a tu lista de supresión y lo omite en los envíos futuros.
¿Puedo eliminar una dirección de la lista de supresión?
Sí, la supresión es reversible. Si una dirección se recupera, elimínala de la lista desde el panel o la API y vuelve a enviarle correo.
¿Puedo añadir mis propias supresiones?
Sí. Añade direcciones manualmente, por ejemplo una lista de direcciones incorrectas conocidas que estás importando, y se omitirán igual que las entradas automáticas.
¿La supresión se aplica al email transaccional y al de marketing?
Los rebotes duros y las entradas manuales bloquean todos los envíos. Las quejas y las bajas se limitan únicamente al marketing, así que un mensaje transaccional como el restablecimiento de una contraseña sigue llegando a alguien que se dio de baja de tus campañas.
¿Cómo pruebo la supresión sin quemar una dirección real?
Envía a la dirección de sandbox suppressed@messagebird.dev. Funciona exactamente como si el destinatario estuviera en tu lista (rechazado con recipient_suppressed), sin escribir nada en la lista, así que es reutilizable.

Cerca del 40% del correo comercial del mundo ya funciona con Bird.

Correo transaccional y de marketing sobre una infraestructura que operamos desde hace una década. La supresión es una de las capacidades de la Email API de Bird: el envío, la entregabilidad, las IPs dedicadas y las analíticas vienen incluidas.

Empieza con un canal.
Añade los demás cuando estés listo.

Una clave API de prueba es tuya de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.

¿Usas Claude Code, Cursor o Codex? Copia un prompt de configuración y tu agente instalará el Bird CLI y las habilidades por ti. Elige el tuyo:

Cursor