ユーザーガイド

ローカルパートに使用できる文字は、英数字と一部記号「! # $ % & ' * + - / = ? ^ \ _ ` { | } ~」です。
その他に、先頭以外で「.」も使用できます。（連続する「.」は、仕様上は使用できませんが、後述のローカルパートの例外を適用して使用可能にしています）

ドメインパート

ドメインパートに使用できる文字は、英数字と「.」「-」「_」です。
ただし、「.」は先頭、最後には使用できません。
また、連続する「.」も使用できません。
「.」で区切られた各文字列の先頭は英数字に限ります。

ローカルパートの例外

ローカルパートに使用できない文字が含まれている場合は、us-ascii の範囲内であれば " " で括ることで使用できます。
" " で括る場合には、「"」は「\"」に、「\」は「\\」に変換します。
" " で括られていなく使用できないローカルパートでも括れば使用できる場合には、内部的に " " で括って受け入れます。（メール送信時に括ります。）

" " で括れば使用できる例

使用できない文字を含む	" " で括って使用できる	説明
irregular..pattern@example.com	"irregular..pattern"@example.com	`.`が連続している例
hello\(^^)@example.com	"hello\\(^^)"@example.com	`\`をエスケープする例

ドメインパートの「`_`」

「_」は、仕様上、ドメイン名に使用できません。

しかし、DNS に設定できるため、「_」を含むサブドメインやホスト名が運用されているケースがあります。そのために、本システムでは「_」を使用できるようにしています。

メールアドレスの長さ

メールアドレスはSMTPのルール上256バイトまでです。

しかし、実際にはそれを超えるメールアドレスが使用されています。そのためにメールアドレスとしての長さチェックは行っていませんが、SMTPのルール上1行1000バイトまでであるため、RCPT TOコマンドがこの長さに収まる必要があります。

メールアドレスの比較

本システムでのメールアドレスの検索や登録を行うときのメールアドレスの比較では、大文字小文字は区別しません。

参考例

「who@example.com」は「Who@Exmple.Com」でも、同じメールアドレスとして扱います。

フィルタ

管理コンソールでは、メールヘッダと値の組み合わせで動作条件を設定することができます。この動作条件をフィルタと呼びます。

ヘッダ名

ヘッダ名に"To"を指定した場合、envelope-to の値を評価します。

ヘッダ名には、From, Subject, およびアプリケーションが付与した拡張メールヘッダ(X-priorityなど)を指定することができます。ヘッダ名は大文字小文字を無視してマッチします。

動作条件の注意点

Received など複数現れるメールヘッダは動作条件に指定できません。

ヘッダ値

ヘッダ値には値を評価するための正規表現を指定します。

例えば、To (envelope-to) のドメイン部分をマッチさせたい場合、.+@example\\.com と記述します。ローカルパートを含めたメールアドレスのフルマッチを指定する場合、user-name@example\\.com と記述します。

From指定によるマッチングの注意点

ヘッダ名にFromを指定し、メールアドレスをマッチさせたい場合は、.*user-name@example\.com.*と記述します。ヘッダ値は、「"氏名" <メールアドレス> 」とメールアドレス前後に文字列が付与されるケースがあります。

以下に代表的な正規表現の構文を説明します。使用可能な全ての構文については、Java Patternを参照ください。

構文	説明
x	文字 x
\\	バックスラッシュ文字
.	任意の1文字（ドットを表現したい場合、\でエスケープする必要があります）
X?	X 1 または 0回
X*	X 0 回以上
X+	X 1 回以上
X{n}	X n回
X{n,}	X n回以上
X{n,m}	X n回以上 m回以下
[abc]	a,b,または,c
[^abc]	a,b,c 以外の文字
[a-zA-Z]	a～z, A～Z (範囲)

配信ステータス

Customers Mail Cloudは、メール1通ごとの状態を4つのステータスで記録しています。このステータスを配信ステータスと呼びます。

配信ステータスは、配信グラフや配信ログに表示されます。また、APIで配信データを取得する際にリクエストパラメータとして指定します。

ステータス	説明
queued	メールリレー元サーバーからメールを受信した。
succeeded	SMTP通信が成功し、宛先サーバーにメールが送信できた。
failed	SMTP通信が失敗し、宛先サーバーにメールが送信できなかった。
deferred	宛先サーバーから一時エラー応答があったため、メールを再送している。

配信完了後にエラーログが表示される場合は

配信のログの中で、succeededになった後、エラーログに表示されるメールがある場合があります。

これは、Customers Mail Cloud の配送は成功しましたが、その後宛先のメールサーバーから何らかのバウンスが返ったものを表示しているもので、結果的には送信失敗になります。

この場合はエラーログのエラー理由を確認し、宛先のメールサーバーの管理者にお問い合わせください。

エラーステータス

メール送信時にエラーが発生した場合、SMTP応答メッセージまたはバウンスメールを解析し、Customers Mail Cloudが定義したステータスを記録します。これをエラーステータスと呼びます。

エラーステータスは、エラーグラフやエラーログに表示されます。また、APIで送信エラーデータを取得する際にリクエストパラメータとして指定します。

ステータス	エラー理由	発生原因
1	ホスト不明	DNSによるホスト解決ができなかった。
2	ユーザ不明	メールアドレスが存在しない。
3	再送タイムアウト	宛先サーバーへ接続できないまたは一時エラー応答が返されたため、再送を行ったが時間内に再送が完了しなかった。
4	受信拒否	宛先サーバーのポリシーによりメール受信を拒否された。
5	容量オーバー	メールボックスの容量やメールサーバーのディスク領域の制限を超えたため、宛先サーバーがメールを受信できなかった。
6	転送エラー	送信した宛先アドレスと異なるアドレスへのメール送信が失敗した。受信者側の設定で宛先アドレスにメールを保存した後、別アドレスに転送している場合、宛先アドレスにはメールが届いている可能性がある。
7	受信サーバエラー	宛先サーバーの設定ミスによりメール送信が失敗した（25番ポートにSMTP認証を設定している、DNSによるホスト解決を行って接続したにもかかわらず宛先メールアドレスを管理していないなど）。
8	サイズオーバー	メールサイズが大きすぎるため、宛先サーバーが受信を拒否した。
9	アドレス形式エラー	宛先メールアドレスがメールアドレスの形式に従っていない。
10	配信停止アドレス	配信停止機能にてメールの送信を抑止した。
99	その他エラー	宛先サーバーが恒久エラーを応答したため、メール送信に失敗した。

ユーザーガイド

表記について

サービスプラン

ドメイン

推奨ブラウザ

API

送信者認証

レポート

レポート保持期間

設定

管理

共通仕様

TLSバージョン

メールアドレス

ローカルパート