Atelier de diagnostic de livraison

Votre e-mail de test n’est pas arrivé ? Identifiez d’abord où il s’est arrêté

Ne renvoyez pas le message en boucle. Vérifiez d’abord l’adresse, puis la tâche d’envoi et la réponse du service, avant d’examiner la relève et l’affichage du contenu.

Commencer le diagnostic

En attente de vos choix

Commencez par remplir les quatre éléments à gauche

La conclusion indique la première couche à vérifier et les preuves à rechercher ensuite. Elle ne prétend pas lire directement votre système d’envoi.

Copiez l’adresse de réception complète utilisée pour ce test.
Conservez l’heure d’envoi, l’identifiant du message et le code de réponse.
Notez si l’objet, le HTML et le texte brut sont visibles.

Chaîne de preuves en cinq couches

Progressez des vérifications les plus simples vers les suivantes

Chaque couche doit fournir une preuve observable avant de passer à la suivante. Vous éviterez ainsi de prendre un problème d’adresse pour un problème de modèle.

Couche adresse

Recopiez l’adresse depuis la page actuelle et vérifiez que tout est complet avant et après le @, et que la boîte temporaire est toujours active. Après un changement d’adresse, l’ancien jeton et l’ancienne adresse ne doivent plus servir de cible de test.

Preuve : adresse complète et date d’expiration

Couche tâche

Vérifiez que l’action métier a bien déclenché une tâche d’envoi, au lieu de simplement placer un élément dans la file d’attente. Contrôlez les variables d’environnement, le consommateur de file, le modèle choisi et le paramètre du destinataire.

Preuve : identifiant de tâche et journaux d’exécution

Couche livraison

Consultez la réponse renvoyée par SMTP ou par le fournisseur d’e-mails. Une acceptation signifie seulement que l’étape suivante a reçu le message, pas qu’il est arrivé dans la boîte de réception ; un code de refus fournit généralement une piste.

Preuve : identifiant du message et code de réponse

Couche lecture

Attendez un cycle de relève, puis actualisez manuellement. Si d’autres e-mails de la même boîte apparaissent, le problème vient plus probablement de ce message ou de la livraison en amont que de la connexion à la page.

Preuve : heure d’actualisation et nombre d’e-mails

Couche contenu

Si l’objet apparaît dans la liste mais que le détail est vide, vérifiez séparément html_body et text_body. Une erreur de modèle HTML, une ressource distante trop volumineuse ou un script dangereux ne signifie pas que l’e-mail n’est pas arrivé.

Preuve : champs d’origine de l’objet, de l’expéditeur et du contenu

Diagnostic rapide

Selon le symptôme, les vérifications prioritaires changent

Symptôme	À vérifier d’abord	À vérifier ensuite
Aucun e-mail n’arrive	Validité de l’adresse et tâche d’envoi	Réponse du fournisseur, DNS et limitation de débit
Un seul modèle n’arrive pas	Tâche du modèle et paramètres du destinataire	Politique de contenu et taille des pièces jointes
Les messages sont listés, mais le détail est vide	Champs HTML et texte brut	Syntaxe du modèle et isolation de la lecture
Retard manifeste de réception	Attente dans la file et événements du fournisseur	Relève de la boîte et état du réseau

Reproduction minimale

Réduisez votre flux complexe à un e-mail comparable

Envoyez à une nouvelle adresse un message avec un objet fixe, une phrase en texte brut et un identifiant d’événement unique. S’il arrive, réintroduisez progressivement le HTML, les images, les pièces jointes et les variables métier.

Informations à consigner

Environnement de test et version déployée

Par exemple : staging / commit hash

Heure du déclenchement et identifiant du message

Utilisez toujours UTC ou indiquez le fuseau horaire

Adresse, objet et résultat

Masquez les jetons et ne collez pas de code de vérification dans un ticket

Revenir au test réel de réception

Créez une adresse propre et effectuez une reproduction minimale

Conservez les preuves de cet envoi, puis utilisez la boîte temporaire pour vérifier l’objet, l’heure et le contenu.

Ouvrir l’e-mail temporaire