Email

Opciones de entrega

Qué pasa cuando un email no se puede entregar de inmediato y cómo cambiarlo por email: cuánto tiempo seguimos reintentando y si se envía a una dirección que ya dio hard bounce.

i

Todas las opciones son opcionales. Sin ellas, cada email sigue los valores por defecto de abajo. Van en el body de Enviar email, o como headers cuando envías por SMTP.

Cómo funcionan los reintentos

Un rechazo permanente, como una dirección que no existe, es definitivo y no se reintenta. Estos casos los reintentamos por ti:

Greylisting

El servidor de destino responde "inténtalo más tarde" a un remitente que no ha visto antes.

Volvemos a intentarlo desde la misma IP después de 5, 10, 20, 40, 60 y 60 minutos (unas 3 horas en total).

Automático

Errores temporales

Una respuesta 4xx, demasiadas conexiones o una conexión que se corta a mitad del envío.

Lo intentamos de nuevo varias veces con una pausa entre intentos. Cuántas veces y cuánto esperar depende del error, salvo que lo definas tú.

Cámbialo conretryUnavailable · retryUnavailableSeconds

Servidor de destino caído

El servidor de correo del destinatario no acepta ninguna conexión.

Esperamos a que vuelva sin gastar tus reintentos. Si sigue caído después de 24 horas, el email se marca como bounced.

Automático

Rate limit

El proveedor de correo (Outlook, Yahoo, AOL…) nos pide que reduzcamos el ritmo.

El email espera y se reintenta cada 30 minutos, posiblemente desde otra IP. Por defecto seguimos intentándolo durante 25 ciclos (unas 12 horas).

Cámbialo conretryRateLimited

Opciones de reintento

Tú defines el límite, nosotros el techo. Un valor fuera del rango se ajusta al valor permitido más cercano y la respuesta te lo indica en warnings. Los nombres de los campos no distinguen entre mayúsculas y minúsculas: retryRateLimited y retry_rate_limited son lo mismo.

  • retryRateLimitedintegeropcional

    Cuántos ciclos de rate limit de 30 minutos esperar antes de desistir. 0 desiste en el primer rate limit. Usa un valor bajo para emails urgentes, como códigos de inicio de sesión.

    Rango 0 – 24Por defecto 25 ciclosSMTP X-Sendcorex-Retry-Rate-Limited
  • retryUnavailableintegeropcional

    Cuántas veces reintentar tras un error temporal. 0 falla en el primero.

    Rango 0 – 30Por defecto Depende del error (hasta 10)SMTP X-Sendcorex-Retry-Unavailable
  • retryUnavailableSecondsintegeropcional

    Cuántos segundos esperar entre esos intentos.

    Rango 10 – 3600Por defecto Depende del errorSMTP X-Sendcorex-Retry-Unavailable-Seconds
  • ignoreHardBouncebooleanopcional

    Envía aunque la dirección haya dado hard bounce en los últimos 90 días. Un intento por dirección, y se desactiva durante 7 días tras 3 fallos en 24 horas. Consulta Hard bounces conocidos más abajo.

    Rango true · falsePor defecto falseSMTP X-Sendcorex-Ignore-Hard-Bounce

Hard bounces conocidos

Cuando una dirección da hard bounce (el buzón no existe), la recordamos durante 90 días. Volver a enviarle solo dañaría tu reputación de remitente, así que no volvemos a conectarnos al servidor de destino:

Sin Hard Bounce Shield

Marcado como bounced

El email no se envía y se registra como bounce. Cuenta en tu tasa de bounce.

Con Hard Bounce Shield

Suprimido

El email no se envía y se registra como Suppressed. Usa un crédito, pero no cuenta como bounce. Sigues recibiendo el webhook bounced, con suppressed: true, para que cada email termine con un evento final.

Buzón lleno

Un buzón lleno es un error temporal, así que la dirección no se recuerda la primera vez. Si la misma dirección vuelve como llena en 3 emails seguidos, sin ninguna entrega entre ellos y con menos de 30 días entre uno y otro, a partir de entonces la tratamos como hard bounce. Una entrega correcta reinicia el contador.

Enviar de todos modos

Si sabes que el buzón existe ahora (el destinatario lo arregló o fue un problema temporal de su lado), establece ignoreHardBounce: true. El email se envía normalmente. Si se entrega, la dirección se elimina de la lista y ya no necesitas la opción para ella.

Límites

La opción significa "este buzón existe ahora". Cuando eso resulta no ser cierto, deja de funcionar:

  • Un intento por dirección

    Si el email vuelve a dar hard bounce, cuenta como bounce, la dirección se recuerda otros 90 días y la opción se ignora para esa dirección hasta entonces.

  • 3 fallos en 24 horas

    Si 3 emails enviados con la opción vuelven a dar hard bounce, cada uno a menos de 24 horas del anterior, la opción se desactiva en tu cuenta durante 7 días. Tus emails siguen saliendo; los hard bounces conocidos simplemente se omiten como siempre.

