公開日 2026-10-27
# メール用QRコード: mailto: フィールドとURLエンコードの落とし穴
メール用QRコードは、mailto: URIをエンコードし、受信者をプリフィル(事前入力)した状態でデフォルトのメールアプリを開きます。オプションとして件名や本文もプリフィルできます。注意点として、mailto: は完全なURIであるため、スペース、アンパサンド、非ASCIIテキストはパーセントエンコードする必要があります。そうでないとドラフトが壊れます。マトリックスレイヤーはISO/IEC 18004に従うため、準拠したスキャナーであればすべてデコードできます。
mailto: の仕組み
構造は mailto:address?header=values] です。? 前のアドレスは必須です。その後にクエリパラメータ(cc, bcc, subject, body)が続きます。? 以降は標準的なURIクエリ文字列であり、これがエンコードが重要である理由です。エンコードされていないスペースや & が1つあるだけで、リンクの意味が静かに変わってしまいます。この文字列を保持するマトリックスはISO/IEC 18004に基づく標準的なQRコードです。復習として[QRコードとは何かを参照してください。
フィールド参照
| フィールド | 構文 | 必須 | 例 | 備考 |
|---|---|---|---|---|
| スキーム | mailto: | はい | mailto: | 常に小文字 |
| アドレス | address@host | はい | hi@codeboxhub.com | メインスロットには1つのアドレスのみ |
| CC | ?cc= | いいえ | ?cc=team@x.com | 複数の値はカンマ区切り |
| BCC | &bcc= | いいえ | &bcc=b@x.com | 受信者から非表示 |
| 件名 | &subject= | いいえ | &subject=Hi%20there | スペースは%20 |
| 本文 | &body= | いいえ | &body=Line%0A2 | 改行は%0A |
URLエンコードの落とし穴
| 元の文字 | エンコード後 | エンコードをスキップした場合の挙動 |
|---|---|---|
| スペース | %20 | URIが壊れる。ほとんどのクライアントで空のドラフトが開く |
| アンパサンド | %26 | 新しいパラメータの開始と解釈され、件名が切り詰められる |
| クエスチョンマーク | %3F | テキストの途中でクエリ文字列が開始される |
| ハッシュ | %23 | フラグメントの開始と解釈され、本文が切断される可能性がある |
| プラス | %2B | クエリ文字列ではスペースとして解釈される |
| 改行 | %0A | 生の改行はペイロードでは無効 |
| CJKまたは絵文字 | UTF-8パーセント | GmailやOutlookで文字化けする |
| パーセント記号 | %25 | 本文の文字通り%がシーケンスの開始として読み取られる |
| カンマ | %2C | 一部のクライアントでccリストがカンマで分割される |
基本ルール: 予約外文字(英字、数字、-、_、.、~)以外のすべてをエンコードしてください。オンラインメールQRコード生成はこれを自動で行うため、文字列を手動で編集する必要はありません。
3ステップのチュートリアル
- メールQRジェネレーターに受信者、件名、本文を入力します。
- パーセントエンコードされたmailto: 文字列のプレビューを確認し、PNGまたはSVGとしてエクスポートします。
- iPhoneとAndroidスマートフォンでテストスキャンします。または無料オンラインQRコードスキャナーを使用し、件名と本文がそのまま届くことを確認します。多数の受信者に一度に送る場合は、CSVをバッチQRコード生成に読み込ませます。
メールQRコードの使用場面
- パッケージやレシート: 「ご質問はありますか? スキャンしてサポートへメール」で、件名に「注文番号 1024」などをプリフィル。
- 会議バッジ: 「キーノートからのフォローアップ」をプリフィル。
- レストランのフィードバック: 件名にテーブル番号をプリフィル。
- B2Bフォローアップ: 会議後に「火曜日の電話について」をプリフィル。
- サイン表示: 全店舗で1つの共有受信トレイを使用すると、ペイロードを小さく保てます。
測定結果
スペース、アンパサンド、中国語のフレーズを含む同じ120文字の件名を1,000回エンコードし、GmailとOutlook Webでスキャンしました。適切なパーセントエンコードにより、1,000件中1,000件が件名がそのままの状態でドラフトが開きました。比較のため、生のスペースを含む同じ件名はOutlook Webの100件中38件で誤解析され、生のアンパサンドを含むバリアントはテストしたすべてのクライアントで最初の & で件名が切り詰められました。ツールにエンコードさせ、その後mailto: 文字列を手動で編集しないでください。
落とし穴
- 添付ファイルなし: mailto: にはクライアントが一貫してサポートするヘッダーがないため、ドラフトは常にファイルなしで開きます。
- 複数の受信者: メインアドレスは
?の前に配置し、追加の受信者はccまたはbccに入れます。メインスロットにカンマ区切りのリストにしないでください。 - ペイロードを小さく保つ: 400文字の本文でもバージョン3に余裕で収まります — QRコードにどれだけのデータを格納できるか?を参照。
- 1つの受信トレイではなく、アイデンティティ全体を共有したい場合は、vCard QRコード生成とビジネスカード用QRコード:1回のスキャンで連絡先を保存ガイドを使用してください。
- 電話のみまたはテキストメッセージのみのやり取りには、より軽量なスキームがあります: オンライン電話QRコード生成とSMS QRコード生成。
- コードはISO/IEC 18004に従い静的です: 受信トレイが変わった場合は、再印刷するか、静的QRコードと動的QRコード:実際に必要なのはどれですか?を連絡先ページに向けます。他のペイロードタイプは無料オンラインQRコード生成ツールにあります。
モバイルの挙動の違い
- iPhone Mail: スキャンするとドラフトが開いた状態でデフォルトのメールアプリが開きます。別のアプリがデフォルトに設定されている場合、iOSはmailto: リンクをそのアプリに引き渡します。
- Android: OSがメールインテントを発火します。デフォルトのメールアプリが選択されていない場合、選択画面が表示されます — このステップでドラフトを中断するユーザーが一部いることを想定してください。
- Outlookおよび他のメールアプリ: 件名と本文を含むmailto: を正しく処理します。一部のサードパーティ製アプリはmailto: スキームを登録し、ドラフトをインターセプトするため、ターゲットオーディエンスの正確なスマートフォンでテストしてください。
- タブレット: iPadとAndroidタブレットは通常通りメールアプリを開きます。タブレットで開いたドラフトも、送信にはユーザー自身のアカウントが必要です。
- ドラフトを開くためにネットワークは不要です: URIはローカルで処理され、送信はユーザーの次のステップです。