Référence
Statuts des e-mails
Tous les statuts d’e-mail d’Emailit, leur signification, s’ils peuvent encore changer, l’événement webhook qu’ils envoient et ce qu’il faut faire ensuite.
Chaque e-mail a un statut qui indique où il en est dans son cycle de vie. Cette page liste les 14 statuts, la façon dont un e-mail passe de l’un à l’autre et ce qu’il faut faire quand un e-mail s’arrête là où vous ne l’attendiez pas. Le statut ne reflète que le dernier état ; l’historique complet se trouve sur la page de détail de l’e-mail et dans les événements.
Référence des statuts
« Définitif » signifie qu’Emailit ne modifiera plus le statut de lui-même. Un e-mail au statut définitif peut tout de même être relancé, ce qui crée un nouvel e-mail avec un nouvel ID.
| Statut | Info-bulle du tableau de bord | Définitif | Événement webhook | Signification et que faire |
|---|---|---|---|---|
accepted |
« Accepted for delivery » | Non | email.accepted |
Enregistré et mis en file d’attente pour livraison. Évolue généralement en quelques secondes. Les e-mails envoyés via SMTP n’émettent pas email.accepted. |
scheduled |
« Scheduled for delivery in the future » | Non | email.scheduled |
Attend son heure scheduled_at. Vous pouvez changer l’heure ou l’annuler jusqu’à 3 minutes avant l’échéance. |
delivered |
« Delivered to the recipient’s mail server » | Non | email.delivered |
Le serveur destinataire a accepté le message. Il peut encore passer à loaded ou clicked, et un rapport de rebond ou une plainte ultérieurs peuvent le faire passer à bounced ou complained. |
loaded |
« Email content was loaded by the recipient » | Non | email.loaded |
L’image de suivi a été chargée (une ouverture). Nécessite le suivi des chargements sur un domaine de suivi vérifié. |
clicked |
« A link in the email was clicked » | Non | email.clicked |
Un lien suivi a été cliqué. Nécessite le suivi des clics sur un domaine de suivi vérifié. |
attempted |
« Delivery attempted but resulted in a temporary failure » | Non | email.attempted |
Le serveur destinataire a répondu par une erreur temporaire. Emailit réessaie automatiquement ; consultez le calendrier des nouvelles tentatives. |
bounced |
« Email permanently failed to deliver » | Oui | email.bounced |
Le serveur destinataire a définitivement refusé le message, un rapport de rebond est arrivé plus tard, ou les nouvelles tentatives sont épuisées. Vérifiez l’adresse avant de lui écrire de nouveau. Pour savoir quand l’adresse est bloquée automatiquement, consultez Rebonds et plaintes. |
failed |
« Failed to deliver due to a specific error » | Oui | email.failed |
Une erreur de traitement plutôt qu’une réponse du serveur du destinataire. Rare. Relancez-le avec l’API. |
rejected |
« Accepted for delivery but rejected after » | Oui | email.rejected |
Emailit a refusé de l’envoyer après l’avoir accepté, car un espace de travail non vérifié ne peut envoyer qu’à ses membres. |
suppressed |
« Recipient is on the suppression list » | Oui | email.suppressed |
Non envoyé, car l’adresse figure dans votre liste d’adresses bloquées. Ne supprimez le blocage que si vous êtes sûr de vous, puis relancez. |
received |
« Incoming email was accepted » | Oui | email.received |
Un message entrant a été reçu sur votre sous-domaine de réception. |
complained |
« A complaint was registered for this email » | Oui | email.complained |
Le destinataire l’a signalé comme spam et son fournisseur l’a rapporté. L’adresse est ajoutée aux adresses bloquées, sauf si vos paramètres de blocage automatique excluent les plaintes. N’envoyez plus d’e-mail à cette adresse. |
canceled |
« Canceled: pulled from the send queue when possible » | Oui | email.canceled |
Vous l’avez annulé dans le tableau de bord ou avec l’API. L’annulation se fait au mieux. |
held |
« Email is being held » | Oui | email.held |
Emailit ne l’a pas envoyé. Consultez pourquoi un e-mail est retenu, corrigez la cause, puis relancez. |
Les webhooks reçoivent email.canceled et email.held lorsqu’ils sont abonnés à tous les événements, ou lorsque vous ajoutez ces événements à la liste d’événements du webhook avec l’API. Consultez Types d’événements.
Cycle de vie
La plupart des e-mails suivent ce parcours :
- Création. Un envoi par l’API crée l’e-mail avec le statut
accepted, ouscheduledquandscheduled_atest dans le futur. Les envois SMTP commencent aussi àaccepted. Les e-mails entrants sont créés avec le statutreceived, qui ne change jamais. - Contrôle. Avant chaque tentative de livraison, Emailit contrôle l’espace de travail, le domaine, la clé API, les crédits, la liste d’adresses bloquées et le score de spam. Un contrôle en échec termine l’e-mail en
held,rejectedousuppressedsans l’envoyer. - Livraison ou report. La tentative de livraison réussit (
delivered), échoue temporairement (attempted, puis nouvelle tentative) ou échoue définitivement (bounced). - Engagement. Si le suivi est activé, les ouvertures et les clics font passer un e-mail livré à
loaded, puis àclicked. - Rapports tardifs. Un rapport de rebond qui arrive après la livraison fait passer le statut à
bounced. Une plainte pour spam le fait passer àcomplained.
À tout moment avant la livraison, un e-mail scheduled, accepted ou attempted peut passer à canceled.
L’échelle d’engagement
Les statuts de livraison et d’engagement ne font qu’avancer :
accepted, scheduled ou attempted → delivered → loaded → clicked
Un événement ultérieur ne fait jamais redescendre un e-mail sur cette échelle. Si un clic est enregistré, l’e-mail reste clicked même si d’autres ouvertures arrivent. Une ouverture ou un clic peut sauter l’étape delivered, car il prouve que le message est arrivé. Les statuts qui mettent fin à la livraison (bounced, failed, rejected, suppressed, complained et canceled) ne sont jamais remplacés par des ouvertures ou des clics.
Calendrier des nouvelles tentatives pour attempted
Quand un serveur destinataire répond par une erreur temporaire (une réponse 4xx comme 421 ou 451, un timeout ou une erreur de connexion), l’e-mail passe à attempted et Emailit réessaie. Chaque attente dure deux fois plus longtemps que la précédente :
| Après la tentative en échec | Étape suivante |
|---|---|
| 1 | Nouvel essai au bout de 10 minutes |
| 2 | Nouvel essai au bout de 20 minutes |
| 3 | Nouvel essai au bout de 40 minutes |
| 4 | Nouvel essai au bout de 80 minutes |
| 5 | Nouvel essai au bout de 160 minutes |
| 6 | Nouvel essai au bout de 320 minutes |
| 7 | Attente de 640 minutes, puis l’e-mail est marqué bounced |
Cela fait 7 tentatives de livraison sur environ 21 heures. Une fois qu’elles sont épuisées, l’e-mail est marqué bounced avec « Maximum number of delivery attempts (7) has been reached », et le destinataire est ajouté aux adresses bloquées avec la raison too many soft fails, sauf si vos paramètres de blocage automatique excluent les rebonds.
Chaque tentative figure dans l’onglet Deliveries de l’e-mail avec la réponse du serveur, et chacune envoie un événement email.attempted qui contient smtp_code, smtp_enhanced_code et smtp_response. Certaines réponses temporaires qui signalent clairement un problème définitif, comme une boîte aux lettres désactivée, sont traitées immédiatement comme des rebonds. Quand un fournisseur limite le débit, Emailit peut aussi suspendre brièvement la livraison vers celui-ci ; ces lignes indiquent « Delivery delayed due to… ».
Pourquoi un e-mail est retenu
Un e-mail retenu a été retiré de la file d’envoi sans être envoyé. L’onglet Deliveries de l’e-mail indique la raison qui s’applique :
| Raison | Message dans l’onglet Deliveries | Que faire |
|---|---|---|
| Espace de travail suspendu | « Mail server has been suspended. No e-mails can be processed at present. Contact support for assistance. » | Consultez Santé d’envoi et contactez le support. |
| Domaine d’envoi en pause | « Sending from this domain is paused. Contact support for assistance. » | Le taux de rebond du domaine était trop élevé. Consultez Santé d’envoi. |
| Crédits insuffisants | « Workspace has not enough email credits to send this email. » | Achetez des crédits ou activez la recharge automatique. |
| Score de spam trop élevé | « Held because Rspamd scored this message 8.4, which is at or above the threshold of 7. » | Consultez les contrôles anti-spam de l’e-mail, corrigez le contenu, puis relancez. |
| Clé API configurée pour retenir | « Credential is configured to hold all messages authenticated by it. » | Les messages envoyés avec cette clé sont retenus volontairement. Contactez le support. |
Les e-mails retenus ne sont pas libérés automatiquement. Après avoir corrigé la cause, sélectionnez Retry sur l’e-mail, ou appelez Relancer un e-mail. La relance crée un nouvel e-mail avec le même contenu et débite de nouveau des crédits.
Pourquoi un e-mail est rejeté
Tant que votre espace de travail n’a pas l’accès production, vous ne pouvez envoyer qu’aux adresses e-mail des comptes des membres de l’espace de travail. Pour les autres destinataires, l’API renvoie 403 et SMTP renvoie 550 au moment de l’envoi : la plupart du temps, vous voyez donc l’erreur plutôt qu’un e-mail. Le statut rejected apparaît quand le même contrôle échoue plus tard, au moment de la livraison, par exemple pour un e-mail programmé auparavant. L’onglet Deliveries affiche « Unverified workspaces can only send to workspace members’ account emails » et l’adresse bloquée.
Règles de relance
| Bouton Retry du tableau de bord | API Relancer un e-mail | |
|---|---|---|
| Statuts | held, suppressed |
bounced, failed, suppressed, held |
| Ancienneté | Moins de 30 jours | Moins de 30 jours |
| Contenu | Ne doit pas avoir été purgé par la conservation des données | Ne doit pas avoir été purgé |
| Résultat | Un nouvel e-mail avec un nouvel ID ; l’original reste inchangé | Identique, la réponse inclut original_id |
Pour un e-mail bloqué, retirez d’abord l’adresse de votre liste d’adresses bloquées, sinon la relance est de nouveau bloquée.