Supresiones

Deja de enviar a las direcciones que te perjudican.

Configúralo en:

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: