E-mail

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.

i

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).

Automatique

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.

Modifiable avecretryUnavailable · retryUnavailableSeconds

Serveur 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.

Automatique

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).

Modifiable avecretryRateLimited

Options 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.

  • retryRateLimitedintegerfacultatif

    Combien 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.

    Plage 0 – 24Par défaut 25 cyclesSMTP X-Sendcorex-Retry-Rate-Limited
  • retryUnavailableintegerfacultatif

    Combien de fois réessayer après une erreur temporaire. 0 échoue dès la première.

    Plage 0 – 30Par défaut Dépend de l'erreur (jusqu'à 10)SMTP X-Sendcorex-Retry-Unavailable
  • retryUnavailableSecondsintegerfacultatif

    Combien de secondes attendre entre ces essais.

    Plage 10 – 3600Par défaut Dépend de l'erreurSMTP X-Sendcorex-Retry-Unavailable-Seconds
  • ignoreHardBouncebooleanfacultatif

    Envoie 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.

    Plage true · falsePar défaut falseSMTP X-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.

  • sendingIpstringfacultatif

    Une 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 IPSMTP 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"
}

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_IP La 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.1 Même vérification sur le header X-Sendcorex-Sending-IP. Le message est rejeté à la fin de DATA.

  • MCP

    INVALID_SENDING_IP Mê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.

200

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.