外部メール分析（Netcore）用のダイジェストメールにカスタムX-TAGSヘッダーを追加する方法

emonunix · 2025 年 9 月 10 日午後 8:19

こんにちは皆さん、

私はセルフホスト型のDiscourseユーザーで、送信するメールにカスタムヘッダー、具体的にはX-TAGSを追加する方法を探しています。目的は、より詳細な分析と追跡のために、メールサービスプロバイダー（Netcore Email API）と統合することです。例えば、週次ダイジェストのような特定の種類のメールにタグを付け、メールエンゲージメントをより詳細に把握したいと考えています。

問題点:

週次ダイジェストとして送信されるすべてのメールに、X-TAGS: Digestのようなヘッダーを追加する必要があります。このヘッダーは内部追跡用であり、メールプロバイダーによって配信前に削除されるため、エンドユーザーには表示されません。

すでに調査したこと:

サイト設定: /admin/site_settings/category/emailページを確認し、email custom headers設定を見つけました。しかし、これはすべてのメールに静的なヘッダーを追加するようです。これを動的にしたり、特定の種類のメール（ダイジェストなど）にのみ適用したりできるかどうかは不明です。
既存のフォーラムトピック: Discourse Metaフォーラムでカスタムヘッダーに関するいくつかの議論を検索しましたが、ほとんどはメール件名にトピックタグを追加することや、ユーザー側のフィルタリング（Gmailなど）に焦点を当てており、外部メール分析のためのものではありませんでした。これを行うための、公式に文書化された簡単な方法はないようです。

私の質問は以下の通りです:

ダイジェストメールにのみX-TAGSのようなカスタムヘッダーを追加できる、組み込みの方法や特定のサイト設定を見落としていますか？
もしそうでない場合、カスタムプラグインで実現できる機能でしょうか？
コアコードの変更が唯一の解決策でしょうか？もしそうであれば、どちらのファイルを確認すればよいかなど、方向性を示していただけますか？

どのようなガイダンスや提案でも大歓迎です。ご協力ありがとうございます！

selase · 2025 年 9 月 12 日午後 2:31

いいえ、これは標準ではサポートされていません。すべての送信済みメールにグローバルに適用される email custom headers サイト設定を除いては。

はい、カスタムプラグインが最適なアプローチになります。

ダイジェストメールの現在のフローは次のとおりです。

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

プラグインは、メッセージ構築プロセス（Email::MessageBuilder）にフックして、ダイジェストの場合にのみ、カスタムヘッダーを条件付きで（できればモディファイア経由で）挿入できます。

トピック		返信	表示
Customs email headers and/or subjects tags Feature	7	2718	2022 年 1 月 8 日
Add headers to all outgoing emails Installation	2	789	2020 年 10 月 23 日
Adding custom content to summary emails Documentation email	14	5663	2023 年 6 月 6 日
How to show tags in the digest email? Support activity-summary	0	336	2021 年 6 月 23 日
Email: mail headers should have tags in them Feature	2	842	2014 年 8 月 16 日

外部メール分析（Netcore）用のダイジェストメールにカスタムX-TAGSヘッダーを追加する方法

関連トピック