Suppression des adresses e-mail
Le canal e-mail de l'API Messages API de Vonage intègre une fonctionnalité de suppression automatique activée par défaut pour tous les clients. La suppression garantit que les adresses e-mail identifiées comme non valides ou susceptibles de faire l'objet de réclamations sont ajoutées à la liste de suppression et ne feront plus jamais l'objet d'envois. Toute livraison bloquée est signalée comme un événement de livraison rejeté avec le code d'erreur 2003, ce qui vous permet de préserver votre réputation d'expéditeur et de fournir des informations précises sur l'état d'avancement de chaque envoi à chaque destinataire.
Pourquoi la suppression est-elle importante ?
L'envoi d'e-mails à des adresses invalides ou susceptibles de faire l'objet de plaintes nuit à votre réputation d'expéditeur auprès des FAI et des fournisseurs de messagerie. Une réputation dégradée entraîne le marquage des e-mails légitimes comme spam ou leur blocage pur et simple.
La fonctionnalité de suppression offre une protection contre ce risque en :
- Empêcher les tentatives d'envoi vers des adresses connues pour être malveillantes avant qu'elles n'atteignent les FAI.
- Enregistrement automatique des nouvelles adresses erronées à mesure qu'elles sont détectées grâce aux retours d'information sur les livraisons.
- Veiller à ce que vous continuiez à recevoir des informations précises sur le statut de livraison pour les destinataires dont l'adresse a été masquée, plutôt que d'être confronté à un échec silencieux.
Comment fonctionne la suppression ?
La suppression fonctionne dans deux sens : d'une part, elle vérifie les suppressions existantes avant l'envoi, et d'autre part, elle ajoute de nouvelles adresses à la liste de suppression en fonction des retours d'expédition.
Vérification de la suppression avant l'envoi
À chaque fois qu'une demande d'envoi d'e-mail est reçue, tous les destinataires (À, CC et Cci) sont vérifiés par rapport à la liste de suppression avant que l'e-mail ne soit transmis au fournisseur. Ce processus s'effectue automatiquement, sans nécessiter aucune configuration de l'Account.
Il existe trois issues possibles :
Scénario A — Aucun destinataire n'est exclu
Tous les destinataires sont bien indiqués. L'e-mail est envoyé normalement et vous recevez un identifiant de message du fournisseur confirmant son envoi.
Scénario B — Certains destinataires sont exclus (exclusion partielle)
Un ou plusieurs destinataires figurent sur la liste d'exclusion, mais au moins l'un d'entre eux n'y figure pas.
- Les destinataires masqués sont exclus de la distribution.
- L'e-mail est envoyé aux destinataires actifs restants.
- Un événement de suppression est publié pour chaque destinataire bloqué — refusé avec le code d'erreur 2003 — vous pouvez ainsi consulter le statut de livraison exact pour chaque destinataire, y compris ceux qui n'ont pas reçu le message.
- Vous recevez le même identifiant de message du fournisseur, qui couvre à la fois les destinataires auxquels le message a été envoyé et ceux pour lesquels l'envoi a été supprimé.
Scénario C — Tous les destinataires sont exclus
Tous les destinataires des champs « À », « Cc » et « Cci » figurent sur la liste de suppression.
- L'e-mail n'a pas été envoyé.
- Un événement de suppression est publié pour chaque destinataire — refusé avec le code d'erreur 2003.
- Vous recevez un identifiant de message valide, impossible à distinguer d'un envoi réel, ce qui permet à vos systèmes de suivre le message normalement.
Ajout d'adresses à la liste d'exclusion
Le fournisseur de messagerie renvoie les événements liés à la livraison (messages non remis et plaintes) au moteur de messagerie de Vonage. Ces événements sont traités afin de maintenir la liste de suppression à jour.
Le type de liste de suppression auquel une adresse est ajoutée dépend de l'événement reçu :
| Type d'événement | Champ d'application de la suppression | Ajouté à la liste de suppression |
|---|---|---|
| Rebond définitif | Mondial | Oui |
| Plainte / Signalement de spam | Par Account + identité | Oui |
| Autres signalements (détection de virus, corrections de faux positifs, échecs DKIM) | N/A | Non |
Référence sur les types de suppression
Le tableau ci-dessous établit une correspondance entre les événements de retour d'information sur la livraison des fournisseurs et les codes d'erreur de la Messages API, et indique si l'événement entraîne une suppression.
| Type de rebond | Code de motif Vonage | Description | Statut | Code d'erreur | Ajouté à la liste de suppression |
|---|---|---|---|---|---|
| Rebond définitif | RECIPIENT_BLOCKED |
Cette adresse figure sur la liste noire de la plateforme. | Rejeté | 2003 | Oui (au niveau mondial) |
| Rebond définitif | RECIPIENT_MISSING |
L'adresse e-mail n'existe pas | Rejeté | 1170 | Oui (au niveau mondial) |
| Rebond définitif | ACCOUNT_BLOCKED |
Cette adresse figure sur la liste de blocage de cet Account. | Rejeté | 2003 | Oui (au niveau mondial) |
| Réflexion douce | MAILBOX_FULL |
La boîte aux lettres du destinataire est temporairement pleine | Rejeté | 1180 | Non |
| Réflexion douce | CONTENT_TOO_LARGE |
Le message était trop volumineux pour être transmis | Rejeté | 2002 | Non |
| Réflexion douce | ATTACHMENT_REJECTED |
La pièce jointe a été rejetée par le serveur destinataire | Rejeté | 1382 | Non |
| Réflexion douce | GATEWAY_TIMEOUT |
La transmission a expiré en attendant la réponse du serveur destinataire | Rejeté | 1230 | Non |
| Réflexion douce | CONTENT_REJECTED |
Le contenu a été rejeté par le serveur destinataire | Rejeté | 1282 | Non |
| Rebond définitif | UNKNOWN |
Rebond non classé | Rejeté | 1330 | Oui (au niveau mondial) |
| Plainte | USER_SPAM_REPORT |
Le destinataire a classé l'e-mail comme spam | Non envoyé | N/A | Oui (par Account et par identité) |
| Plainte | OTHER_FEEDBACK |
Commentaires généraux sur les réclamations | Rejeté | - | Oui (par Account et par identité) |
| Plainte | FRAUD_ALERT |
E-mail signalé comme pouvant constituer une fraude | Rejeté | 2001 | Non |
| Plainte | AUTH_FAILURE |
Problème lié à DKIM / à l'authentification des e-mails | Rejeté | 1484 | Non |
| Plainte | NOT_SPAM_CORRECTION |
Le destinataire a corrigé une erreur de classification d'un message indésirable | N/A | N/A | Non |
| Plainte | VIRUS_DETECTED |
E-mail signalé comme contenant un virus | Rejeté | 1282 | Non |
Remarque : Vonage envoie toujours les événements rejetés à votre webhook avec un code d'erreur 2003 pour chaque envoi d'e-mail supprimé.
Statut de livraison pour les destinataires exclus
Lorsqu'un destinataire est exclu, le moteur de messagerie génère un événement de rebond ou de réclamation synthétique qui reproduit le format d'un véritable événement émis par un fournisseur. Cela signifie que :
- Les systèmes en aval (par exemple, le connecteur de messagerie électronique et les webhooks) reçoivent une mise à jour d'état correctement formatée pour chaque destinataire, qu'un message lui ait été effectivement envoyé ou non.
- Vous pouvez suivre le parcours complet de chaque message sans avoir à appliquer de traitement particulier aux cas supprimés.