Cuando la opción se ignoró, el reason empieza por ignore_hard_bounce revoked: e indica el motivo.

!

Úsala por email, no por defecto. Los proveedores de correo vigilan con qué frecuencia envías a direcciones que no existen. Activarla en todos los envíos elimina la protección.

Elegir la IP de envío

Con IPs dedicadas, elegimos cuál de tus IPs envía cada email según la configuración de tu página de IPs. Para decidirlo tú, establece sendingIp con una de tus IPs dedicadas. El email sale solo desde esa IP, desde el primer intento hasta el último reintento.

  • sendingIpstringopcional

    Una dirección IPv4 o IPv6 que sea una de tus IPs dedicadas y esté activa. Cualquier otro valor rechaza el email.

    Por defecto Elegida por tu configuración de IPsSMTP X-Sendcorex-Sending-IPMCP sending_ip
{
  "to": "customer@example.com",
  "from": "billing@yourdomain.com",
  "senderName": "My App",
  "subject": "Your invoice",
  "body": "<p>Your invoice is ready.</p>",
  "sendingIp": "203.0.113.10"
}

Qué sobrescribe

Estos ajustes de tu página de IPs no se aplican a un email enviado con sendingIp. Los emails sin él siguen respetándolos.

  • Qué IP envía

    Normalmente alternamos entre tus IPs dedicadas. El email sale desde la que elegiste.

  • Enrutamiento IPv4 e IPv6

    Se omite el reparto IPv4/IPv6 de tu configuración de enrutamiento. Una dirección IPv6 envía por IPv6, una IPv4 por IPv4.

  • Failover con rate limit

    Normalmente reintentamos desde otra de tus IPs dedicadas. El email espera en la IP que elegiste.

  • Blacklist Guard

    Si la IP entra en una lista negra, el email no se mueve a una IP compartida. Espera en la IP que elegiste.

  • Emails programados

    La IP se guarda con el email y se usa cuando sale, aunque tu configuración de IPs cambie entre tanto.

Errores

  • API

    400 INVALID_SENDING_IP El valor no es una dirección IP o no es una de tus IPs dedicadas activas. El email no se encola.

  • SMTP

    550 5.7.1 La misma comprobación sobre el header X-Sendcorex-Sending-IP. El mensaje se rechaza al final de DATA.

  • MCP

    INVALID_SENDING_IP La misma comprobación sobre el argumento sending_ip de email_send.

!

Una IP fija espera en lugar de cambiar.Si el proveedor ralentiza esa IP o entra en una lista negra, el email espera en la misma IP hasta que sale o se agotan los reintentos. Para emails que no pueden esperar, no incluyas sendingIp y deja que elijamos nosotros.

Ejemplo

Un código de inicio de sesión no sirve después de unos minutos, así que no lo dejes esperando horas.

import axios from 'axios';

const response = await axios.post(
  'https://mail.sendcorex.com/v3.0/send',
  {
    to: 'user@example.com',
    from: 'noreply@yourdomain.com',
    senderName: 'My App',
    subject: 'Your login code',
    body: '<p>Your code is <b>482913</b></p>',
    retryRateLimited: 4,         // give up after 4 rate-limit cycles (~2 h)
    retryUnavailable: 5,         // up to 5 retries on temporary errors
    retryUnavailableSeconds: 30, // 30 s between them
    ignoreHardBounce: true,      // send even if this address hard bounced before
  },
  {
    headers: { Authorization: process.env.SENDCOREX_API_KEY },
  }
);

console.log(response.data.id, response.data.warnings);

Respuesta con un valor ajustado

Aquí retryRateLimited se envió como 40. El email se encola igualmente, con 24.

200

Email encolado, con una advertencia

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "ids": [
    { "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
  ],
  "recipients": 1,
  "scheduledAt": null,
  "warnings": ["retry_rate_limited 40 → 24"]
}

Headers SMTP

¿Envías por SMTP? Añade las mismas opciones como headers. Las leemos y las eliminamos antes de entregar el email, así que el destinatario nunca las ve.

X-Sendcorex-Retry-Rate-Limited: 4
X-Sendcorex-Retry-Unavailable: 5
X-Sendcorex-Retry-Unavailable-Seconds: 30
X-Sendcorex-Ignore-Hard-Bounce: true
X-Sendcorex-Sending-IP: 203.0.113.10

Eventos de webhook

Sigue los reintentos en tiempo real con estos eventos de webhook:

  • retrying

    Ocurrió un error temporal y el email se volverá a intentar. El reason indica qué intento es.

  • failed

    Desistimos después de agotar los reintentos o los ciclos de rate limit.

  • bounced

    El servidor de destino rechazó el email definitivamente, o estuvo caído durante 24 horas. También se envía cuando omitimos un hard bounce conocido, con suppressed: true si tienes Hard Bounce Shield.