メールによるチケット登録 - 手順2: メールを送る

利用のための準備で説明した設定を行ってから5分以内に、専用のメールアドレスが作成されメールによるチケット登録が行えるようになります。

チケット登録用メールアドレス
プロジェクト共通アドレス/プロジェクト固有アドレスの違い
送信元アドレス(From)
同報アドレス(Cc)
メールの件名(Subject)
メール本文
メール本文で指定可能な属性 / 添付ファイル
チケットを更新する
うまくいかない時は

チケット登録用メールアドレス

お客様ごとに以下の形式の専用のメールアドレス（「プロジェクト共通アドレス」と「プロジェクト固有アドレス」）が割り当てられます。
チケットの登録を行うにはこのアドレスに宛てて後述する形式のメールを送信します。

※ プロジェクト固有アドレスは、プロジェクト識別子が「inbox」で始まるプロジェクトに限り利用可能です。

	プロジェクト共通アドレス	プロジェクト固有アドレス
My Redmine Gen.2	アカウント名/受信メールAPIキー@mail.cloud.redmine.jp	アカウント名/受信メールAPIキー/プロジェクト識別子@mail.cloud.redmine.jp

「アカウント名」はMy RedmineにアクセスするURLのお客様ご指定部分です。（My RedmineのURL https://*****.cloud.redmine.jp/ の*****部分）
「APIキー」は前述の「利用のための準備」で設定したものです。
アカウント名 = accountname, 受信メールAPIキー = bag3oZC9JVGkmP7HUtkw の場合の送信先メールアドレスは以下の通りです。
accountname/bag3oZC9JVGkmP7HUtkw
メールアドレスでは大文字・小文字は区別されません。
プロジェクト固有アドレスを利用すると、メール本文内でのプロジェクトの指定を省略でき、Redmineに登録されていないメールアドレスからもチケットを登録できます。お客様からのお問い合わせメールをRedmineのチケットとして登録したい場合などに便利です。

プロジェクト共通/固有アドレスの違い

	プロジェクト共通アドレス	プロジェクト固有アドレス
プロジェクト識別子	何でもOK （inboxで始まらなくてよい）	inboxで始まる
送信元アドレス(From)	登録ユーザーのみ Redmineにユーザー登録しているメールアドレスからのみチケット作成可能	誰でもOK Redmineに登録していないメールアドレスからもチケット作成可能
メール本文内でプロジェクトの指定	必須メール本文内でプロジェクトを指定する文字を含めることが必須（例）project: some-system-dev	不要メール本文内で指定不要（チケット登録用メールアドレスに識別子が含まれている）

My Redmine Gen.1(従来サービス)をご利用の場合

My Redmine Gen.1をご利用の場合、チケット登録用アドレスの形式は以下の通りです。

	プロジェクト共通アドレス	プロジェクト固有アドレス
My Redmine Gen.1	アカウント名/受信メールAPIキー@my.redmine.jp	アカウント名/受信メールAPIキー/プロジェクト識別子@my.redmine.jp

送信元アドレス(From)

チケットの作成者としたいユーザーに対応するメールアドレスからメールを送信します。メールの送信元アドレス(From)アドレスに対応するユーザーがチケットの登録者となります。

Fromのメールアドレスが以下のいずれかに当てはまる場合、そのメールは無視されます。

ロックされているユーザーのメールアドレス
指定されたプロジェクトにチケットを登録する権限がないユーザーのメールアドレス
そのメールアドレスを使用しているユーザーがRedmine上に存在しない
Redmineの「管理」→「設定」→「メール通知」→「送信元メールアドレス」に設定されたメールアドレス

ただし、プロジェクト固有アドレス宛に送られたメールは、どのアドレスから送られてもチケットが登録されます。

同報アドレス(Cc)

