YouTrack クラウド 2025.3 ヘルプ

メールボックス統合

メールボックス統合を使用すると、YouTrack とメールサーバー間の接続をセットアップできます。この接続が確立されたら、受信メールメッセージを YouTrack のチケット、課題、コメントに変換する追加の設定を構成できます。YouTrack のチケットおよび課題に投稿されたコメントは、元のメールメッセージへの返信としてメールサーバーを通じて配信されます。

設定と基本的な動作は、統合が有効になっている YouTrack プロジェクトのタイプによって異なります。

  • ヘルプデスクプロジェクトでは、メールチャネルで顧客のリクエストを処理するための基盤としてメールボックス統合が使用されます。このセットアップの詳細については、「メール」を参照してください。

  • 課題追跡の標準プロジェクトでは、統合により、接続されたメールサービス用に構成されたルールに従って、受信メッセージが課題とコメントに変換されます。これらのルールは、メールボックス統合設定で直接構成されます。この設定の詳細については、「メールボックスと標準の課題追跡プロジェクトの統合」を参照してください。

メールボックス統合を有効にする

YouTrack で受信メールメッセージを処理するには、まずメールボックス統合を有効にして構成する必要があります。

この手順には、次の手順が必要です。

  1. 接続されたメールボックスに対するシステム全体のポーリング頻度を設定します。

  2. メールサーバーの信頼できる証明書を YouTrack にインポートする

  3. メールサービスに接続します。

接続されたメールボックスのシステム全体のポーリング頻度を設定する

YouTrack は、スケジュールに従って、指定されたメールサービスからメールメッセージを取得します。デフォルトの間隔は 1 時間ごとです。スケジュールを事前定義された間隔に変更することも、cron 式を使用してカスタム間隔を指定することもできます。複数のメールサービスに対して個別にスケジュールを設定することはできません。同じスケジュールが、YouTrack サーバーと統合されているすべてのメールサービスに適用されます。

メールメッセージを取得する間隔を指定するには、次の手順を実行する

  1. メインナビゲーションメニューから、 管理> 統合> メールボックス統合を選択します。

  2. システム全体のポーリング頻度メニューから、事前設定された時間間隔を選択します。別の時間間隔を指定するには、カスタムを選択し、cron 式を入力します。例: 毎日、45 分ごとに新しいデータを取得するには、次の式を使用します。

    0 0/45 * * * ?
    Fetching interval

    IMAP メールボックスの場合、最短の間隔は 2 分です。

    cron 式を記述するための構文の詳細については、cron トリガーのチュートリアル(英語)を参照してください。

メールサーバーから信頼できる証明書をインポートする

メールサーバーでは、SSL を介した安全な接続の確立が必要になる場合があります。ホストされているサーバーを YouTrack に追加する前に、SSL 証明書をインポートする必要がある場合があります。

  • メールサーバーに既知の認証局（CA）によって署名された有効な証明書がある場合、公開鍵と証明書は Web ブラウザーにすでに保存されています。SSL 証明書をインポートせずにメールサーバーに接続できる必要があります。

  • メールサーバーの証明書が自己署名されている場合は、証明書と公開鍵をインポートして安全な接続を確立する必要があります。

YouTrack とメールサーバー間の安全な接続を有効にするには:

  1. メールサーバーの証明書と公開鍵を DER エンコードファイルとしてエクスポートします。これらのファイルは、.der、.cer、.crt 拡張子を使用します。

  2. メインナビゲーションメニューから、 管理> サーバー設定> SSL 証明書を選択します。

  3. 信頼できる証明書をインポートするボタンをクリックしてください。

  4. 信頼できる証明書をインポートするダイアログで、証明書の名前を入力します。

  5. ファイルの選択ボタンをクリックして、ローカルディレクトリから証明書ファイルを選択します。

    Import trusted certificate dialog

  6. インポートボタンをクリックしてください。

    • メールサーバーの証明書が YouTrack に追加されます。

メールサービスに接続する

