Create work items and comments from email

Jira 管理者は、メールを受信および処理するようにクラウド アプリを構成できます。Jira はライセンスを持つユーザーからメールを受信して、自動的に作業項目を作成したりコメントや添付ファイルを追加したりできます。

メールからの作業項目またはコメント作成の設定

Jira の作業項目とコメントは、クラウドアプリのデフォルト POP メールサーバーに送信されたメールメッセージから生成できます。メールハンドラーを設定してこれらのメールの処理方法を制御したり、チームのニーズに応じて別のメールサーバーを追加したりできます。 

Microsoft OAuth

If you’re using Microsoft Exchange Online to create work items and comments from your email, then you need to configure OAuth 2.0 for your Microsoft Email server since Microsoft Exchange Online won’t work anymore. Depending on how your organization is configured, you may require consent from your Microsoft or Google admin. Learn more about getting consent from your Microsoft admin.

OAuth 2.0 統合で Microsoft メール サーバーを設定する

Microsoft の受信メール サーバーを追加するには:

1. [設定] () > [システム] の順に選択します。

2. [メール] > [受信メール] を選択します。

3. [受信メール サーバーを追加] を選択します。

4. メール サーバーに名前と説明を指定します。

5. [Microsoft でサインイン] を選択します。

6. Microsoft の資格情報を入力して Microsoft メール サーバーを使用します。

Microsoft メール サーバーの場合、Jira は認証とトークン エンドポイント データを自動入力します。Jira がお客様の情報にアクセスできるようにするには、権限をレビューして確認する必要があります。

基本認証から OAuth 2.0 にメール サーバーをアップグレード

メール サーバーをアップグレードするには:

1. [設定] () > [システム] の順に選択します。

2. [メール] > [受信メール] を選択します。

3. [受信メール サーバーの追加] を選択します。

4. メール サーバーに名前と説明を指定します。

5. [Microsoft でサインイン] を選択します。

6. 追加 を選択します 。

7. Configure an incoming mail handler with the Microsoft mail server you configured from step 1. Alternatively, you can use a Microsoft mail server that you configured earlier.

8. Delete the incoming mail server that uses basic authentication.

Google OAuth

If you are using Gmail to create work items and comments from your email and would like to set up a mail server for your incoming emails on Jira, then you need to configure OAuth 2.0 for your Gmail email server. Depending on how your organization is configured, you may require consent from your Google admin. Learn more about getting consent from your Google admin.

OAuth 2.0 統合で Gmail メール サーバーを設定する

Gmail 受信メール サーバーを追加する方法は次のとおりです。

1. [設定] () > [システム] の順に選択します。

2. [メール] > [受信メール] を選択します。

3. [受信メール サーバーを追加] を選択します。

4. メール サーバーに名前と説明を指定します。

5. [Google でサインイン] を選択します。

6. Gmail の資格情報を入力して Gmail メール サーバーを使用します。

7. 「Gmail アカウントからメールの読み込み、作成、送信をする」権限をチェックします。

8. 続行を選択して、Gmail メール サーバーでのログインを完了します。

基本認証やアプリ パスワードから OAuth 2.0 にメール サーバーをアップグレードする

メール サーバーをアップグレードするには:

1. [受信メール サーバーの追加] を選択します。

2. メール サーバーに名前と説明を指定します。

3. メール サービス プロバイダーとして Gmail を選択します。

4. [Google でサインイン] を選択します。

5. Gmail のサインイン資格情報を入力して Gmail メール サーバーを使用します。

6. 「Gmail アカウントからメールの読み込み、作成、送信をする」権限をチェックします。

7. 続行を選択して、Gmail メール サーバーでのログインを完了します。

8. Configure an incoming mail handler with the Gmail mail server you configured from step 1. Alternatively, you can use a Gmail mail server you’ve configured earlier.

9. Delete the incoming mail server that uses Basic authentication/App passwords 

カスタム メール サーバーを構成

