Comment ajouter un en-tête X-TAGS personnalisé aux e-mails récapitulatifs pour l'analyse d'e-mails externes (Netcore) ?

emonunix · Septembre 10, 2025, 8:19

Bonjour à tous,

Je suis un utilisateur de Discourse auto-hébergé et je cherche un moyen d’ajouter un en-tête personnalisé, spécifiquement X-TAGS, à nos e-mails sortants. L’objectif est de nous intégrer à notre fournisseur de services d’e-mail (Netcore Email API) pour une meilleure analyse et un meilleur suivi. Nous voulons pouvoir étiqueter certains types d’e-mails, comme le résumé hebdomadaire, pour une vue plus granulaire de notre engagement par e-mail.

Problème :

Je dois ajouter un en-tête comme X-TAGS: Digest à tous les e-mails envoyés sous forme de résumé. Cet en-tête est destiné au suivi interne et sera supprimé par le fournisseur de messagerie avant la livraison, il ne sera donc pas visible par l’utilisateur final.

Ce que j’ai déjà exploré :

Paramètres du site : J’ai parcouru la page /admin/site_settings/category/email et j’ai trouvé le paramètre email custom headers (en-têtes personnalisés des e-mails). Cependant, il semble ajouter un en-tête statique à tous les e-mails. Je ne suis pas sûr s’il est possible de le rendre dynamique ou de l’appliquer uniquement à un type d’e-mail spécifique (comme le résumé).
Sujets de forum existants : J’ai recherché sur les forums Discourse Meta et j’ai trouvé quelques discussions sur les en-têtes personnalisés, mais elles se concentrent principalement sur l’ajout de balises de sujet à la ligne d’objet de l’e-mail ou pour le filtrage côté utilisateur (par exemple, dans Gmail), pas pour l’analyse des e-mails externes. Il ne semble pas y avoir de moyen simple et officiellement documenté pour y parvenir.

Mes questions sont :

Existe-t-il une méthode intégrée ou un paramètre de site spécifique que j’ai négligé et qui me permettrait d’ajouter un en-tête personnalisé comme X-TAGS spécifiquement aux e-mails de résumé ?
Sinon, est-ce une fonctionnalité qui pourrait être réalisée avec un plugin personnalisé ?
La modification du code source serait-elle la seule solution, et si oui, pourriez-vous m’indiquer la bonne direction (par exemple, quels fichiers regarder) ?

Toute aide ou suggestion serait grandement appréciée. Merci d’avance pour votre aide !

selase · Septembre 12, 2025, 2:31

Non, ce n’est pas pris en charge nativement, en dehors du paramètre de site en-têtes personnalisés des e-mails qui s’applique globalement à tous les e-mails sortants.

Oui, un plugin personnalisé serait la meilleure approche ici.

Le flux actuel pour les e-mails de résumé est le suivant :

github.com/discourse/discourse

app/jobs/scheduled/enqueue_digest_emails.rb

d82fcb8af


      
          def execute(args)
            return if SiteSetting.disable_emails == "yes"
            return if SiteSetting.disable_digest_emails?
            return if SiteSetting.private_email?
          
            target_user_ids.each do |user_id|
              ::Jobs.enqueue(:user_email, type: "digest", user_id: user_id)
            end
          end

github.com/discourse/discourse

app/jobs/regular/user_email.rb

d82fcb8af

# frozen_string_literal: true

module Jobs
  # Asynchronously send an email to a user
  class UserEmail < ::Jobs::Base
    include Skippable

    sidekiq_options queue: "low"

    sidekiq_retry_in do |count, exception|
      # retry in an hour when SMTP server is busy
      # or use default sidekiq retry formula. returning
      # nil/0 will trigger the default sidekiq
      # retry formula
      #
      # See https://github.com/mperham/sidekiq/blob/3330df0ee37cfd3e0cd3ef01e3e66b584b99d488/lib/sidekiq/job_retry.rb#L216-L234
      case exception.wrapped
      when Net::SMTPServerBusy
        return 1.hour + (rand(30) * (count + 1))
      end

This file has been truncated. show original

github.com/discourse/discourse

app/mailers/user_notifications.rb

d82fcb8af


      
          def digest(user, opts = {})
            build_summary_for(user)
            @unsubscribe_key = UnsubscribeKey.create_key_for(@user, UnsubscribeKey::DIGEST_TYPE)
          
            @since = opts[:since].presence
            @since ||= [user.last_seen_at, user.user_stat&.digest_attempted_at, 1.month.ago].compact.max
          
            # Fetch some topics and posts to show
            digest_opts = {
              limit: SiteSetting.digest_topics + SiteSetting.digest_other_topics,
              top_order: true,
            }
            topics_for_digest = Topic.for_digest(user, @since, digest_opts)
            if topics_for_digest.empty? && !user.user_option.try(:include_tl0_in_digests)
              # Find some topics from new users that are at least 24 hours old
              topics_for_digest =
                Topic.for_digest(user, @since, digest_opts.merge(include_tl0: true)).where(
                  "topics.created_at < ?",
                  24.hours.ago,
                )

This file has been truncated. show original

github.com/discourse/discourse

lib/email/build_email_helper.rb

d82fcb8af

# frozen_string_literal: true

module Email
  module BuildEmailHelper
    def build_email(*builder_args)
      builder = Email::MessageBuilder.new(*builder_args)
      headers(builder.header_args) if builder.header_args.present?
      mail(builder.build_args).tap do |message|
        if message && h = builder.html_part
          message.html_part = h
        end
      end
    end
  end
end

github.com/discourse/discourse

lib/email/message_builder.rb

d82fcb8af

# frozen_string_literal: true

# Builds a Mail::Message we can use for sending. Optionally supports using a template
# for the body and subject
module Email
  class MessageBuilder
    attr_reader :template_args, :reply_by_email_key

    ALLOW_REPLY_BY_EMAIL_HEADER = "X-Discourse-Allow-Reply-By-Email"
    INSTRUCTIONS_SEPARATOR = "---\n"

    def initialize(to, opts = nil)
      @to = to
      @opts = opts || {}
      @template_args = {
        site_name: SiteSetting.title,
        email_prefix: SiteSetting.email_prefix.presence || SiteSetting.title,
        base_url: Discourse.base_url,
        user_preferences_url: "#{Discourse.base_url}/my/preferences",
        hostname: Discourse.current_hostname,

This file has been truncated. show original

Un plugin pourrait s’accrocher au processus de construction du message (Email::MessageBuilder) et injecter (de préférence via un modificateur) votre en-tête personnalisé conditionnellement, uniquement pour les résumés.

Sujet		Réponses	Vues
Customs email headers and/or subjects tags Feature	7	2718	Janvier 8, 2022
Add headers to all outgoing emails Installation	2	789	Octobre 23, 2020
Adding custom content to summary emails Documentation email	14	5657	Juin 6, 2023
How to show tags in the digest email? Support activity-summary	0	336	Juin 23, 2021
Email: mail headers should have tags in them Feature	2	842	Août 16, 2014

Comment ajouter un en-tête X-TAGS personnalisé aux e-mails récapitulatifs pour l'analyse d'e-mails externes (Netcore) ?

Sujets connexes