統合を有効にするには、1 つ以上のメールサーバーに接続する必要があります。

  • YouTrack クラウドインスタンスの場合、組み込みのデフォルトのメールボックス構成を有効にできます。この構成は、YouTrack インスタンスに関連付けられた専用のメールアドレスに送信されたメッセージを処理します。

    デフォルトのメールボックス構成では、外部メールサーバーは必要ありません。また、設定は事前定義されているため、何も構成する必要はありません。

    詳細は、YouTrack クラウドを参照してください。

  • Gmail の場合、メールサービスへの接続に使用するアカウントには特別な要件があります。詳細については、Gmail を参照してください。

  • Microsoft Exchange Server および Microsoft Exchange Online (Office 365) メールボックスの場合、追加のセットアップが必要です。この統合と互換性があるようにメールサービスを構成するには、マイクロソフトエクスチェンジオンラインまたはマイクロソフトエクスチェンジサーバーの指示を読み、それに従ってください。

Gmail アカウントを使用して YouTrack 通知を送信するには、アプリケーション固有のパスワード（アプリパスワード）を生成して使用する必要があります。認証に使用する Google アカウントで二段階認証プロセスが有効になっている必要があります。このアカウントで Gmail サービスに接続するには、Google アカウントでアプリケーション固有のパスワードを生成してください。

  • ユーザー名には、Google アカウントのユーザー名を入力します。

  • パスワードの場合、Google で生成したアプリケーション固有のパスワードを入力します。

Google アカウントのアプリパスワードの詳細については、Gmail ヘルプ(英語)を参照してください。

Gmail メールボックスに接続するには:

  1. メインナビゲーションメニューから、 管理> 統合> メールボックス統合を選択します。

  2. メールボックス統合ページで、別のメールボックスに接続するリンクをクリックしてください。

    • サイドバーにメールボックス設定が表示されます。

    connect to a mail server

  3. 以下の設定に値を入力します。

    設定

    説明

    サーバータイプ

    接続に使用するプロトコルを選択します。YouTrack は IMAP および IMAPS 経由の Gmail との接続をサポートしています。

    ホスト

    メールサービスの URL を入力します。例: imap.gmail.com

    ポート

    メールサービスがリッスンするポートを入力します。メールサーバープロトコルを選択すると、デフォルトのポートが自動的に設定されます。

    ユーザー名

    メールサービスへのアクセスを許可するアカウントのユーザー名を入力します。

    パスワード

    Gmail サービスにログインするために使用するアカウントのアプリパスワードを入力します。

  4. 拡張設定セクションを展開して、以下のオプション設定を構成します。

    設定

    説明

    SSL キー

    Gmail との統合の場合、この設定は無視できます。Gmail サービスとの接続は、TLS を使用して自動的に認証されます。

    接続タイムアウト

    メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。

    ソケットタイムアウト

    ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。

  5. 接続のテストボタンをクリックして、構成を確認します。接続を確立できない場合は、設定を修正し、接続を再度テストします。

  6. サーバーの追加ボタンをクリックしてください。

    • メールボックス統合設定が保存されます。

次の手順を使用して、汎用メールサービスとの接続を構成します。

一般的なメールサービスに接続するには:

  1. メインナビゲーションメニューから、 管理> 統合> メールボックス統合を選択します。

  2. メールボックス統合ページで、別のメールボックスに接続するリンクをクリックしてください。

    • サイドバーにメールボックス設定が表示されます。

      connect to a mail server

  3. 以下の設定に値を入力します。

    設定

    説明

    サーバータイプ

    メールサーバーが使用するプロトコルを選択します。メールボックス統合は IMAP/IMAPS プロトコルをサポートしています。

    ホスト

    メールサービスの URL を入力します。例: mail.server.com

    ポート

    メールサービスがリッスンするポートを入力します。メールサーバープロトコルを選択すると、デフォルトのポートが自動的に設定されます。

    ユーザー名

    メールサービスへのアクセスを許可するアカウントのユーザー名を入力します。

    パスワード

    メールサービスへのログインに使用するアカウントのパスワードを入力します。

  4. 拡張設定セクションを展開して、以下のオプション設定を構成します。

    設定

    説明

    SSL キー

    メールサーバーでクライアント SSL 認証が必要な場合は、YouTrack サーバーを識別する SSL キーをリストから選択します。

    リストには、YouTrack にすでにインポートされている SSL 鍵のみが表示されます。SSL キーを生成してアップロードする方法については、SSL キーを参照してください。

    接続タイムアウト

    メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。

    ソケットタイムアウト

    ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。

  5. 接続のテストボタンをクリックして、構成を確認します。接続を確立できない場合は、設定を修正し、接続を再度テストします。

  6. サーバーの追加ボタンをクリックしてください。

    • メールボックス統合設定が保存されます。

Microsoft Exchange Online (一般に Exchange Online、Office 365、または Microsoft 365 とも呼ばれます) との統合では、次のアクションを実行する必要があります。

