Options de livraison
Ce qui se passe quand un e-mail ne peut pas être livré tout de suite, et comment le modifier par e-mail : combien de temps nous continuons à réessayer, et s'il faut envoyer à une adresse qui a déjà fait un hard bounce.
Toutes les options sont facultatives. Sans elles, chaque e-mail suit les valeurs par défaut ci-dessous. Elles se placent dans le body de Envoyer un e-mail, ou sous forme de headers lorsque vous envoyez via SMTP.
Fonctionnement des nouvelles tentatives
Un rejet permanent, comme une adresse qui n'existe pas, est définitif et n'est pas réessayé. Ces cas sont réessayés pour vous :
Greylisting
Le serveur de destination répond « réessayez plus tard » à un expéditeur qu'il ne connaît pas.
Nous réessayons depuis la même IP après 5, 10, 20, 40, 60 et 60 minutes (environ 3 heures au total).
Erreurs temporaires
Une réponse 4xx, trop de connexions, ou une connexion qui coupe en cours d'envoi.
Nous réessayons quelques fois avec une pause entre les essais. Le nombre d'essais et le délai dépendent de l'erreur, sauf si vous les définissez.
retryUnavailable · retryUnavailableSecondsServeur de destination indisponible
Le serveur de messagerie du destinataire n'accepte aucune connexion.
Nous attendons son retour sans consommer vos nouvelles tentatives. S'il est toujours indisponible après 24 heures, l'e-mail est marqué comme bounced.
Rate limit
Le fournisseur de messagerie (Outlook, Yahoo, AOL…) nous demande de ralentir.
L'e-mail attend et est réessayé toutes les 30 minutes, éventuellement depuis une autre IP. Par défaut, nous continuons pendant 25 cycles (environ 12 heures).
retryRateLimitedOptions de nouvelle tentative
Vous fixez la limite, nous fixons le plafond. Une valeur hors de la plage est ramenée à la valeur autorisée la plus proche, et la réponse vous le signale dans warnings. Les noms de champs ne sont pas sensibles à la casse : retryRateLimited et retry_rate_limited sont équivalents.
retryRateLimitedintegerfacultatifCombien de cycles de rate limit de 30 minutes attendre avant d'abandonner. 0 abandonne au premier rate limit. Utilisez une valeur faible pour les e-mails urgents, comme les codes de connexion.
Plage0 – 24Par défaut 25 cyclesSMTPX-Sendcorex-Retry-Rate-LimitedretryUnavailableintegerfacultatifCombien de fois réessayer après une erreur temporaire. 0 échoue dès la première.
Plage0 – 30Par défaut Dépend de l'erreur (jusqu'à 10)SMTPX-Sendcorex-Retry-UnavailableretryUnavailableSecondsintegerfacultatifCombien de secondes attendre entre ces essais.
Plage10 – 3600Par défaut Dépend de l'erreurSMTPX-Sendcorex-Retry-Unavailable-SecondsignoreHardBouncebooleanfacultatifEnvoie même si l'adresse a fait un hard bounce au cours des 90 derniers jours. Un essai par adresse, et l'option est désactivée pendant 7 jours après 3 échecs en 24 heures. Voir Hard bounces connus ci-dessous.
Plagetrue · falsePar défaut falseSMTPX-Sendcorex-Ignore-Hard-Bounce
Hard bounces connus
Quand une adresse fait un hard bounce (la boîte aux lettres n'existe pas), nous la mémorisons pendant 90 jours. Lui envoyer à nouveau ne ferait que nuire à votre réputation d'expéditeur, nous ne nous reconnectons donc pas au serveur de destination :
Sans le Hard Bounce Shield
Marqué comme bounced
L'e-mail n'est pas envoyé et est enregistré comme bounce. Il compte dans votre taux de bounce.
Avec le Hard Bounce Shield
Supprimé
L'e-mail n'est pas envoyé et est enregistré comme Suppressed. Il consomme un crédit, mais ne compte pas comme bounce. Vous recevez quand même le webhook bounced, avec suppressed: true, afin que chaque e-mail se termine par un événement final.
Boîte aux lettres pleine
Une boîte pleine est une erreur temporaire, l'adresse n'est donc pas mémorisée la première fois. Si la même adresse revient pleine sur 3 e-mails d'affilée, sans livraison entre eux et avec moins de 30 jours d'écart, nous la traitons ensuite comme un hard bounce. Une livraison réussie remet le compteur à zéro.
Envoyer quand même
Si vous savez que la boîte aux lettres existe désormais (le destinataire l'a corrigée, ou c'était un problème temporaire de son côté), définissez ignoreHardBounce: true. L'e-mail est envoyé normalement. S'il est livré, l'adresse est retirée de la liste et vous n'avez plus besoin de l'option pour elle.
Limites
L'option signifie « cette boîte aux lettres existe désormais ». Quand cela s'avère faux, elle cesse de fonctionner :
Un essai par adresse
Si l'e-mail fait de nouveau un hard bounce, il compte comme bounce, l'adresse est mémorisée pour 90 jours de plus, et l'option est ignorée pour cette adresse jusque-là.
3 échecs en 24 heures
Si 3 e-mails envoyés avec l'option font de nouveau un hard bounce, chacun moins de 24 heures après le précédent, l'option est désactivée sur votre compte pendant 7 jours. Vos e-mails continuent de partir ; les hard bounces connus sont simplement ignorés comme d'habitude.
Quand l'option a été ignorée, le reason commence par ignore_hard_bounce revoked: et en indique la raison.
Utilisez-la par e-mail, pas par défaut. Les fournisseurs de messagerie surveillent la fréquence à laquelle vous envoyez à des adresses inexistantes. L'activer sur chaque envoi supprime la protection.
Choisir l'IP d'envoi
Avec des IP dédiées, nous choisissons laquelle de vos IP envoie chaque e-mail selon les paramètres de votre page IP. Pour décider vous-même, définissez sendingIp sur l'une de vos IP dédiées. L'e-mail part uniquement de cette IP, du premier essai à la dernière nouvelle tentative.
sendingIpstringfacultatifUne adresse IPv4 ou IPv6 qui est l'une de vos IP dédiées et qui est active. Toute autre valeur rejette l'e-mail.
Par défaut Choisie par vos paramètres IPSMTPX-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"
}Ce qu'il remplace
Ces paramètres de votre page IP ne s'appliquent pas à un e-mail envoyé avec sendingIp. Les e-mails sans ce champ continuent de les suivre.
Quelle IP envoie
Nous alternons normalement entre vos IP dédiées. L'e-mail part de celle que vous avez choisie.
Routage IPv4 et IPv6
La répartition IPv4/IPv6 de vos paramètres de routage est ignorée. Une adresse IPv6 envoie en IPv6, une adresse IPv4 en IPv4.
Basculement en cas de rate limit
Nous réessayons normalement depuis une autre de vos IP dédiées. L'e-mail attend sur l'IP que vous avez choisie.
Blacklist Guard
Si l'IP est listée, l'e-mail n'est pas déplacé vers une IP partagée. Il attend sur l'IP que vous avez choisie.
E-mails planifiés
L'IP est enregistrée avec l'e-mail et utilisée au moment de l'envoi, même si vos paramètres IP changent entre-temps.
Erreurs
API
400 INVALID_SENDING_IPLa valeur n'est pas une adresse IP, ou ce n'est pas l'une de vos IP dédiées actives. L'e-mail n'est pas mis en file.SMTP
550 5.7.1Même vérification sur le header X-Sendcorex-Sending-IP. Le message est rejeté à la fin de DATA.MCP
INVALID_SENDING_IPMême vérification sur l'argument sending_ip de email_send.
Une IP fixe attend au lieu de changer.Si le fournisseur ralentit cette IP ou si elle est listée, l'e-mail attend sur la même IP jusqu'à son envoi ou l'épuisement des nouvelles tentatives. Pour les e-mails qui ne peuvent pas attendre, omettez sendingIp et laissez-nous choisir.
Exemple
Un code de connexion est inutile au bout de quelques minutes, ne le laissez donc pas attendre des heures.
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);Réponse avec une valeur ajustée
Ici, retryRateLimited a été envoyé avec la valeur 40. L'e-mail est tout de même mis en file, avec 24.
E-mail mis en file, avec un avertissement
{
"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
Vous envoyez en SMTP ? Ajoutez les mêmes options sous forme de headers. Nous les lisons et les retirons avant la livraison de l'e-mail, le destinataire ne les voit donc jamais.
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
Événements webhook
Suivez les nouvelles tentatives en temps réel avec ces événements webhook :
- retrying
Une erreur temporaire s'est produite et l'e-mail sera réessayé. Le reason indique de quel essai il s'agit.
- failed
Nous avons abandonné après épuisement des nouvelles tentatives ou des cycles de rate limit.
- bounced
Le serveur de destination a définitivement rejeté l'e-mail, ou est resté indisponible pendant 24 heures. Également envoyé lorsque nous ignorons un hard bounce connu, avec suppressed: true si vous avez le Hard Bounce Shield.