Rebotes

Cuando un correo electrónico no puede entregarse, el servidor receptor envía un rebote. MailLand clasifica los rebotes, suprime automáticamente las direcciones que nunca aceptarán correo y reintenta los fallos transitorios.

Tipos de rebotesCopiar enlace de la sección

Categorías de rebotesCopiar enlace de la sección

La API de desglose de rebotes (GET /v1/deliverability/bounce-breakdown) agrupa cada rebote según la clasificación que el propio servidor de transferencia de correo (MTA) asigna al rechazo SMTP, y luego la asigna a permanente, temporal o bloqueado. La siguiente tabla es el vocabulario completo y fijo de producción: cualquier cosa que emita el servidor y no esté en esta tabla se cuenta como desconocida en lugar de adivinarse:

Dos endpoints tratados más abajo en esta página informan los rebotes con un vocabulario propio. /v1/transactional/bounces/statistics cuenta hardBounces y softBounces a partir de la misma decisión que suprime (o no) la dirección, así que un rebote bloqueado nunca cuenta como permanente ni temporal; su byCategory agrupa la clasificación del servidor anterior en un conjunto más grueso (invalid_recipient, bad_mailbox, bad_domain, mailbox_full, content_rejected, policy_reason, general_bounce). /v1/transactional/bounces/recent devuelve como bounceCategory la propia clasificación del servidor.

Manejo automáticoCopiar enlace de la sección

Rebotes permanentesCopiar enlace de la sección

1. La dirección de correo del destinatario se añade inmediatamente a la lista de supresión global
2. Todos los correos futuros (transaccionales y de marketing) a esta dirección son bloqueados
3. Se dispara un evento webhook message.bounced con bounce_type: "hard" (no se dispara ningún evento suppression.added separado)

Rebotes temporalesCopiar enlace de la sección

1. El estado del mensaje pasa a Bounced
2. La dirección se suprime para correo de marketing durante 30 días (el correo transaccional se sigue entregando): en el primer rebote temporal, no tras varios reintentos. Excepción: el primer rebote MessageExpired de una dirección, o su primer rebote por mensaje demasiado grande (QuotaIssues con el código extendido 5.3.4 o 5.2.3), no suprime nada; otro en los 30 días siguientes suprime como siempre.
3. Se dispara un evento webhook message.bounced con bounce_type: "soft". (El propio MTA reintenta los fallos transitorios antes de informar de un rebote a MailLand.)
4. Tras 30 días, la supresión caduca automáticamente

Rebotes bloqueadosCopiar enlace de la sección

1. El estado del mensaje cambia a Bounced (Failed en un AdminBounce), pero la dirección del destinatario no se añade a ninguna lista de supresión: un rebote bloqueado es una declaración sobre nuestro envío, no sobre el buzón del destinatario
2. Se dispara un evento webhook message.bounced con bounce_type: "blocked" (para un AdminBounce, en su lugar un evento message.failed con reason: "admin_bounce")
3. Una tasa sostenida de rebotes bloqueados genera una alerta interna para revisión manual; no hay pausa automática del envío

Estadísticas de rebotesCopiar enlace de la sección

Obtenga estadísticas agregadas de rebotes para un período de tiempo:

GET https://api.mail.land/v1/transactional/bounces/statistics

Autentíquese con Authorization: Bearer <token> o X-API-Key: <api key>.

curl https://api.mail.land/v1/transactional/bounces/statistics \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "totalBounces": 1125,
  "hardBounces": 450,
  "softBounces": 385,
  "generalBounces": 290,
  "byCategory": {
    "invalid_recipient": 380,
    "mailbox_full": 345,
    "content_rejected": 185,
    "policy_reason": 95,
    "bad_domain": 70,
    "general_bounce": 50
  }
}

Rebotes recientesCopiar enlace de la sección

Obtenga los mensajes rebotados más recientes:

GET https://api.mail.land/v1/transactional/bounces/recent?limit=50

curl "https://api.mail.land/v1/transactional/bounces/recent?limit=50" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

[
  {
    "messageId": "t_a1b2c3d4e5f6",
    "recipientEmail": "[email protected]",
    "subject": "Your order has shipped",
    "bounceCategory": "InvalidRecipient",
    "bounceReason": "550 5.1.1 The email account does not exist",
    "bouncedAt": "2026-02-17T12:34:56Z",
    "retryCount": 0
  },
  {
    "messageId": "t_d4e5f6a1b2c3",
    "recipientEmail": "[email protected]",
    "subject": "Invoice #1234",
    "bounceCategory": "QuotaIssues",
    "bounceReason": "552 5.2.2 Mailbox full",
    "bouncedAt": "2026-02-17T11:00:00Z",
    "retryCount": 2
  }
]

Los resultados están ordenados por bouncedAt de forma descendente y limitados a los últimos 90 días. bouncedAt es la hora de creación del mensaje, no una marca de tiempo de rebote registrada por separado.

Reintentar un mensaje rebotadoCopiar enlace de la sección

Reintente manualmente la entrega de un mensaje rebotado:

POST https://api.mail.land/v1/transactional/bounces/{messageId}/retry

curl -X POST https://api.mail.land/v1/transactional/bounces/t_a1b2c3d4e5f6/retry \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

El reintento reenvía el contenido original a través del outbox de MailLand. El seguimiento de apertura y de clics está DESACTIVADO en las copias reenviadas: la opción de seguimiento del envío original no se puede recuperar a partir del registro del mensaje.

Umbrales de tasa de reboteCopiar enlace de la sección

Los umbrales son valores predeterminados del plan, evaluados solo una vez que se ha alcanzado el tamaño mínimo de muestra de envíos en la ventana de evaluación:

El envío se pausa (429 de la API) al alcanzar el umbral de pausa; esto también reduce su puntuación de remitente.

Retenciones de entregabilidadCopiar enlace de la sección

Alcanzar el umbral de pausa también coloca una retención de entregabilidad duradera en el espacio de trabajo, distinta de la pausa transitoria 429 anterior. Mientras la retención esté activa, se rechaza todo envío, transaccional y de marketing por igual, con 403 ACTION_REQUIRED desde la API y un 451 4.7.0 temporal por SMTP relay, de modo que su servidor de correo mantiene el mensaje en cola y reintenta.

• La retención se coloca una vez por episodio de incumplimiento, no en cada envío.
• Persiste hasta que el soporte de MailLand la revisa y la levanta; una tasa de rebotes o quejas que se recupera no la levanta automáticamente, no existe un levantamiento automático.
• Los propietarios y administradores del espacio de trabajo reciben un correo en cuanto se coloca la retención.

Mejores prácticasCopiar enlace de la sección

• Limpie sus listas: valide las direcciones de correo antes de enviar con la Validación de correo electrónico. Elimine las direcciones que rebotan de forma sistemática.
• Monitoree las categorías de rebotes: un pico en los rebotes content_rejected puede indicar un problema de contenido, no de calidad de la lista.
• No reintente los rebotes permanentes: los rebotes permanentes son definitivos. Reintentar desperdicia cuota y daña la reputación.
• Observe los patrones de rebotes temporales: los rebotes mailbox_full repetidos desde el mismo dominio pueden indicar un problema a nivel del proveedor.
• Use el panel de entregabilidad: realice un seguimiento de las tasas de rebote por proveedor para detectar problemas específicos de dominio con anticipación.

Próximos pasosCopiar enlace de la sección

• Supresiones: gestionar la lista de supresión
• Descripción general de entregabilidad: monitorear la puntuación del remitente y las tendencias
• Eventos de Webhook: recibir eventos message.bounced