メールサーバー接続
メールサーバー接続を使用すると、独自のドメインでホストされているビジネスメールアドレスに送信されたメッセージを処理できます。
このオプションは、メールトラフィックを処理するための独自のサーバーをすでに持っている企業に適しています。このセットアップは、システム管理者と協力して実行するのが最適です。
顧客向けメールアドレスをすでにお持ちで、このヘルプデスクプロジェクトでこのアドレスに送信されるメッセージを管理したい場合は、代わりにメール転送の使用を検討してください。詳細については、「メール転送」を参照してください。
メールサーバー接続のセットアップ
このタイプのメールチャネルを設定するには、1 つ以上のメールサーバーに接続する必要があります。
Gmail の場合、メールサービスへの接続に使用するアカウントには特別な要件があります。詳細については、Gmail を参照してください。
Microsoft Exchange Server および Microsoft Exchange Online (Office 365) メールボックスの場合は、追加のセットアップが必要です。ヘルプデスクプロジェクトと互換性があるようにメールサービスを構成するには、マイクロソフトエクスチェンジオンラインまたはマイクロソフトエクスチェンジサーバーの手順を読んでその指示に従ってください。
Google アカウントには、安全性の低いサインインテクノロジーを使用するサードパーティアプリケーションへのアクセスを制限する設定があります。定義上、これはユーザー名とパスワードで認証する接続に適用されますが、これらはハイジャックに対して脆弱です。
セットアップ要件は、安全性の低いアプリを管理するための現在の設定に基づいています。要件は、Gmail サービスでの認証に使用する Google アカウントに適用されます。
自分で管理している Google アカウントに接続している場合は、Google アカウントでアプリケーション固有のパスワード（アプリパスワード）を生成し、それを認証に使用します。Google アカウントオフで安全性の低いアプリへのアクセスを有効にするオプションを残します。
アプリパスワードは、二段階認証プロセスが有効になっているアカウントでのみ使用できます。
組織が GoogleWorkspace の一部として管理している Google アカウントを使用している場合は、安全性の低いアプリへのアクセスを無効にするオプションがオンになっていることを確認してください。
チャネル設定に保存する Google アカウントでは 2 段階認証プロセスが有効になっている必要があります。このアカウントで Gmail サービスに接続するには、Google アカウントでアプリケーション固有のパスワードを生成します。
ユーザー名には、Google アカウントのユーザー名を入力します。
パスワードの場合、Google で生成したアプリケーション固有のパスワードを入力します。
安全性の低いアプリへのアクセスを許可することはできますが、Google は、このタイプの認証のサポートを最終的に中止することを示しています。二段階認証プロセスを有効にし、アプリのパスワードを使用して Gmail サービスで認証することを強くお勧めします。
Gmail メールボックスに接続するには:
アプリケーションヘッダーのプロジェクトリンクをクリックします。
リスト内でヘルプデスクプロジェクトを見つけます。
プロジェクトのオプションメニューを開き、チャンネルを選択します。
メールチャンネルを選択します。
新しいメールチャネルボタンをクリックしてください。
新しいメールチャネルダイアログが開きます。
外部メールサーバーに接続するオプションを選択してください。
セットアップウィザードが開き、新しいメールサーバー接続ダイアログが表示されます。
以下の設定に値を入力します。
設定
説明
接続タイプ
接続に使用するプロトコルを選択します。Gmail は POP/POPS および IMAP/IMAPS プロトコルをサポートしています。ただし、YouTrack は POP3/POP3S プロトコルを使用する接続をサポートしなくなりました。
ホストアドレス
メールサービスの URL を入力します。例:
imap.gmail.comポート
メールサービスがリッスンするポートを入力します。メールサーバープロトコルを選択すると、デフォルトのポートが自動的に設定されます。
Email アドレス
メールサービスへのアクセスを許可するアカウントのメールアドレスを入力します。
パスワード
Gmail サービスへのログインに使用するアカウントのパスワードを入力します。
拡張設定セクションを展開して、以下のオプション設定を構成します。
設定
説明
SSL キー
Gmail との接続の場合、この設定は無視できます。Gmail サービスとの接続は、TLS を使用して自動的に認証されます。
接続タイムアウト
メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。
ソケットタイムアウト
ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。
接続のテストボタンをクリックして、構成を確認します。接続を確立できない場合は、設定を修正し、接続を再度テストします。
接続ボタンをクリックしてください。
チャンネル設定の設定が保存されます。
次の手順を使用して、汎用メールサービスとの接続を構成します。
一般的なメールサービスに接続するには:
アプリケーションヘッダーのプロジェクトリンクをクリックします。
リスト内でヘルプデスクプロジェクトを見つけます。
プロジェクトのオプションメニューを開き、チャンネルを選択します。
メールチャンネルを選択します。
新しいメールチャネルボタンをクリックしてください。
新しいメールチャネルダイアログが開きます。
外部メールサーバーに接続するオプションを選択してください。
セットアップウィザードが開き、新しいメールサーバー接続ダイアログが表示されます。
以下の設定に値を入力します。
設定
説明
接続タイプ
メールサーバーで使用するプロトコルを選択します。メールチャネルは IMAP/IMAPS プロトコルをサポートします。POP3/POP3S のサポートは廃止されます。
ホストアドレス
メールサービスの URL を入力します。例:
mail.server.comポート
メールサービスがリッスンするポートを入力します。メールサーバープロトコルを選択すると、デフォルトのポートが自動的に設定されます。
Email アドレス
メールサービスへのアクセスを許可するアカウントのメールアドレスを入力します。
パスワード
メールサービスへのログインに使用するアカウントのパスワードを入力します。
拡張設定セクションを展開して、以下のオプション設定を構成します。
設定
説明
SSL キー
メールサーバーでクライアント SSL 認証が必要な場合は、YouTrack サーバーを識別する SSL キーをリストから選択します。
リストには、YouTrack にすでにインポートされている SSL 鍵のみが表示されます。SSL キーを生成してアップロードする方法については、SSL キーを参照してください。
接続タイムアウト
メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。
ソケットタイムアウト
ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。
接続のテストボタンをクリックして、構成を確認します。接続を確立できない場合は、設定を修正し、接続を再度テストします。
接続ボタンをクリックしてください。
メールチャネル設定が保存されます。
Microsoft Exchange Online (一般的に Exchange Online、Office 365、または Microsoft 365 とも呼ばれます) との接続では、次の操作を実行する必要があります。
最初に、アプリケーションを Microsoft Azure ポータルに登録する必要があります。これにより、Exchange Online サービスへの再接続に使用するクライアント ID とクライアントシークレットにアクセスできるようになります。詳細については、クライアントアプリケーションを Microsoft Azure に登録するを参照してください。
必要な API アクセス許可をクライアントアプリに追加します。詳細については、必要なアクセス許可をクライアントアプリに追加するを参照してください。
Microsoft Exchange Online の設定を使用するように YouTrack でメールチャネルを構成します。手順については、「YouTrack でのメールボックス統合設定の更新」を参照してください。
クライアントアプリケーションを Microsoft Azure に登録する
このセットアップでは、次の前提条件を満たしている必要があります。
Microsoft Exchange Online の有効なライセンス。
Microsoft Azure Active Directory (AD) への管理アクセス。
移行を完了するには、Microsoft プラットフォームから次の情報を取得する必要があります。
受信メッセージを取得するメールボックスのメールアドレス。このメールボックスは、アプリを登録する同じ Azure AD サービスに属している必要があります。
Microsoft Azure ポータルに登録されているアプリのアプリケーション（クライアント）ID。
Azure Active Directory テナント組織のディレクトリ (テナント) テナント ID。
登録済みアプリ用に作成したクライアントシークレット。
アプリケーション（クライアント）ID およびディレクトリ（テナント）ID は、以下に示すように、クライアントアプリケーションの基本セクションにあります。
クライアントシークレットは、証明書とシークレット <クライアントシークレットセクションから生成できます。
このセットアップの実行方法については、Microsoft Azure の製品ドキュメント(英語)の指示に従ってください。
必要なアクセス許可をクライアントアプリに追加する
次に下記の API 権限をアプリに追加する必要があります。
Mail.ReadWrite は、アプリケーションパーミッションとして付与する必要があります。
User.Read は、委譲されたアクセス許可として付与する必要があります。
権限のリストは、クライアントアプリの API 権限設定にあります。
(前提条件に記載されているように) 管理者アカウントでログインしている場合は、アプリケーションのアクセス許可 Mail.ReadWrite を自分で付与できます。そうでない場合は、アプリケーション用に構成されたアクセス許可に管理者の同意を与えるよう管理者に依頼する必要があります。
クライアントアプリのアクセス許可を構成する方法については、Microsoft Azure の製品ドキュメント(英語)の手順に従ってください。
YouTrack でのメールボックス統合設定の更新
Microsoft プラットフォームから必要な情報を収集したら、YouTrack でメールチャネルの設定を構成できます。
Microsoft Exchange Online メールボックスに接続するには:
アプリケーションヘッダーのプロジェクトリンクをクリックします。
リスト内でヘルプデスクプロジェクトを見つけます。
プロジェクトのオプションメニューを開き、チャンネルを選択します。
メールチャンネルを選択します。
新しいメールチャネルボタンをクリックしてください。
新しいメールチャネルダイアログが開きます。
外部メールサーバーに接続するオプションを選択してください。
セットアップウィザードが開き、新しいメールサーバー接続ダイアログが表示されます。
接続タイプ設定では、マイクロソフトエクスチェンジオンラインを選択します。
メールチャネルが更新され、この接続タイプの特定の設定が表示されます。
以下の設定に値を入力します。
設定
説明
メールボックスアドレス
メールチャネルが現在受信メッセージを取得しているメールアドレスを入力します。
テナント ID
Azure Active Directory テナント組織のディレクトリ（テナント）ID を入力します。
クライアント ID
Microsoft Azure に登録されているクライアントアプリケーションのアプリケーション（クライアント）ID を入力します。
クライアントシークレット
Microsoft Azure でクライアントアプリ用に生成したシークレットの値を入力します。
YouTrack がメールサーバーとの接続を確立できることを確認するには、接続のテストボタンをクリックします。
テストが成功したら、接続ボタンをクリックします。
メールチャネル設定が保存されます。
YouTrack のメールチャネルは、IMAP/IMAPS 経由で接続するように設定する必要があります。POP3/POP3S 経由の接続の公式サポートは非推奨になりました。Microsoft Exchange のデフォルトのプロトコルである MAPI はサポートされていません。Microsoft Exchange に接続する場合、次の 2 つのオプションがあります。
Microsoft Exchange で IMAP 接続を有効にして構成し、認証された SMTP 設定を構成します。これらのメールコネクターを有効にすると、以下の手順に従って接続を確立できます。
Microsoft Exchange メールボックスの特別な指示に注意してください。
中間ゲートウェイサーバーを介して接続を確立します。これにより、POP/IMAP および SMTP を無効にして Exchange Server に接続できます。たとえば、DavMail 交換ゲートウェイは、独自の Exchange 形式を YouTrack が理解できるメールプロトコルに変換します。セットアップ手順については、DavMail Gateway のドキュメント(英語)を参照してください。
このセットアップでは、以下の手順に従ってゲートウェイサーバーへの接続を確立します。
Microsoft Exchange Server の場合、メールチャネルは共有メールボックスへの接続をサポートします。共有メールボックスのメンバーである任意のユーザーのユーザー名とパスワードを認証に使用できます。
Microsoft Exchange サーバーに接続するには:
アプリケーションヘッダーのプロジェクトリンクをクリックします。
リスト内でヘルプデスクプロジェクトを見つけます。
プロジェクトのオプションメニューを開き、チャンネルを選択します。
メールチャンネルを選択します。
新しいメールチャネルボタンをクリックしてください。
新しいメールチャネルダイアログが開きます。
外部メールサーバーに接続するオプションを選択してください。
セットアップウィザードが開き、新しいメールサーバー接続ダイアログが表示されます。
以下の設定に値を入力します。
設定
説明
接続タイプ
メールチャネルは IMAP/IMAPS プロトコルをサポートします。POP3/POP3S のサポートは廃止されました。
ホストアドレス
メールサービスの URL を入力します。例:
mail.exchange.comポート
メールサービスがリッスンするポートを入力します。メールサーバープロトコルを選択すると、デフォルトのポートが自動的に設定されます。
Email アドレス
メールサービスへのアクセスを許可するアカウントのメールアドレスを入力します。
パスワード
メールサービスへのログインに使用するアカウントのパスワードを入力します。
拡張設定セクションを展開して、以下のオプション設定を構成します。
設定
説明
SSL キー
メールサーバーでクライアント SSL 認証が必要な場合は、YouTrack サーバーを識別する SSL キーをリストから選択します。
リストには、YouTrack にすでにインポートされている SSL 鍵のみが表示されます。SSL キーを生成してアップロードする方法については、SSL キーを参照してください。
接続タイムアウト
メールサービスからの完全なデータ転送を待ってから接続を閉じる最大時間を設定します。デフォルト値は 60 秒に設定されています。
ソケットタイムアウト
ソケットを切断する前に、メールサービスからの応答を待機する最大時間を設定します。デフォルト値は 60 秒に設定されています。
接続のテストボタンをクリックして、構成を確認します。接続を確立できない場合は、設定を修正し、接続を再度テストします。
接続ボタンをクリックしてください。
メールチャネル設定が保存されます。
次のステップ
外部アドレスからのメールを転送するようにメールチャネルを設定した後、このチャネルの設定を微調整できます。
フィルターを追加して、どのメッセージをヘルプデスクチケットに変換するかを決定します。詳細については、「フィルター」を参照してください。
後処理設定を使用して、受信メールメッセージから作成されたチケットとコメントを YouTrack が処理する方法を定義します。詳細については、「後処理」を参照してください。
更新通知およびヘルプデスクエージェントからの返信のために YouTrack によって送信されるメールメッセージのレイアウトとコンテンツをカスタマイズします。詳細については、「ヘルプデスク通知テンプレート」を参照してください。
メールサーバー接続設定
メールサーバーへの接続をセットアップするときに構成した設定は、サイドバーのメールサーバー接続タブに表示されます。これらの設定を使用すると、新しい接続を最初からセットアップすることなく、サーバー接続を微調整できます。
ここでは次の設定が利用できます。
設定 | 説明 |
|---|---|
接続タイプ | このメールチャネルに使用される接続タイプが表示されます。 |
ホストアドレス | メールサービスの URL が表示されます。 |
ポート | メールサービスがリッスンするポートを表示します。 |
Email アドレス | メールサービスへのアクセスを許可するアカウントのメールアドレスが表示されます。 |
パスワード | メールサービスへのログインに使用するアカウントのパスワードを保存します。 |
拡張設定セクションでは次の設定が使用できます。
設定 | 説明 |
|---|---|
SSL キー | クライアント SSL 認証を必要とするメールサーバーの場合、この設定には、YouTrack サーバーを識別する SSL キーが保存されます。 リストには、すでに YouTrack にインポートされている SSL キーのみが含まれています。SSL キーを生成してアップロードする方法については、「SSL キー」を参照してください。 |
接続タイムアウト | 接続を閉じる前に、メールサービスからのデータ転送が完了するまで待機する最大時間を表示します。デフォルト値は 60 秒に設定されています。 |
ソケットタイムアウト | ソケットを切断するまでにメールサービスからの応答を待機する最大時間を表示します。デフォルト値は 60 秒に設定されています。 |
メールサーバー接続を転送アドレスとして使用する
メールサーバー接続タブの追加設定を使用すると、メールサーバーへの接続に使用されるメールアドレスを、外部ドメインに属するメールボックスに送信されるメッセージの転送アドレスとして使用できます。
この機能を有効にするには:
オプションを転送用受信メールとして使用に切り替えます。
外部メールアドレスフィールドに転送元のアドレスを入力します。
保存ボタンをクリックしてください。
関連ページ：
メール転送
メール転送は、あるメールアドレスに送信されたメールが別のメールアドレスに自動的に転送されるプロセスです。例: 会社のドメインのメールアドレスをお持ちの場合は、すべての受信メールを YouTrack のヘルプデスクプロジェクトに転送することを選択できます。このオプションは、顧客リクエストを受信するためのメールアカウントをすでに持っている企業に最適で、設定も比較的簡単です。会社がメールトラフィックを処理するための独自のサーバーをすでに持っている場合は、代わりにメールサーバーへの接続を設定することを検...
SSL キー
YouTrack では、SSL キーストアを YouTrack にインポートできます。キーストアは、公開鍵と秘密鍵のペア、それらが関連付けられている証明書のコンテナーです。キーストアは、サードパーティーへの接続を試行するときに、YouTrack をクライアントとして識別します。キーストアを使用して、サードパーティサービスの公開キーを（証明書の形式で）キャッシュすることもできます。外部サービスのキーと証明書を含むキーストアがある場合は、このページでアップロードできます。それ以外の場合は、SSL 証...
受信メッセージの処理
メールチャネルを設定したら、YouTrack が処理する受信メールメッセージを指定できます。フィルター：これらの設定により、このチャネルで使用されるメールアドレスからどのメールを取得する必要があるかが決まります。これらの設定はオプションです。フォルダー受信メールメッセージを処理するためのソースとして使用するフォルダーを選択します。フォルダーを選択すると、選択したフォルダーとそのサブフォルダーに配信されるメッセージが処理されます。フォルダーを選択しない場合、統合により、完全に削除されたメッセージ...
ヘルプデスク通知テンプレート
ヘルプデスクプロジェクトには、エージェントとレポーター間のコミュニケーションを促進するために使用される専用の通知テンプレートセットがあります。各テンプレートは完全にカスタマイズ可能なため、各メッセージを調整してブランドを強化し、すべてのタッチポイントで一貫した顧客エクスペリエンスを作成できます。他のヘルプデスクプロジェクトで送信される通知に影響を与えることなく、各通知を個別にカスタマイズすることもできます。通知テンプレートをカスタマイズする方法については、「通知テンプレートの編集」を参照してくだ...