To generate work items and comments from emails, you’ll have to create a mail account for a POP or IMAP mail server that Jira can access. Jira periodically scans your new emails from your mail account, and it then creates work items and comments from your mails (via mail handlers). Learn more about mail handlers.

受信メール サーバーをセットアップするには、次の手順を実行します。

1. > [システム] の順に選択します。

2. [メール] > [受信メール] を選択します。

3. [受信メール サーバーの追加] をクリックします。

4. メール サーバーに名前と説明を指定して、[追加] をクリックします。

5. Select the protocol, and enter the host name, port number, timeout, username and password fields. Learn more about incoming mail server fields.

6. 追加をクリックします。

受信メール サーバー フィールド

受信メール サーバーを追加するには、次のフィールドを入力する必要があります。

既存の受信メール サーバーの編集

You can make changes to your existing incoming mail server. For example, if you’ve changed the password for your POP or IMAP mail server, then you’ll have to update this field in Jira so that work items and comments can be generated from your email messages. Learn more about incoming mail server fields.

既存の受信メール サーバーを編集するには、次の手順を実行します。

1. > [システム] の順に選択します。

2. [メール] > [受信メール] を選択します。

3. [受信メール サーバーのセットアップ] で自身のメール サーバーを見つけ、[編集] をクリックします。

4. 更新したい各フィールドに変更を加え、[保存] をクリックします。

受信メール サーバーを削除

受信メール サーバーが必要なくなった場合、または OAuth 2.0 認証にアップグレードされない場合は削除できます。

受信メール サーバーを削除するには:

1. > [システム] の順に選択します。

2. [メール] > [受信メール] を選択します。

3. 削除するメール サーバーを見つけて、[削除] を選択します。

メール ハンドラーの設定

1. > [システム] の順に選択します。

2. [メール] > [受信メール] の順に選択します。 

3. [受信メール ハンドラーの追加] をクリックします (または、既存のメール ハンドラーの横にある [編集] をクリックします)。

4. メールハンドラが何をするかを表す名前を入力してください（例：Company A の IMAP メールサーバーから作業項目やコメントを作成)

5. 既定のサーバーを選択するか、追加のサーバーが設定されている場合はいずれかのサーバーを選択します。  

   IMAP メール サーバーを使用していて、メール ハンドラーに、メール アカウントの受信トレイ以外のフォルダから新しいメッセージをスキャンさせたい場合、そのフォルダの名前をここで指定します。

6. メール ハンドラーの実行間隔を分単位で指定するか、メール サーバーをスキャンする頻度を指定します。

7. メール ハンドラーの種類を選択します (既定のメール ハンドラーの詳細については以下をご参照ください)。

8. [次へ] をクリックし、選択したメール ハンドラーに固有のオプションを記入します。 

9. [追加] をクリックしてメール ハンドラーを保存します。

新規ユーザーからのメール受信

Jira ユーザー アカウントを持たない人から送信されたメール メッセージを Jira で処理できるようにするには、次の手順を実行します。

1. メール サーバーに匿名またはダミーのメール アカウントを作成します。

2. 同様に匿名またはダミーの Jira ユーザー アカウントを作成し、そのメール アドレスを先ほど作成したメール アカウントと一致させます。 

3. メール ハンドラーのオプションを設定する際に、既定の報告者として匿名またはダミーの Jira ユーザー アカウントを設定します。

メール ハンドラーの削除

1. > [システム] の順に選択します。

2. [メール] > [受信メール] の順に選択します。 

3. 該当のメール ハンドラーを見つけて、[削除] をクリックします。

[詳細] > [サービス] からメール ハンドラー サービスを削除する場合、関連付けられたハンドラーも削除される点にご注意ください。 

追加のメール サーバーの設定

別のアカウントをJira スペースにリンクしたい場合は、追加の POP または IMAP メールサーバーを設定できます。Jira は、メール アカウントが受信した新しいメール メッセージをスキャンするサービスと、作業項目やコメントを作成するメール ハンドラーを使用します。

メール サーバーでの Jira のメッセージ処理方法

