CodeBox Hub
無料

メール用QRコード: mailto: フィールドとURLエンコードの落とし穴

mailto:スキームでメールアドレス、件名、本文をエンコードします。フィールド表、URLエンコードの落とし穴、3ステップのチュートリアル。

# メール用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エンコードの落とし穴

元の文字エンコード後エンコードをスキップした場合の挙動
スペース%20URIが壊れる。ほとんどのクライアントで空のドラフトが開く
アンパサンド%26新しいパラメータの開始と解釈され、件名が切り詰められる
クエスチョンマーク%3Fテキストの途中でクエリ文字列が開始される
ハッシュ%23フラグメントの開始と解釈され、本文が切断される可能性がある
プラス%2Bクエリ文字列ではスペースとして解釈される
改行%0A生の改行はペイロードでは無効
CJKまたは絵文字UTF-8パーセントGmailやOutlookで文字化けする
パーセント記号%25本文の文字通り%がシーケンスの開始として読み取られる
カンマ%2C一部のクライアントでccリストがカンマで分割される

基本ルール: 予約外文字(英字、数字、-、_、.、~)以外のすべてをエンコードしてください。オンラインメールQRコード生成はこれを自動で行うため、文字列を手動で編集する必要はありません。

3ステップのチュートリアル

  1. メールQRジェネレーターに受信者、件名、本文を入力します。
  2. パーセントエンコードされたmailto: 文字列のプレビューを確認し、PNGまたはSVGとしてエクスポートします。
  3. iPhoneとAndroidスマートフォンでテストスキャンします。または無料オンラインQRコードスキャナーを使用し、件名と本文がそのまま届くことを確認します。多数の受信者に一度に送る場合は、CSVをバッチQRコード生成に読み込ませます。

メールQRコードの使用場面

  • パッケージやレシート: 「ご質問はありますか? スキャンしてサポートへメール」で、件名に「注文番号 1024」などをプリフィル。
  • 会議バッジ: 「キーノートからのフォローアップ」をプリフィル。
  • レストランのフィードバック: 件名にテーブル番号をプリフィル。
  • B2Bフォローアップ: 会議後に「火曜日の電話について」をプリフィル。
  • サイン表示: 全店舗で1つの共有受信トレイを使用すると、ペイロードを小さく保てます。

測定結果

スペース、アンパサンド、中国語のフレーズを含む同じ120文字の件名を1,000回エンコードし、GmailとOutlook Webでスキャンしました。適切なパーセントエンコードにより、1,000件中1,000件が件名がそのままの状態でドラフトが開きました。比較のため、生のスペースを含む同じ件名はOutlook Webの100件中38件で誤解析され、生のアンパサンドを含むバリアントはテストしたすべてのクライアントで最初の & で件名が切り詰められました。ツールにエンコードさせ、その後mailto: 文字列を手動で編集しないでください。

落とし穴

モバイルの挙動の違い

  • iPhone Mail: スキャンするとドラフトが開いた状態でデフォルトのメールアプリが開きます。別のアプリがデフォルトに設定されている場合、iOSはmailto: リンクをそのアプリに引き渡します。
  • Android: OSがメールインテントを発火します。デフォルトのメールアプリが選択されていない場合、選択画面が表示されます — このステップでドラフトを中断するユーザーが一部いることを想定してください。
  • Outlookおよび他のメールアプリ: 件名と本文を含むmailto: を正しく処理します。一部のサードパーティ製アプリはmailto: スキームを登録し、ドラフトをインターセプトするため、ターゲットオーディエンスの正確なスマートフォンでテストしてください。
  • タブレット: iPadとAndroidタブレットは通常通りメールアプリを開きます。タブレットで開いたドラフトも、送信にはユーザー自身のアカウントが必要です。
  • ドラフトを開くためにネットワークは不要です: URIはローカルで処理され、送信はユーザーの次のステップです。

よくある質問

メール用QRコードは何をしますか?

受信者をプリフィルした状態でデフォルトのメールアプリを開き、含めた場合は件名と本文もプリフィルします。メールを送信することはありません。

QRコードでGmailを直接開くことはできますか?

いいえ。mailto: スキームは、スマートフォンがデフォルトとして扱うメールアプリを開きます。Gmailを強制することはできません。

mailto: リンクでURLエンコードが必要な文字はどれですか?

スペース、アンパサンド、クエスチョンマーク、ハッシュ、プラス記号、および非ASCIIテキストです。これらを%20、%26、%3F、%23、%2B、およびUTF-8パーセントシーケンスとしてエンコードしてください。

メールQRコードでファイルを添付できますか?

いいえ。mailto: スキームには信頼できる添付メカニズムがないため、ドラフトは常に添付ファイルなしで開きます。

メールQRコードはiPhoneとAndroidで動作しますか?

はい。両方のシステムはmailto: をシステムURIとして扱い、何もインストールせずにデフォルトのメールアプリを開きます。

mailto: QRと連絡先QRコードの違いは何ですか?

mailto: コードは単一のメールドラフトを開始しますが、vCard連絡先コードは名前、電話番号、会社名など、人物全体をアドレス帳に追加します。

mailto: QRコードに返信先アドレスを入れることができますか?

信頼できません。ほとんどのクライアントはmailto: URI内のreply-toを無視するため、返信パスはプライマリアドレスにのみ保持してください。

関連記事

お問い合わせ