Microsoft Azure にクライアントアプリケーションを登録する

このセットアップでは、次の前提条件を満たしている必要があります。

  • Microsoft Exchange Online の有効なライセンス。

  • Microsoft Azure Active Directory (AD) への管理アクセス。

移行を完了するには、Microsoft プラットフォームから次の情報を取得する必要があります。

  • 受信メッセージを取得するメールボックスのメールアドレス。このメールボックスは、アプリを登録する同じ Azure AD サービスに属している必要があります。

  • Microsoft Azure ポータルに登録されているアプリのアプリケーション（クライアント）ID。

  • Azure Active Directory テナント組織のディレクトリ (テナント) テナント ID。

  • 登録済みアプリ用に作成したクライアントシークレット。

アプリケーション（クライアント）ID およびディレクトリ（テナント）ID は、以下に示すように、クライアントアプリケーションの基本セクションにあります。

The Essentials section of a registered client application in Microsoft Azure.

クライアントシークレットは、証明書とシークレット <クライアントシークレットセクションから生成できます。

The Certificates & secrets section of a registered client application in Microsoft Azure.

このセットアップを実行する方法については、Microsoft Azure の製品ドキュメント(英語)の手順に従ってください。

必要なアクセス許可をクライアントアプリに追加する

次に下記の API 権限をアプリに追加する必要があります。

  • Mail.ReadWrite は、アプリケーションパーミッションとして付与する必要があります。

  • User.Read は、委譲されたアクセス許可として付与する必要があります。

権限のリストは、クライアントアプリの API 権限設定にあります。

The API permission settings of a registered client application in Microsoft Azure.

(前提条件に記載されているように) 管理者アカウントでログインしている場合は、アプリケーションのアクセス許可 Mail.ReadWrite を自分で付与できます。そうでない場合は、アプリケーション用に構成されたアクセス許可に管理者の同意を与えるよう管理者に依頼する必要があります。

クライアントアプリの権限を構成する方法については、Microsoft Azure の製品ドキュメント(英語)の手順に従ってください。

YouTrack でのメールボックス統合設定の更新

Microsoft プラットフォームから必要な情報を収集したら、YouTrack でメールボックス統合の設定を構成できます。

Microsoft Exchange Online メールボックスに接続するには:

  1. メインナビゲーションメニューから、 管理> 統合> メールボックス統合を選択します。

  2. メールボックス統合ページで、別のメールボックスに接続するリンクをクリックしてください。

    • サイドバーにメールボックス設定が表示されます。

      connect to a mail server

  3. サーバータイプ設定では、マイクロソフトエクスチェンジオンラインを選択します。

    • 統合が更新され、このサーバータイプの特定の設定が表示されます。

  4. 以下の設定に値を入力します。

    設定

    説明

    メールボックスアドレス

    インテグレーションが受信メッセージを現在取得しているメールアドレスを入力します。

    テナント ID

    Azure Active Directory テナント組織のディレクトリ（テナント）ID を入力します。

    クライアント ID

    登録されたクライアントアプリケーションのアプリケーション（クライアント）ID を Microsoft Azure に入力します。

    クライアントシークレット

    Microsoft Azure のクライアントアプリ用に生成したシークレットの値を入力します。

  5. 拡張設定セクションを展開して、以下のオプション設定を構成します。

    設定

    説明

    SSL キー

    メールサーバーでクライアント SSL 認証が必要な場合は、YouTrack サーバーを識別する SSL キーをリストから選択します。

    リストには、YouTrack にすでにインポートされている SSL 鍵のみが表示されます。SSL キーを生成してアップロードする方法については、SSL キーを参照してください。

    接続タイムアウト

    メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。

    ソケットタイムアウト

    ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。

  6. YouTrack がメールサーバーとの接続を確立できることを確認するには、接続のテストボタンをクリックします。

  7. テストが成功したら、サーバーの追加ボタンをクリックします。

    • メールボックス統合設定が保存されます。