• Jira は、アカウントの受信トレイで受信したメール メッセージをスキャンします。IMAP サーバーによってスキャンするフォルダーを別に指定できます。

• Jira が正常にメッセージを処理する場合、Jira はメールアカウントからのメッセージ（POP または IMAP メールサーバー上の）やファイルシステムからのメッセージ（ファイル・システム・メッセージ用）を削除します。

Jira のメール ハンドラー

新しいメール ハンドラーを作成する、または既存のメール ハンドラーを編集する際は、次の各ハンドラーに設定可能なさまざまなオプションをご確認ください。

既定のメール ハンドラー

このメール ハンドラーは、クラウドの既定のメール サーバーを使用して自動的に作成されます。受信メール用に追加のルールを作成する場合は、以下のカスタマイズ可能なハンドラーのどれかを使用することをおすすめします。

既定のメール ハンドラーのオプション

カスタム メール ハンドラー

新しい作業項目を作成するか、既存の作業項目にコメントを追加します

このハンドラーは、新しい作業項目を作成するか、既存の作業項目にコメントを追加します。件名に作業項目キーが含まれている場合、メッセージはその作業項目にコメントとして追加されます。キーが見つからない場合は、デフォルトのスペースに新しい作業項目が作成されます。

引用符なしのメール本文からコメントを追加する

このハンドラーは、メールメッセージの「引用されていない」行でコメントを作成し、「>」または「|」で始まる行を削除します。コメントは、メールの件名にある最初の作業項目のキーに追加されます。コメント作成者は、メールの From フィールドから取得されます。

メール本文全体でコメントを追加する

このハンドラーは、受信したメールメッセージの本文全体に基づいてコメントを作成します。コメントは、メール件名で最初に見つかった作業項目キーに追加されます。コメント作成者は、メールの From フィールドから取得されます。

各メールメッセージから新しい作業項目を作成

このハンドラーは、受信メッセージごとに新しい作業項目を作成します。

メール本文の指定したマーカーまたはセパレーターの前にコメントを追加する

このハンドラーは、メールメッセージの本文からコメントを作成しますが、指定した正規表現にマッチするマーカーまたは区切り文字以降の本文の任意の部分をフィルタリングできます。コメントは、メールの件名にある最初の作業項目のキーに追加されます。コメント作成者は、メールの From フィールドから取得されます。

Lotus Notes や Outlook などのメール システムを使用している場合、これらのメール システムでは主要なコンテンツと他のコンテンツ (例:返信または転送されたコンテンツ) を "---- Original Message ----" or "Extranet\n email.address/DOM/REG/CONT/CORP@CORPMAIL" などの予測可能なテキスト文字列で分割するため、この機能が役立ちます。このハンドラーを使用する場合は、次の動作に注意してください。

• (メール ハンドラーで指定された) regex パターンが見つかった場合、メール メッセージ本文の、最初に一致した regex パターンの前のテキストがコメントに使用され、本文の残りの部分は破棄されます。

• (メール ハンドラーで指定された) regex パターンが見つからない場合、メール メッセージ本文のテキスト全体がコメントに使用されます。

• regex パターンがメール ハンドラーで指定されていない場合、メール メッセージ本文のテキスト全体がコメントに使用されます。

• メール ハンドラーに指定された regex 表現に誤りがある場合、メール メッセージ本文のテキスト全体がコメントに使用されます。

カスタム メール ハンドラーのオプション

作業項目とコメントの作成

次の図は、Jira が受信した各メールメッセージを処理し、そのコンテンツが新しい作業項目になるか、既存の作業項目へのコメントになるかを決定する方法を示しています：

処理を行う前のヒント

Jira アプリにリンクする追加のメールサーバーについては、以下の前処理のヒントをお勧めします： 

• Jira のメール ハンドラーは正常に処理されたメール メッセージをメール サーバーから削除するため、メールをバックアップ フォルダに送信し、Jira が処理したメールの記録を保持するようにします。 

