Come aggiungere un'intestazione X-TAGS personalizzata alle email di riepilogo per l'analisi delle email esterne (Netcore)?

emonunix · 10 Settembre 2025, 8:19pm

Ciao a tutti,

Sono un utente di Discourse self-hosted e sto cercando un modo per aggiungere un’intestazione personalizzata, in particolare X-TAGS, alle nostre email in uscita. L’obiettivo è integrare con il nostro provider di servizi email (Netcore Email API) per una migliore analisi e tracciamento. Vogliamo poter etichettare determinati tipi di email, come il riepilogo settimanale, per una visione più granulare del nostro coinvolgimento via email.

Problema:

Ho bisogno di aggiungere un’intestazione come X-TAGS: Digest a tutte le email inviate come riepilogo. Questa intestazione è per il tracciamento interno e verrà rimossa dal provider di posta elettronica prima della consegna, quindi non sarà visibile all’utente finale.

Cosa ho già esplorato:

Impostazioni del sito: Ho esaminato la pagina /admin/site_settings/category/email e ho trovato l’impostazione email custom headers. Tuttavia, sembra aggiungere un’intestazione statica a tutte le email. Non sono sicuro se sia possibile renderla dinamica o applicarla solo a un tipo specifico di email (come il riepilogo).
Argomenti del forum esistenti: Ho cercato nei forum di Discourse Meta e ho trovato alcune discussioni sulle intestazioni personalizzate, ma si concentrano principalmente sull’aggiunta di tag di argomento alla riga dell’oggetto dell’email o per il filtraggio lato utente (ad esempio, in Gmail), non per l’analisi delle email esterne. Non sembra esserci un modo semplice e ufficialmente documentato per farlo.

Le mie domande sono:

Esiste un metodo integrato o un’impostazione specifica del sito che sto trascurando che mi permetterebbe di aggiungere un’intestazione personalizzata come X-TAGS specificamente alle email di riepilogo?
In caso contrario, è una funzionalità che potrebbe essere realizzata con un plugin personalizzato?
La modifica del codice principale sarebbe l’unica soluzione e, in tal caso, potreste indicarmi la direzione giusta (ad esempio, quali file guardare)?

Qualsiasi guida o suggerimento sarebbe molto apprezzato. Grazie in anticipo per il vostro aiuto!

selase · 12 Settembre 2025, 2:31pm

No, questo non è supportato “out of the box”, a parte l’impostazione del sito email custom headers che si applica globalmente a tutte le email in uscita.

Sì, un plugin personalizzato sarebbe l’approccio migliore in questo caso.

Il flusso attuale per le email di riepilogo è il seguente:

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 potrebbe agganciarsi al processo di creazione del messaggio (Email::MessageBuilder) e iniettare (preferibilmente tramite un modificatore) la tua intestazione personalizzata in modo condizionale, solo per i riepiloghi.

Argomento		Risposte	Visualizzazioni
Customs email headers and/or subjects tags Feature	7	2716	Gennaio 8, 2022
Add headers to all outgoing emails Installation	2	788	Ottobre 23, 2020
How to show tags in the digest email? Support activity-summary	0	336	Giugno 23, 2021
Email: mail headers should have tags in them Feature	2	839	Agosto 16, 2014
Force topics into email digest via tags? Feature activity-summary	1	486	Luglio 20, 2021

Come aggiungere un'intestazione X-TAGS personalizzata alle email di riepilogo per l'analisi delle email esterne (Netcore)?

Argomenti correlati