YouTrack のメールボックス統合は、POP/POPS と IMAP/IMAPS のみをサポートしています。Microsoft Exchange のデフォルトプロトコルである MAPI はサポートされていません。Microsoft Exchange に接続するには、以下の 2 つの方法があります。

  • Microsoft Exchange で POP または IMAP を有効にして構成し、認証済み SMTP 設定を構成します。これらのメールコネクターを有効にすると、以下の手順に従って接続を確立できます。

    Microsoft Exchange メールボックスの特別な指示に注意してください。

  • 中間ゲートウェイサーバーを介して接続を確立します。これにより、POP/IMAP および SMTP を無効にして Exchange Server に接続できます。たとえば、DavMail 交換ゲートウェイは、独自の Exchange 形式を YouTrack が理解できるメールプロトコルに変換します。セットアップ手順については、DavMail Gateway のドキュメント(英語)を参照してください。

    このセットアップでは、以下の手順に従ってゲートウェイサーバーへの接続を確立します。

Microsoft Exchange Server の場合、メールボックス統合は共有メールボックスへの接続をサポートします。共有メールボックスのメンバーである任意のユーザーのユーザー名とパスワードを使用して認証できます。

メールサービスに接続するには:

  1. メインナビゲーションメニューから、 管理> 統合> メールボックス統合を選択します。

  2. メールボックス統合ページで、別のメールボックスに接続するリンクをクリックしてください。

    • サイドバーにメールボックス設定が表示されます。

      connect to a mail server

  3. 以下の設定に値を入力します。

    設定

    説明

    サーバータイプ

    メールサーバーが使用するプロトコルを選択します。メールボックス統合は IMAP/IMAPS プロトコルをサポートしています。

    ホスト

    メールサービスの URL を入力します。例: mail.exchange.com

    ポート

    メールサービスがリッスンするポートを入力します。メールサーバープロトコルを選択すると、デフォルトのポートが自動的に設定されます。

    ユーザー名

    メールサービスへのアクセスを許可するアカウントのユーザー名を入力します。

    パスワード

    メールサービスへのログインに使用するアカウントのパスワードを入力します。

  4. 拡張設定セクションを展開して、以下のオプション設定を構成します。

    設定

    説明

    SSL キー

    メールサーバーでクライアント SSL 認証が必要な場合は、YouTrack サーバーを識別する SSL キーをリストから選択します。

    リストには、YouTrack にすでにインポートされている SSL 鍵のみが表示されます。SSL キーを生成してアップロードする方法については、SSL キーを参照してください。

    接続タイムアウト

    メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。

    ソケットタイムアウト

    ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。

  5. 接続のテストボタンをクリックして、構成を確認します。接続を確立できない場合は、設定を修正し、接続を再度テストします。

  6. サーバーの追加ボタンをクリックしてください。

    • メールボックス統合設定が保存されます。

外部メールボックスがない場合でも、メールボックスの統合を利用して、YouTrack が提供するデフォルトのメールアドレスを使用できます。

YouTrack クラウドインスタンスごとに、YouTrack はデフォルトのメールボックスを作成します。デフォルトのメールボックス構成が有効になっている場合、このメールボックスのアドレスを他の人と共有できます。YouTrack は、メールボックス統合ルールの設定に従って、このアドレスに送信されたメッセージを処理します。

デフォルトのメールアドレスは instancename@youtrack.cloud で、instancename は YouTrack の名前です。

このタイプのメールボックス構成では実際のメールボックスにアクセスできないため、課題が発生した場合は、YouTrack サポートに要求(英語)を送信して支援を求めてください。

メールサービスに接続するには:

  1. 管理メニューから統合> メールボックス統合を選択します。

  2. メールボックス統合ページで、別のメールボックスに接続するリンクをクリックしてください。

  3. サーバーの追加ボタンをクリックしてください。

    • YouTrack Cloud のデフォルトメールサービスへの接続がインスタンスに追加されます。

トラブルシューティング

メールボックス統合のセットアップで課題が発生した場合は、次の条件のいずれかが当てはまるかどうかを確認してください。

状態 — メールサービスへの接続を確立できません。

原因

ソリューション

外部サービスは利用できません。

メールサービスが実行されていることを確認します。

接続がファイアウォールによってブロックされています。

YouTrack とメールサービスが使用するファイアウォールのポートを開きます。

メールサーバーには安全な接続が必要です。

メールサーバーの証明書を YouTrack にインポートします。手順については、SSL 証明書を参照してください。

メールサーバーの SSL 証明書の有効期限が切れています。

更新した証明書を更新して YouTrack にインポートします。手順については、SSL 証明書を参照してください。

Microsoft Exchange メールボックスに接続しようとしていますが、メールサービスまたは YouTrack のいずれかに構成の課題があります。

