# 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](/fr/docs/logs/email-details/) de l’e-mail et dans les [événements](/fr/docs/logs/events/).

## 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](/fr/docs/api-reference/emails/update/) 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](/fr/docs/tracking/) 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](#retry-schedule-for-attempted). |
| `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](/fr/docs/deliverability/bounces-and-complaints/). |
| `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é](#why-an-email-is-rejected) 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](/fr/docs/suppressions/). 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](/fr/docs/inbound/) 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](#why-an-email-is-held), 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](/fr/docs/webhooks/event-types/).

## Cycle de vie

La plupart des e-mails suivent ce parcours :

1. **Création.** Un envoi par l’API crée l’e-mail avec le statut `accepted`, ou `scheduled` quand `scheduled_at` est dans le futur. Les envois SMTP commencent aussi à `accepted`. Les e-mails entrants sont créés avec le statut `received`, qui ne change jamais.
2. **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`, `rejected` ou `suppressed` sans l’envoyer.
3. **Livraison ou report.** La tentative de livraison réussit (`delivered`), échoue temporairement (`attempted`, puis nouvelle tentative) ou échoue définitivement (`bounced`).
4. **Engagement.** Si le suivi est activé, les ouvertures et les clics font passer un e-mail livré à `loaded`, puis à `clicked`.
5. **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](/fr/docs/suppressions/manage/) 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](/fr/docs/deliverability/sending-health/) 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](/fr/docs/deliverability/sending-health/). |
| Crédits insuffisants | « Workspace has not enough email credits to send this email. » | [Achetez des crédits](/fr/docs/billing/credits/) ou activez la [recharge automatique](/fr/docs/billing/auto-refill/). |
| 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](/fr/docs/logs/email-details/#spam-checks) 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](/fr/docs/api-reference/emails/retry/). 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](/fr/docs/workspaces/production-access/), 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](/fr/docs/api-reference/emails/retry/) |
| --- | --- | --- |
| 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](/fr/docs/data-retention/) | 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](/fr/docs/suppressions/manage/), sinon la relance est de nouveau bloquée.

## Voir aussi

  - [Détails d’un e-mail](/fr/docs/logs/email-details/)
  - [Rebonds et plaintes](/fr/docs/deliverability/bounces-and-complaints/)
  - [Relancer et transférer](/fr/docs/email-api/retry-and-forward/)
  - [Types d’événements webhook](/fr/docs/webhooks/event-types/)

---
Source: https://emailit.com/fr/docs/logs/email-statuses/