Cómo agregar encabezado X-TAGS personalizado a correos electrónicos de resumen para análisis de correo electrónico externo (Netcore)

emonunix · 10 Septiembre, 2025 20:19

Hola a todos,

Soy un usuario de Discourse autoalojado y estoy buscando una manera de agregar una cabecera personalizada, específicamente X-TAGS, a nuestros correos electrónicos salientes. El objetivo es integrarnos con nuestro proveedor de servicios de correo electrónico (Netcore Email API) para obtener mejores análisis y seguimiento. Queremos poder etiquetar ciertos tipos de correos electrónicos, como el resumen semanal, para una visión más granular de nuestra interacción por correo electrónico.

Problema:

Necesito agregar una cabecera como X-TAGS: Digest a todos los correos electrónicos que se envían como resumen. Esta cabecera es para seguimiento interno y será eliminada por el proveedor de correo electrónico antes de la entrega, por lo que no será visible para el usuario final.

Lo que ya he explorado:

Configuración del sitio: He revisado la página /admin/site_settings/category/email y encontré la configuración email custom headers (cabeceras personalizadas de correo electrónico). Sin embargo, parece que agrega una cabecera estática a todos los correos electrónicos. No estoy seguro si es posible hacerla dinámica o aplicarla solo a un tipo específico de correo electrónico (como el resumen).
Temas existentes del foro: He buscado en los foros de Discourse Meta y he encontrado algunas discusiones sobre cabeceras personalizadas, pero la mayoría se centran en agregar etiquetas de temas a la línea de asunto del correo electrónico o para filtrado del lado del usuario (por ejemplo, en Gmail), no para análisis de correo electrónico externo. No parece haber una forma sencilla y documentada oficialmente de hacer esto.

Mis preguntas son:

¿Existe un método incorporado o una configuración de sitio específica que esté pasando por alto y que me permita agregar una cabecera personalizada como X-TAGS específicamente a los correos electrónicos de resumen?
Si no es así, ¿es esta una característica que se podría lograr con un plugin personalizado?
¿Sería la modificación del código principal la única solución y, en caso afirmativo, podrían indicarme la dirección correcta (por ejemplo, qué archivos debo revisar)?

Cualquier orientación o sugerencia sería muy apreciada. ¡Gracias de antemano por su ayuda!

selase · 12 Septiembre, 2025 14:31

No, esto no es compatible de forma nativa, aparte de la configuración del sitio email custom headers que se aplica globalmente a todos los correos electrónicos salientes.

Sí, un plugin personalizado sería el mejor enfoque aquí.

El flujo actual para los correos electrónicos de resumen es el siguiente:

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 podría engancharse al proceso de construcción del mensaje (Email::MessageBuilder) e inyectar (preferiblemente a través de un modificador) su cabecera personalizada condicionalmente, solo para los resúmenes.

Tema		Respuestas	Vistas
Customs email headers and/or subjects tags Feature	7	2718	8 Enero 2022
Add headers to all outgoing emails Installation	2	789	23 Octubre 2020
Adding custom content to summary emails Documentation email	14	5661	6 Junio 2023
How to show tags in the digest email? Support activity-summary	0	336	23 Junio 2021
Email: mail headers should have tags in them Feature	2	842	16 Agosto 2014

Cómo agregar encabezado X-TAGS personalizado a correos electrónicos de resumen para análisis de correo electrónico externo (Netcore)

Temas relacionados