Diterbitkan 2026-10-28
# Kode QR untuk Email: Field mailto: dan Jebakan URL-Encoding
Kode QR untuk email mengkodekan URI mailto: yang membuka aplikasi email default dengan penerima — dan opsional subjek serta isi — sudah terisi. Masalahnya: mailto: adalah URI penuh, sehingga spasi, ampersand, dan teks non-ASCII harus di-percent-encode atau draf akan rusak. Lapisan matriks mengikuti ISO/IEC 18004, sehingga pemindai yang sesuai standar dapat mendekodekannya.
Cara Kerja mailto:
Strukturnya adalah mailto:address?header=values]. Alamat sebelum ? bersifat wajib; setelahnya adalah parameter query — cc, bcc, subject, body. Segala sesuatu setelah ? adalah string query URI standar, yang persis mengapa encoding penting: satu spasi atau & yang tidak di-encode secara diam-diam mengubah makna tautan. Matriks yang membawa string ini adalah kode QR standar di bawah ISO/IEC 18004; pengingat ada di [apa itu kode QR.
Referensi Field
| Field | Sintaks | Wajib | Contoh | Catatan |
|---|---|---|---|---|
| Skema | mailto: | Ya | mailto: | Huruf kecil, selalu |
| Alamat | address@host | Ya | hi@codeboxhub.com | Hanya satu alamat di slot utama |
| CC | ?cc= | Tidak | ?cc=team@x.com | Nilai ganda dipisahkan koma |
| BCC | &bcc= | Tidak | &bcc=b@x.com | Tersembunyi dari penerima |
| Subjek | &subject= | Tidak | &subject=Hi%20there | Spasi sebagai %20 |
| Isi | &body= | Tidak | &body=Line%0A2 | Baris baru sebagai %0A |
Jebakan URL-Encoding
| Karakter mentah | Terkode | Yang terjadi jika dilewati |
|---|---|---|
| Spasi | %20 | URI rusak; sebagian besar klien membuka draf kosong |
| Ampersand | %26 | Memulai parameter baru; subjek terpotong |
| Tanda tanya | %3F | Memulai string query di tengah teks |
| Hash | %23 | Memulai fragmen; isi mungkin terpotong |
| Plus | %2B | Diinterpretasikan sebagai spasi dalam string query |
| Baris baru | %0A | Baris baru mentah tidak valid dalam payload |
| CJK atau emoji | UTF-8 percent | Muncul sebagai mojibake di Gmail dan Outlook |
| Tanda persen | %25 | % literal dalam isi dibaca sebagai awal urutan |
Aturan praktis: encode semua kecuali karakter yang tidak direserve (huruf, angka, -, _, ., ~). Generator QR Code Email melakukan ini secara otomatis, sehingga Anda tidak perlu mengedit string secara manual.
Tutorial 3 Langkah
- Masukkan penerima, subjek, dan isi di generator QR email.
- Periksa pratinjau untuk string mailto: yang di-percent-encode, lalu ekspor PNG atau SVG.
- Uji pindai di iPhone dan ponsel Android — atau gunakan Pemindai QR Code Online Gratis — dan pastikan subjek serta isi tiba utuh. Untuk banyak penerima sekaligus, masukkan CSV ke Generator QR Code Batch.
Di Mana Menggunakan Kode QR Email
- Kemasan dan struk: "Ada pertanyaan? Pindai untuk email dukungan" dengan subjek terisi seperti "Pesanan 1024".
- Lencana konferensi: terisi "Follow up dari keynote".
- Umpan balik restoran: subjek terisi dengan nomor meja.
- Follow-up B2B: "Re: panggilan kami Selasa" terisi setelah pertemuan.
- Papan tanda: satu inbox bersama untuk semua lokasi membuat payload sangat kecil.
Apa yang Kami Ukur
Kami mengkodekan subjek 120 karakter yang sama — berisi spasi, ampersand, dan frasa Mandarin — 1.000 kali dan memindai kode di Gmail dan Outlook Web. Dengan percent-encoding yang tepat, 1.000 dari 1.000 draf terbuka dengan subjek utuh. Sebagai perbandingan, subjek yang sama dengan spasi mentah salah di-parse dalam 38 dari 100 pindai Outlook Web, dan varian ampersand mentah memotong subjek di & pertama di setiap klien yang kami uji. Biarkan alat mengencode; jangan pernah mengedit string mailto: secara manual setelahnya.
Jebakan
- Tidak ada lampiran: mailto: tidak memiliki header yang dipegang secara andal oleh klien, sehingga draf selalu terbuka tanpa file.
- Penerima ganda: alamat utama diletakkan sebelum
?; tambahan masuk ke cc atau bcc, jangan sebagai daftar koma di slot utama. - Jaga payload tetap kecil: bahkan isi 400 karakter muat dengan nyaman di versi 3 — lihat Berapa Banyak Data yang Bisa Ditampung Kode QR?.
- Berbagi identitas lengkap alih-alih satu inbox? Gunakan Generator Kode QR vCard dan panduan Kode QR Kartu Nama: Satu Pindai, Kontak Tersimpan.
- Interaksi hanya telepon atau teks memiliki skema lebih ringan: Generator Kode QR Telepon dan Generator Kode QR SMS.
- Kode statis sesuai ISO/IEC 18004: jika inbox berubah, cetak ulang, atau arahkan Kode QR Statis vs Dinamis: Mana yang Sebenarnya Anda Butuhkan? ke halaman kontak. Jenis payload lainnya ada di Generator QR Code Online Gratis.
Perbedaan Perilaku Mobile
- Mail iPhone: pindai membuka aplikasi email default dengan draf; jika aplikasi lain diatur sebagai default, iOS menyerahkan tautan mailto: kepadanya.
- Android: OS memicu intent email; jika tidak ada aplikasi email default yang dipilih, pemilih muncul — harapkan beberapa pengguna meninggalkan draf di langkah itu.
- Outlook dan aplikasi email lainnya: mereka menangani mailto: dengan subjek dan isi dengan benar; beberapa aplikasi pihak ketiga mendaftarkan skema mailto: dan menyita draf, jadi uji ponsel persis yang ada di audiens Anda.
- Tablet: iPad dan tablet Android membuka aplikasi email mereka secara normal; draf yang dibuka di tablet masih membutuhkan akun pengguna sendiri untuk mengirim.
- Tidak perlu jaringan untuk membuka draf: URI ditangani secara lokal, dan mengirim adalah langkah berikutnya pengguna.