Ceci est un guide #explication expliquant comment les administrateurs peuvent résoudre les problèmes d’envoi d’e-mails depuis un site Discourse.
Niveau utilisateur requis : Administrateur
Discourse repose fortement sur les e-mails pour les notifications aux utilisateurs et les tâches de gestion de compte. Si les utilisateurs ne peuvent pas recevoir d’e-mails de votre site Discourse, cela peut entraîner divers problèmes, notamment des notifications manquées et des difficultés de gestion de compte.
Résumé
Dans cette documentation, vous apprendrez :
- Comment consulter les journaux d’e-mails envoyés
- Comment investiguer les e-mails ignorés et rebondis
- Les étapes de dépannage courantes pour les problèmes de délivrabilité des e-mails
- Les paramètres clés et où les trouver
Vérification des e-mails envoyés
Le premier endroit à vérifier lors du dépannage des problèmes d’e-mail est la page Admin → E-mails → Envoyés de votre site (située à .../admin/email/sent). La page E-mails → Envoyés dans Discourse est une ressource précieuse pour les administrateurs afin de surveiller et de dépanner la fonctionnalité d’e-mail de leur forum. Cette page fournit un journal détaillé de tous les e-mails qui ont été envoyés avec succès depuis votre instance Discourse.
Voici toutes les informations que vous pouvez trouver sur les e-mails envoyés sur cette page :
- Envoyé à : Il y a combien de temps l’e-mail a été envoyé.
- Utilisateur : L’utilisateur qui a reçu l’e-mail.
- Adresse destinataire : L’adresse e-mail du destinataire.
- Type d’e-mail : Le type d’e-mail envoyé. Il peut s’agir d’un résumé, d’une liste de diffusion, d’un message publié par un utilisateur, d’un message privé, etc.
- Clé de réponse : Un identifiant unique pour chaque e-mail envoyé. Cette clé garantit que lorsqu’un utilisateur répond à un e-mail de notification, Discourse peut correctement associer la réponse au message et à l’utilisateur appropriés, permettant ainsi aux utilisateurs de participer aux discussions du forum directement depuis leur e-mail.
- Message : L’ID du message à partir duquel l’e-mail a été généré. Cliquer sur cet ID vous mènera au message réel dans le forum.
- Détails SMTP : Ce champ indique la réponse reçue du serveur SMTP après la tentative d’envoi de l’e-mail. Une réponse
250 2.0.0signifie que l’e-mail a été accepté pour livraison par le premier serveur de messagerie (le relais sortant).
Si un utilisateur signale ne pas avoir reçu d’e-mail de Discourse, et que Discourse affiche un message
250 2.0.0 Ok: queued as ...sous sesDétails du message & SMTP, vous devriez demander à cet utilisateur de vérifier à nouveau sa boîte de réception, ainsi que son dossier de spam, pour voir s’il a peut-être manqué les e-mails. Ce statut indique que l’e-mail a été accepté par le premier serveur de messagerie, mais cela ne garantit pas la livraison dans la boîte de réception finale. L’e-mail peut encore être filtré, retardé ou rejeté par des serveurs ultérieurs.Vous pouvez également recommander à l’utilisateur de contacter l’équipe de support ou le département informatique qui gère son serveur de messagerie pour voir s’ils sont au courant de ce qui pourrait arriver à l’e-mail après qu’il ait été signalé comme mis en file d’attente. Si vous avez accès aux journaux de votre serveur de messagerie sortant (ou si vous êtes sur une infrastructure hébergée par Discourse), vous pouvez utiliser l’ID de file d’attente affiché dans les détails SMTP pour retracer le parcours de l’e-mail à travers la chaîne de livraison.
Si un e-mail n’apparaît pas sur la page E-mails → Envoyés de Discourse, cela signifie que l’e-mail n’a pas été envoyé avec succès depuis votre instance Discourse.
Examinons quelques-unes des autres pages que nous pouvons utiliser pour le dépannage des e-mails.
Investigation des e-mails ignorés
Située sur la page .../admin/email/skipped de votre site, la page E-mails ignorés répertorie tous les e-mails que Discourse a décidé de ne pas envoyer pour diverses raisons. Chaque e-mail ignoré aura une Raison de l'ignorance listée à côté, fournissant un aperçu de la raison pour laquelle l’e-mail n’a pas été envoyé.
Les informations suivantes sont disponibles sur cette page concernant les e-mails ignorés :
- Heure : La date et l’heure où l’e-mail aurait dû être envoyé et a été ignoré.
- Utilisateur : L’utilisateur qui aurait dû recevoir l’e-mail.
- Adresse destinataire : L’adresse e-mail du destinataire.
- Type d’e-mail : Le type d’e-mail ignoré, tel que
résumé,liste de diffusion,message publié par un utilisateur,message privé, etc. - Raison de l’ignorance : La raison pour laquelle l’e-mail a été ignoré. Les raisons courantes incluent le fait que l’utilisateur est actif sur le site, que l’utilisateur a déjà lu un message, ou que l’utilisateur a dépassé le seuil de score de rebond.
Exceeded bounce_score_threshold(Seuil de score de rebond dépassé) ?
Dans Discourse, chaque fois qu’un e-mail envoyé à l’adresse e-mail d’un utilisateur rebondit, le « score de rebond » de l’utilisateur augmente. Le « score de rebond » est une mesure du nombre de tentatives de livraison échouées pour les e-mails envoyés à une adresse spécifique.
Le message Exceeded bounce_score_threshold dans Discourse fait référence à la situation où le « score de rebond » d’un utilisateur dépasse une certaine limite, et c’est l’une des raisons les plus courantes pour lesquelles vous devriez dépanner l’envoi d’e-mails depuis Discourse.
Un e-mail rebondi est un e-mail qui n’a pas pu être livré au destinataire et qui est renvoyé à l’expéditeur. Cela peut se produire pour diverses raisons, et lorsque cela arrive, le système de messagerie de l’expéditeur reçoit une notification concernant le problème de livraison.
Il existe deux types de rebonds d’e-mails :
- Rebond dur : Il s’agit d’un échec permanent de la livraison. Cela se produit généralement lorsque l’adresse e-mail du destinataire est invalide ou n’est plus utilisée. D’autres raisons pourraient être que le nom de domaine n’existe pas ou que le serveur de messagerie du destinataire a complètement bloqué la livraison.
- Rebond mou : Il s’agit d’un problème de livraison temporaire. Cela pourrait être dû à la boîte de réception du destinataire pleine, au serveur de messagerie temporairement hors service ou surchargé, ou au message e-mail étant trop volumineux.
bounce_score_threshold(seuil de score de rebond) ?
Oui ! Voir : Paramètres du site pour le score de rebond.
Cependant, il est important de s’assurer que tous les problèmes sous-jacents liés à la délivrabilité des e-mails sont entièrement résolus avant d’ajuster les paramètres du score de rebond.
Compte tenu de cela, discutons de certaines des autres informations que nous pouvons voir concernant les e-mails rebondis dans Discourse.
Dépannage des e-mails rebondis
La page des e-mails rebondis est située à .../admin/email/bounced et fournit un aperçu détaillé de tous les e-mails rebondis. Voici ce que vous pouvez voir sur cette page concernant les e-mails rebondis :
- Heure : La date et l’heure où l’e-mail a rebondi.
- Utilisateur : L’utilisateur qui aurait dû recevoir l’e-mail.
- Adresse destinataire : L’adresse e-mail du destinataire.
- Type d’e-mail : Le type d’e-mail qui a été ignoré. Il peut s’agir d’un résumé, d’une liste de diffusion, d’un message publié par un utilisateur, d’un message privé, etc.
Sur la page Rebondis, vous pouvez cliquer sur l’icône (i) pour afficher des détails supplémentaires sur un e-mail rebondi :
La fenêtre Détails de l'e-mail entrant contiendra des informations détaillées sur l’e-mail rebondi, et généralement la section Corps fournira une explication de la raison pour laquelle l’e-mail a rebondi.
Voici quelques raisons pour lesquelles un e-mail de Discourse pourrait rebondir :
- Adresse e-mail invalide : Si l’adresse e-mail du destinataire est invalide, inexistante ou a été supprimée, l’e-mail rebondira.
- Boîte de réception pleine : Si la boîte de réception du destinataire est pleine et ne peut pas accepter de nouveaux messages, l’e-mail rebondira.
- Problèmes de serveur : Si le serveur de messagerie du destinataire est hors service ou temporairement indisponible, l’e-mail rebondira. Il s’agit généralement d’un problème temporaire.
- Expéditeur bloqué : Le serveur de messagerie du destinataire peut avoir bloqué votre adresse e-mail Discourse, ou peut n’accepter que les e-mails entrants provenant de domaines spécifiques, généralement en raison de politiques de sécurité e-mail.
- Filtres anti-spam agressifs : Si le contenu de l’e-mail est signalé comme spam par le serveur de messagerie du destinataire, l’e-mail peut rebondir.
- Réponse automatique : Certains systèmes de réponse automatique (comme les réponses « absent du bureau ») peuvent provoquer un rebond mou.
Dans cette situation, la meilleure option est de demander à l’utilisateur dont les e-mails rebondissent de contacter son fournisseur de services de messagerie. Le fournisseur de services de messagerie peut être en mesure de fournir des informations spécifiques sur la raison pour laquelle les e-mails sont bloqués, rejetés, etc., et peut être en mesure d’ajuster les paramètres de sécurité ou d’ajouter le service de messagerie Discourse à la liste blanche. Ils peuvent également être au courant de la maintenance en cours du serveur de messagerie ou d’autres problèmes qui pourraient causer des rebonds d’e-mails.
Si l’utilisateur a le contrôle de ses services de messagerie et utilise Microsoft Hosted Exchange ou Google Workspace, nous avons également des procédures pour Contourner le spam pour les e-mails de votre site hébergé par CDCK dans Microsoft Hosted Exchange et Contourner le spam pour les e-mails de votre site hébergé par Discourse dans Google Workspace.
Vous devrez soit Réinitialiser le score de rebond de l’utilisateur, soit, si le problème affectait plusieurs utilisateurs, vous pouvez Réinitialiser en masse les scores de rebond pour tous les utilisateurs. Une fois les scores de rebond réinitialisés, Discourse reprendra les tentatives de livraison d’e-mails aux utilisateurs qui dépassaient leur bounce_score_threshold.
Étapes supplémentaires
La configuration et le dépannage des e-mails peuvent être complexes en raison des nombreuses variables impliquées. Au-delà de l’examen de la section Admin → E-mails de votre site pour dépanner les e-mails, vous voudrez peut-être également consulter notre Liste de contrôle de configuration de la livraison des e-mails si vous avez toujours du mal à déterminer pourquoi les e-mails ne sont pas livrés correctement depuis votre site Discourse.
Si votre site Discourse a été configuré récemment, nous avons également un guide sur Dépannage des e-mails sur une nouvelle installation de Discourse (installations auto-hébergées uniquement).
Enfin, vous pouvez consulter la page des journaux Discourse en naviguant vers Admin > Journaux (.../logs/) et en recherchant toutes les erreurs que vous pourriez voir liées à la délivrabilité des e-mails.