次のセットアップ要件を確認してください。

  • マイクロソフトエクスチェンジオンラインまたはマイクロソフトエクスチェンジサーバーに従って、Exchange メールボックスが POP/POPS または IMAP/IMAPS のいずれかを使用し、SMTP 経由で認証するように構成されていることを確認してください。

  • メールボックス統合のプロトコル設定が、Exchange メールボックスで有効になっているプロトコルと一致することを確認します。

  • MS Exchange 互換モードチェックボックスを有効にします。

それでも接続を確立できない場合は、サポートリクエストを送信してください(英語)。

状態 — セキュリティで保護されていないプロトコルを介してメールサーバーへの接続を確立できません。YouTrack はエラー bad_request を返します。

原因

ソリューション

IMAP サーバーは、STARTTLS を有効にする拡張機能を使用しています。YouTrack では、メールサーバーへの安全な接続が必要です。

メールサーバーの SSL 証明書を YouTrack にインポートします。手順については、SSL 証明書を参照してください。YouTrack とメールサーバーの両方がプライベートコンピューターネットワークで実行されている場合、メールサーバー用の自己署名 SSL 証明書を生成およびインポートできます。

2025 年 9 月 10 日
カスタムインポート 元のメールメッセージを表示する

関連ページ：

メール

メールは、顧客にとって最もアクセスしやすいコミュニケーション形式の 1 つです。ほとんどの人がメールアドレスを持っており、いつでも世界中のどこからでもメッセージを送受信できます。これにより、メールは顧客が企業に連絡するための便利かつ柔軟な方法になります。また、メールを使用すると、顧客は課題や質問を詳しく説明し、ファイルやスクリーンショットをアタッチして、サポートチームが課題を理解して解決するのに役立つ具体的な情報を提供できます。また、顧客は、保留で待ったり、複雑な電話ツリーを移動したりすることな...

メールボックスと標準の課題追跡プロジェクトの統合

メールボックス統合の主な目的は、ヘルプデスクプロジェクトでメールメッセージのチケットへの変換をサポートすることです。ただし、この機能は YouTrack 2023.1 以降でのみサポートされます。以前の YouTrack バージョンでは、課題追跡のために標準プロジェクトとのメールボックス統合を設定し、これらのプロジェクトを使用して基本的なヘルプデスクのやり取りをサポートし、外部のメールフィードバックを処理することができました。標準プロジェクト用にメールボックス統合を構成することは可能ですが、ヘル...

SSL キー

YouTrack では、SSL キーストアを YouTrack にインポートできます。キーストアは、公開鍵と秘密鍵のペア、それらが関連付けられている証明書のコンテナーです。キーストアは、サードパーティーへの接続を試行するときに、YouTrack をクライアントとして識別します。キーストアを使用して、サードパーティサービスの公開鍵を（証明書の形式で）キャッシュすることもできます。外部サービスのキーと証明書を含むキーストアがある場合は、このページでアップロードできます。それ以外の場合は、SSL 証明...

SSL 証明書

YouTrack を使用すると、外部サービスから信頼できる SSL 証明書をインポートできます。これらの証明書は外部サービスを信頼できる情報源として識別し、YouTrack とサードパーティサーバーの間に安全な接続を確立させます。キーストアを YouTrack にインポートすることもできます。キーストアは、YouTrack がサードパーティーに接続しようとしたときに YouTrack をクライアントとして識別します。キーストアは YouTrack の別のページで管理されています。詳しくは、SSL...

カスタムインポート

外部ソースから YouTrack にデータをインポートするには、YouTrack に組み込まれているインポートスクリプトの 1 つをカスタマイズしたり、新しいインポートスクリプトを最初から作成したりできます。カスタムインポートスクリプトは、中間データスキームとして JSON を使用して JavaScript で記述されています。YouTrack にインポートされたすべてのデータは、JSON に変換されてから、YouTrack エンティティに変換されます。新しいカスタムインポートを設定する：外部...

元のメールメッセージを表示する

プロジェクトでメールボックス統合を設定すると、接続されたメールサービスからの受信メールメッセージが自動的に新しい課題とコメントに変換されます。メールメッセージは通常、プレーンテキストと HTML の 2 つの部分で構成されます。メールメッセージの HTML バージョンには、テキストのフォーマット、色、スタイル、イメージが含まれます。フィードバックやサポートのために顧客から受信トレイに送信される一般的なメールメッセージには、通常、多くのフォーマットは含まれていませんが、スクリーンショットやハイパー...