Como adicionar cabeçalho X-TAGS personalizado a e-mails de resumo para análise externa de e-mail (Netcore)?

emonunix · Setembro 10, 2025, 8:19pm

Olá a todos,

Sou um usuário auto-hospedado do Discourse e estou procurando uma maneira de adicionar um cabeçalho personalizado, especificamente X-TAGS, aos nossos e-mails de saída. O objetivo é integrar com nosso provedor de serviços de e-mail (Netcore Email API) para obter melhores análises e rastreamento. Queremos poder marcar certos tipos de e-mails, como o resumo semanal, para uma visão mais granular do nosso engajamento por e-mail.

Problema:

Preciso adicionar um cabeçalho como X-TAGS: Digest a todos os e-mails que são enviados como um resumo. Este cabeçalho é para rastreamento interno e será removido pelo provedor de e-mail antes da entrega, portanto, não será visível para o usuário final.

O que já explorei:

Configurações do Site: Procurei na página /admin/site_settings/category/email e encontrei a configuração email custom headers (cabeçalhos personalizados de e-mail). No entanto, parece adicionar um cabeçalho estático a todos os e-mails. Não tenho certeza se é possível torná-lo dinâmico ou aplicá-lo apenas a um tipo específico de e-mail (como o resumo).
Tópicos Existentes no Fórum: Pesquisei nos fóruns do Discourse Meta e encontrei algumas discussões sobre cabeçalhos personalizados, mas elas se concentram principalmente em adicionar tags de tópico à linha de assunto do e-mail ou para filtragem do lado do usuário (por exemplo, no Gmail), não para análises de e-mail externas. Não parece haver uma maneira direta e oficialmente documentada de fazer isso.

Minhas perguntas são:

Existe um método integrado ou uma configuração de site específica que estou ignorando que me permitiria adicionar um cabeçalho personalizado como X-TAGS especificamente para e-mails de resumo?
Se não, este é um recurso que poderia ser realizado com um plugin personalizado?
Modificar o código principal seria a única solução e, em caso afirmativo, você poderia me indicar a direção certa (por exemplo, quais arquivos olhar)?

Qualquer orientação ou sugestão seria muito apreciada. Agradeço antecipadamente pela sua ajuda!

selase · Setembro 12, 2025, 2:31pm

Não, isso não é suportado nativamente, além da configuração do site email custom headers que se aplica globalmente a todos os e-mails de saída.

Sim, um plugin personalizado seria a melhor abordagem aqui.

O fluxo atual para e-mails de resumo é o seguinte:

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

Um plugin poderia se conectar ao processo de construção da mensagem (Email::MessageBuilder) e injetar (preferencialmente através de um modificador) seu cabeçalho personalizado condicionalmente, apenas para resumos.

Tópico		Respostas	Visualizações
Customs email headers and/or subjects tags Feature	7	2718	8 de Janeiro de 2022
Add headers to all outgoing emails Installation	2	789	23 de Outubro de 2020
Adding custom content to summary emails Documentation email	14	5663	6 de Junho de 2023
How to show tags in the digest email? Support activity-summary	0	336	23 de Junho de 2021
Email: mail headers should have tags in them Feature	2	842	16 de Agosto de 2014

Como adicionar cabeçalho X-TAGS personalizado a e-mails de resumo para análise externa de e-mail (Netcore)?

Tópicos relacionados