Cuándo frenamos tus envíos

Los rate limits y cuotas son límites que conoces de antemano. Esta página es sobre lo otro: qué pasa cuando la calidad de tus envíos empieza a hacer daño, y qué tienes que hacer para volver a la normalidad.

Compartes infraestructura de envío con otras cuentas. Una lista comprada o un formulario sin confirmación no solo te afectan a ti: afectan a todos los que envían desde la misma IP. Por eso esto no es negociable, y por eso preferimos avisarte tres veces antes de cortar nada.

La escalera

Cada hora evaluamos tus rebotes duros y tus quejas de spam sobre una ventana móvil de 7 días. Según qué tan cerca estés del umbral de tu plan:

Nivel	Cuándo	Qué pasa
Aviso	Pasas el 50% del umbral	Correo al dueño de la cuenta. Nada se frena.
Aviso urgente	Pasas el 80% del umbral	Correo + aviso en tu panel. Nada se frena todavía.
Suspensión	Cruzas el umbral	Se detiene el envío del canal responsable.

No evaluamos solo el promedio. Medimos cada canal por separado —marketing y transaccional— porque un 5% de quejas en tus campañas se diluye a 0.5% dentro de un volumen transaccional grande y no dispararía nada, aunque ese 5% sea justo lo que está quemando la reputación.

Los umbrales dependen de tu plan y los ves en tu panel. Hoy los valores en uso son:


Ventana de medición	7 días
Umbral de rebotes duros	10%
Umbral de quejas	0.3%
Piso de rebotes	5 eventos
Piso de quejas	3 eventos

No comparamos tu tasa: comparamos lo que tu tasa prueba

Diez quejas sobre 5.000 envíos y cien sobre 50.000 son las dos 0.2%. No significan lo mismo: la primera es una mala semana, la segunda es tu tasa.

Por eso no medimos contra el porcentaje observado, sino contra el piso de un intervalo de confianza del 95% — o sea, contra lo más bajo que tu tasa real puede ser dado lo que se observó. Con poco volumen ese intervalo es ancho y hace falta muchísima evidencia para cruzar el umbral; con volumen alto se angosta y basta con estar apenas encima.

Lo que se observa	Tasa	¿Se actúa?
10 quejas en 5.000 envíos	0.2%	No — el piso es 0.11%, no alcanza
100 quejas en 50.000	0.2%	Sí, aviso — el piso es 0.16%
10 quejas en 20 envíos	50%	Sí, suspensión — el piso es 29.9%

Suspendemos el canal culpable, no la cuenta

Si el problema viene de tus campañas, se detienen tus campañas y secuencias. Tu correo transaccional —altas, recuperación de contraseña, recibos— sigue saliendo con normalidad.

Al revés también aplica. Y si no podemos determinar de dónde viene el problema (el daño está repartido, o los eventos no se pudieron atribuir a un canal), se detiene todo: ante la duda no acotamos.

Cuando el transaccional está suspendido, POST /v1/mail/send responde:

{
  "error": {
    "type": "authorization_error",
    "code": "transactional_suspended",
    "message": "El envío transaccional de esta cuenta está suspendido por tasas de rebote o queja fuera de umbral. Revisa el detalle en el panel."
  }
}

Tu sesión del panel nunca se corta por esto. Cortarte el acceso sería quitarte justo la pantalla donde puedes ver por qué se te suspendió y pedir la reactivación.

Cómo se reactiva

La reactivación es automática, pero exige las tres cosas a la vez:

Que pase el enfriamiento. Empieza en horas y crece con cada reincidencia: quien vuelve a cruzar el umbral por segunda o tercera vez espera más que la primera.
Que reconozcas la pausa. Un botón en tu panel (POST /v1/client/keys/:id/acknowledge-pause). No es un trámite: sirve para que quede claro que alguien vio el problema, no que se esperó a que el reloj corriera solo.
Que tus métricas vuelvan a verde. No basta con bajar del umbral — hay que bajar bastante por debajo. Si reactiváramos justo en el límite, la cuenta entraría y saldría de la suspensión todo el día.

Uso del endpoint transaccional como masivo

POST /v1/mail/send es para correo transaccional: uno a uno, disparado por algo que hizo el destinatario. No tiene control de ritmo por dominio, ni chequeo de supresiones de marketing, ni tracking de campaña.

Cuando detectamos el mismo cuerpo enviado a muchos destinatarios distintos en 24 horas, ese envío se rechaza con 422 y te llega un correo explicándolo. Eso no frena nada más.

Pero si el patrón se sostiene, entra a la misma escalera de arriba y termina suspendiendo tu canal transaccional. No es un castigo por volumen: es que ese tráfico por esa vía llega peor y genera quejas que pagamos todos.

Para envíos masivos usa campañas, que sí tienen control de ritmo, supresiones, tracking y mejor entregabilidad.

Adjuntos con virus

Si tu servidor tiene el escaneo activo, los adjuntos se revisan antes de enviarse. Un adjunto infectado devuelve 422 nombrando el archivo y la firma detectada:

{
  "errors": [
    {
      "field": "attachments",
      "code": "virus_detected",
      "message": "El adjunto \"factura.pdf\" fue rechazado por el antivirus (Eicar-Test-Signature)."
    }
  ]
}

Se te dice cuál archivo para que no tengas que adivinar cuando mandas varios. Si el escáner no está disponible momentáneamente, tu correo sale igual: no dejamos de enviarte el correo por una falla nuestra.

Qué hacer para no llegar acá

Confirmación por doble opt-in en tus listas. Es lo que más baja las quejas.
Quita a quien no abre. Una lista vieja que nunca se poda es la causa número uno de rebotes duros. Puedes mandar una campaña de reconfirmación y dar de baja a quien no responda.
No compres listas. Se detecta rápido, y es la vía más corta a una suspensión.
Revisa tu panel. El estado de tus métricas contra el umbral de tu plan está siempre visible, no solo cuando algo se rompe.