HermesHermesDocs
DocsManejo de Rebotes
6 min de lectura

Tipos de rebotes

Rebotes permanentes (bounce_hard)

Un rebote permanente significa que la dirección de correo no puede recibir mensajes de forma definitiva — la dirección no existe, el dominio no existe, o el servidor receptor lo ha rechazado permanentemente.

Hermes agrega automáticamente las direcciones con rebote permanente a tu lista de supresión y no intentará enviarles correos nuevamente.

Rebotes temporales (bounce_soft)

Un rebote temporal es una falla transitoria — el buzón está lleno, el servidor no está disponible temporalmente, o el mensaje era demasiado grande. Hermes registra el evento pero no suprime la dirección.

Supresión automática

Hermes mantiene una lista de supresión por workspace. Cuando una dirección genera un rebote permanente o una queja de spam, se agrega automáticamente. Los envíos futuros a direcciones suprimidas se descartan silenciosamente — protegiendo tu reputación de envío.

Manejar eventos de rebote vía webhook

Suscríbete a bounce_hard y bounce_soft para procesar rebotes en tu aplicación:

{
  "event": "bounce_hard",
  "email_id": "a1b2c3d4-...",
  "timestamp": "2026-05-29T14:32:10.000",
  "metadata": {
    "bounce_type": "Permanent",
    "bounce_subtype": "General",
    "bounced_recipients": ["[email protected]"],
    "diagnostic_codes": ["smtp; 550 5.1.1 user unknown"]
  }
}

Actualiza tu base de datos cuando ocurra un rebote permanente:

if event["event"] == "bounce_hard":
    recipient = event["metadata"]["bounced_recipients"][0]
    await db.users.update_one(
        {"email": recipient},
        {"$set": {"email_valid": False}}
    )

Reactivar direcciones suprimidas

Elimina una dirección de la lista de supresión desde el dashboard en Configuración → Lista de Supresión. Solo hazlo cuando tengas evidencia sólida de que el problema se ha resuelto.

Buenas prácticas

  • Procesa los webhooks de rebote y actualiza tu propia base de datos — no dependas únicamente de la lista de supresión de Hermes
  • Limpia tu lista de forma proactiva — elimina direcciones que no han interactuado en 6+ meses antes de importar
  • Monitorea tu tasa de rebote — por encima del 5% es un riesgo serio para la entregabilidad; por encima del 10% puede provocar restricciones de envío
  • Nunca compres listas de correo — las listas compradas tienen altas tasas de rebote que dañan tu reputación de envío
← Anterior
Webhooks