• メール フォルダに Jira メール通知への返信が含まれる場合、自動返信やバウンス メールをフィルタリングするルールをセットアップします。これを行わない場合、"オフィス不在" 通知などの自動応答システムと Jira との間のメール ループが発生する可能性が高くなります。Jira は送信メールに Precedence:bulk ヘッダー (無効化した場合を除く) と Auto-Submitted ヘッダーを設定しますが、一部の自動応答システムはこれを無視します。次のルール (procmail 形式) は、ほとんどの自動返信を検出します。

  ^From:.*mailer-daemon@ ^Auto-Submitted:.auto- ^Content-Type:\ multipart/report;\ report-type=delivery-status ^Subject:\ Delivery\ Status\ Notification ^Subject:\ Undeliverable ^Subject: Returned Mail: ^From:\ System\ Administrator ^Precedence:\ auto_reply ^Subject:.*autoreply ^Subject:.*Account\ signup

  これらのルールを使用しても、通常のメールと区別するためのヘッダー設定を行っていない自動応答を受け取る場合があります。このような事例では、その送信者を除外するようにフィルターを手動で更新する必要があります。

• 大容量の添付ファイル付きのメールをキャッチするフィルターを設定します。Jira は標準の JavaMail ライブラリを使用してメールを解析していて、大容量の添付ファイルがあると、すぐにメモリ不足となります (たとえば、ヒープ サイズ 512 MB ヒープで 50 MB を超える場合)。未処理のメールは削除されないため、メール サービスを実行するたびにそのメールが再処理されます (OutOfMemoryError を発生させるもう一つの原因となります)。メール サーバーが大容量の添付ファイルをそのまま Jira に引渡すことはないと確信できない場合は、フィルターを設定して、Jira が大容量の添付ファイル受け取らないようにするのが一番です。

• スパムフィルタリングルールを設定して、Jira がスパムを処理する（そして作業項目を作成してしまう可能性がある）ことがないようにします。

高度なメール ループ検出

Jira はメールを処理する際、個々の送信者から受け取ったメッセージの追跡も行います。 

特定のメール アドレスから Jira に、大量のメールが短期間に送信されることがあります。この場合、設定によっては、Jira の高度なメール ループ検出ツールが特定のメール アドレスからのメールをブロックすることがあります。

 高度なメール ループ検出の設定方法

1. > [システム] の順に選択します。

2. [メール] セクションで、[受信メール] をクリックします。

3. [詳細設定] セクションで、必要に応じて次のいずれかの操作を行います。

   • メッセージのしきい値を増やし、簡単にトリガーされないようにします (推奨)。

   • しきい値を 0 に設定して完全に無効化します (インスタンスでメール ループが発生する可能性があるため、推奨されません)。

   • 信頼されるドメインを許可リストに追加して、メール ループ検出機能による影響を防ぎます (信頼されているドメインであってもメール ループが発生する可能性があるため、推奨されません)。

次の点に注意してください。

• メッセージしきい値を構成できます。しきい値に到達すると、Jira はそれらのメッセージを一括で処理します。

• メール ループは一般的に不在通知によって発生するため、信頼されているドメインでもメール ループが発生することがあります。

トラブルシューティング

• デフォルトの報告者に作業項目を作成する権限があることを確認してください。

• メッセージの sent date が 7 日以内であることを確認します。送信日が 7 日より前のメールは処理されません。

• Jira では、HTML/リッチ テキスト形式は正しく処理されない場合があります。メールのコメント ハンドラーは、プレーン テキストの変換を行うように設計されています。

• メールに件名を必ず追加してください。件名は作業項目の要約フィールドに入力されます。メールの件名が入力されていない場合、メールは処理されません。

• すべての Jira サイトには、独自の事前設定済みの既定のメール サーバーが付属します。また、独自のメール サーバーをサイト用に設定することもできます。

新しいメール ハンドラーを作成したり、既存のメール ハンドラーを編集したときには、設定をテストし、すべてが期待どおりに動作することを確認することをおすすめします。