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
