Đăng ngày 2026-10-28
# Mã QR cho Email: Các trường mailto: và Lỗi URL-Encoding
Mã QR cho email mã hóa một URI mailto: mở ứng dụng email mặc định với người nhận — và tùy chọn cả chủ đề và nội dung — được điền sẵn. Lưu ý: mailto: là một URI đầy đủ, nên các khoảng trắng, dấu & và văn bản không ASCII phải được percent-encode, nếu không bản nháp sẽ bị lỗi. Lớp ma trận tuân theo ISO/IEC 18004, do đó bất kỳ máy quét nào tương thích đều giải mã được.
Cách mailto: hoạt động
Cấu trúc là mailto:address?header=values]. Địa chỉ trước dấu ? là bắt buộc; sau đó là các tham số truy vấn — cc, bcc, subject, body. Mọi thứ sau dấu ? là chuỗi truy vấn URI tiêu chuẩn, đây chính là lý do mã hóa quan trọng: một khoảng trắng hoặc & không được mã hóa sẽ âm thầm thay đổi ý nghĩa của liên kết. Ma trận chứa chuỗi này là mã QR tiêu chuẩn theo ISO/IEC 18004; bạn có thể xem lại tại [mã QR là gì.
Tham chiếu trường
| Trường | Cú pháp | Bắt buộc | Ví dụ | Ghi chú |
|---|---|---|---|---|
| Scheme | mailto: | Có | mailto: | Chữ thường, luôn luôn |
| Địa chỉ | address@host | Có | hi@codeboxhub.com | Chỉ một địa chỉ trong trường chính |
| CC | ?cc= | Không | ?cc=team@x.com | Nhiều giá trị phân tách bằng dấu phẩy |
| BCC | &bcc= | Không | &bcc=b@x.com | Ẩn với người nhận |
| Chủ đề | &subject= | Không | &subject=Hi%20there | Khoảng trắng là %20 |
| Nội dung | &body= | Không | &body=Line%0A2 | Xuống dòng là %0A |
Lỗi URL-Encoding
| Ký tự gốc | Đã mã hóa | Điều gì xảy ra nếu bỏ qua |
|---|---|---|
| Khoảng trắng | %20 | URI bị lỗi; hầu hết client mở bản nháp trống |
| Dấu & | %26 | Bắt đầu tham số mới; chủ đề bị cắt |
| Dấu hỏi | %3F | Bắt đầu chuỗi truy vấn giữa văn bản |
| Dấu # | %23 | Bắt đầu fragment; nội dung có thể bị cắt |
| Dấu + | %2B | Được hiểu là khoảng trắng trong chuỗi truy vấn |
| Xuống dòng | %0A | Xuống dòng thô không hợp lệ trong payload |
| CJK hoặc emoji | UTF-8 percent | Hiển thị lỗi ký tự trong Gmail và Outlook |
| Dấu % | %25 | Dấu % trong nội dung được đọc là bắt đầu chuỗi |
| Dấu phẩy | %2C | Một số client tách danh sách cc tại dấu phẩy |
Quy tắc chung: mã hóa mọi thứ ngoại trừ các ký tự không dự trữ (chữ cái, chữ số, -, _, ., ~). Trình tạo mã QR Email thực hiện điều này tự động, nên bạn không bao giờ phải chỉnh sửa thủ công chuỗi.
Hướng dẫn 3 bước
- Nhập người nhận, chủ đề và nội dung vào trình tạo mã QR email.
- Kiểm tra bản xem trước chuỗi mailto: đã percent-encode, sau đó xuất PNG hoặc SVG.
- Quét thử trên iPhone và điện thoại Android — hoặc sử dụng Trình quét mã QR trực tuyến — và xác nhận chủ đề và nội dung đến nguyên vẹn. Đối với nhiều người nhận cùng lúc, đưa CSV vào Trình tạo mã QR hàng loạt.
Nơi sử dụng mã QR Email
- Bao bì và hóa đơn: "Có câu hỏi? Quét để email hỗ trợ" với chủ đề điền sẵn như "Đơn hàng 1024".
- Thẻ hội nghị: điền sẵn "Theo dõi từ bài phát biểu chính".
- Phản hồi nhà hàng: chủ đề điền sẵn với số bàn.
- Theo dõi B2B: "Re: cuộc gọi thứ Ba của chúng ta" điền sẵn sau cuộc họp.
- Biển hiệu: một hộp thư chung cho tất cả các địa điểm giữ payload nhỏ gọn.
Những gì chúng tôi đo lường
Chúng tôi mã hóa cùng một chủ đề 120 ký tự — chứa khoảng trắng, dấu & và một cụm từ tiếng Trung — 1.000 lần và quét các mã trong Gmail và Outlook Web. Với percent-encode đúng, 1.000/1.000 bản nháp mở với chủ đề nguyên vẹn. Để so sánh, cùng chủ đề với khoảng trắng thô bị phân tích sai trong 38/100 lần quét Outlook Web, và biến thể dấu & thô cắt chủ đề tại dấu & đầu tiên trên mọi client chúng tôi kiểm tra. Hãy để công cụ mã hóa; không bao giờ chỉnh sửa thủ công chuỗi mailto: sau đó.
Bẫy thường gặp
- Không có tệp đính kèm: mailto: không có header nào mà client tôn trọng đáng tin cậy, nên bản nháp luôn mở mà không có tệp.
- Nhiều người nhận: địa chỉ chính đặt trước dấu
?; các địa chỉ khác vào cc hoặc bcc, không bao giờ là danh sách dấu phẩy trong trường chính. - Giữ payload nhỏ: ngay cả nội dung 400 ký tự cũng vừa vặn trong phiên bản 3 — xem Mã QR có thể chứa bao nhiêu dữ liệu?.
- Chia sẻ toàn bộ danh tính thay vì một hộp thư? Sử dụng Trình tạo mã QR vCard và hướng dẫn Mã QR Thẻ Danh Thiếp: Quét một lần, lưu liên hệ.
- Tương tác chỉ gọi điện hoặc chỉ nhắn tin có scheme nhẹ hơn: Trình tạo mã QR điện thoại và Trình tạo mã QR SMS.
- Mã là tĩnh theo ISO/IEC 18004: nếu hộp thư thay đổi, in lại hoặc trỏ Mã QR tĩnh và mã QR động: Bạn thực sự cần loại nào? đến trang liên hệ. Các loại payload khác nằm trong Trình tạo mã QR trực tuyến miễn phí.
Sự khác biệt hành vi trên di động
- iPhone Mail: quét mở ứng dụng email mặc định với bản nháp; nếu ứng dụng khác được đặt làm mặc định, iOS chuyển liên kết mailto: cho nó.
- Android: hệ điều hành kích hoạt intent email; nếu không chọn ứng dụng email mặc định, trình chọn hiện ra — kỳ vọng một số người dùng sẽ bỏ bản nháp ở bước đó.
- Outlook và các ứng dụng email khác: chúng xử lý mailto: với chủ đề và nội dung đúng; một số ứng dụng bên thứ ba đăng ký scheme mailto: và chặn bản nháp, nên kiểm tra chính xác các điện thoại trong đối tượng của bạn.
- Máy tính bảng: iPad và máy tính bảng Android mở ứng dụng email bình thường; bản nháp mở trên máy tính bảng vẫn cần tài khoản của người dùng để gửi.
- Không cần mạng để mở bản nháp: URI được xử lý cục bộ, và gửi là bước tiếp theo của người dùng.