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.
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).
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ú.
retryUnavailable · retryUnavailableSecondsServidor 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.
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).
retryRateLimitedOpciones 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.
retryRateLimitedintegeropcionalCuá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.
Rango0 – 24Por defecto 25 ciclosSMTPX-Sendcorex-Retry-Rate-LimitedretryUnavailableintegeropcionalCuántas veces reintentar tras un error temporal. 0 falla en el primero.
Rango0 – 30Por defecto Depende del error (hasta 10)SMTPX-Sendcorex-Retry-UnavailableretryUnavailableSecondsintegeropcionalCuántos segundos esperar entre esos intentos.
Rango10 – 3600Por defecto Depende del errorSMTPX-Sendcorex-Retry-Unavailable-SecondsignoreHardBouncebooleanopcionalEnví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.
Rangotrue · falsePor defecto falseSMTPX-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.
sendingIpstringopcionalUna 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 IPsSMTPX-Sendcorex-Sending-IPMCPsending_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_IPEl 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.1La misma comprobación sobre el header X-Sendcorex-Sending-IP. El mensaje se rechaza al final de DATA.MCP
INVALID_SENDING_IPLa 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.
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.