Ccにはウォッチャーに追加したいユーザーのメールアドレスを記述します。Toに記述した場合もCcと同様にウォッチャーとして追加されます。
ウォッチャーを追加するには、送信元アドレスに対応するユーザーが「ウォッチャーの追加」権限を持っている必要があります。
（設定箇所:「管理」→「ロールと権限」→「権限レポート」→「ウォッチャーの追加」）

メールの件名(Subject)

メールの件名がチケットの「題名」として登録されます。

メール本文

メール本文の内容がチケットの「説明欄」に登録されます。

本文では、説明欄に登録すべき内容とは別に、プロジェクト識別子やトラッカー名などチケットの属性を “属性名: 値” の形式で指定します。属性の一覧はメール本文の冒頭または末尾に記述してください。属性の一覧と説明欄の内容との間には空行が必要です。

メール本文の例:

○月○日打ち合わせの議事録を作成してWikiに掲載し、関係者に連絡する。

project: some-system-dev
tracker: サポート
assigned to: yuka
due date: 2024-09-23

メール本文で指定可能な属性

メール本文内で指定可能な属性を下表に示します。

My Redmineでは新規チケットを登録するときは project は必須です(プロジェクト固有アドレスに送信する場合を除く)。また、チケットに必須入力のカスタムフィールドが存在する場合や、Redmineの設定によりカテゴリ、開始日、期日を必須入力にしている場合はそれらに対応する属性も必須です。

使用できる属性の一覧は、メールによるチケット登録で使用できるキーワードをご覧ください。

属性名	値の内容・形式	説明
project	プロジェクト識別子 ※プロジェクト名ではありません	新しいチケットを登録するプロジェクト。 My Redmineでは新規チケット登録時はこの属性は必須。返信で既存チケットを更新する場合は不要。
tracker	トラッカー名 (例: バグ)	新たに登録するチケットのトラッカー。省略時は「管理」→「トラッカー」画面で一番上にあるトラッカーが使用される。
category	カテゴリ名	新たに登録するチケットのカテゴリ。
priority	優先度の名称 (例: 急いで)	チケットの優先度。省略時は「管理」→「選択肢の値」で指定されているデフォルト値が使用される。
status	ステータスの名称 (例: 解決)	チケットのステータス。省略時は「管理」→「チケットのステータス」で指定されているデフォルト値が使用される。
assigned to	ログインID またはメールアドレス	チケットの担当者。指定されたログインIDかメールアドレスが一致するユーザーが担当者に設定される。
start date	YYYY-MM-DD (例: 2019-11-03)	チケットの開始日。省略時はチケット登録日。
due date	YYYY-MM-DD (例: 2019-11-03)	チケットの期日。
カスタムフィールド名		チケットのカスタムフィールドの値。

添付ファイル

メールの添付ファイルはチケットの添付ファイルとして登録されます。

ただし、ファイルサイズが「管理」→「設定」→「ファイル」→「添付ファイルサイズの上限」の設定値を越えるものは無視されます。

メールを送信してチケット更新

件名に “Re: [xxxxxxx #123]” のような形式の文字列が含まれていれば、そのメールは返信として扱われ、新しいチケットが追加されるのではなく既存チケット #123 に注記が追加されます。

返信扱いの件名の例:

既存チケットを更新する際の件名例

返信扱いで既存チケットを更新する場合、メール本文にproject属性の指定は不要です。

うまくいかない時は

以下の原因によって登録できないことが多いです。

Redmineのユーザーとして登録されていないメールアドレスから送信している
project キーワードが漏れている
必須入力のフィールドの入力漏れ

メールによるチケット登録に失敗すると、エラーコードをお客様のメールサーバに返します。お客様側のメールサーバの設定によって、エラーメールが送られる場合もあれば送られない場合もあります。
My Redmineではチケット登録に失敗時のエラーメールは送信しません。

参考：メールによるチケット登録で発生するエラーの意味と対処方法

解決できない場合は Webサポート窓口までご連絡ください。