게시일 2026-10-27
# 이메일용 QR 코드: mailto: 필드 및 URL 인코딩 주의사항
이메일용 QR 코드는 수신자가 미리 입력된 상태(제목 및 본문 선택 가능)로 기본 메일 앱을 여는 mailto: URI를 인코딩합니다. 주의할 점은 mailto:가 완전한 URI이므로 공백, 앰퍼샌드 및 비-ASCII 텍스트는 백분율 인코딩(percent-encoding)을 해야 초안이 깨지지 않는다는 것입니다. 매트릭스 레이어는 ISO/IEC 18004를 따르므로 모든 준수 스캐너가 이를 디코딩할 수 있습니다.
mailto: 작동 방식
구조는 mailto:address?header=values]입니다. ? 앞의 주소는 필수이며, 그 뒤에는 cc, bcc, subject, body와 같은 쿼리 매개변수가 옵니다. ? 이후의 모든 내용은 표준 URI 쿼리 문자열이므로 인코딩이 중요한 이유입니다: 인코딩되지 않은 공백이나 & 하나만으로도 링크의 의미가 조용히 변할 수 있습니다. 이 문자열을 담고 있는 매트릭스는 ISO/IEC 18004에 따른 표준 QR 코드이며, 복습은 [QR 코드란 무엇인가에서 확인하세요.
필드 참조
| 필드 | 구문 | 필수 | 예시 | 비고 |
|---|---|---|---|---|
| 스킴 | mailto: | 예 | mailto: | 항상 소문자 |
| 주소 | address@host | 예 | hi@codeboxhub.com | 메인 슬롯에는 주소 하나만 |
| 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에서 깨진 문자(mojibake)로 표시됩니다 |
| 백분율 기호 | %25 | 본문에 있는 리터럴 %가 시퀀스의 시작으로 읽힙니다 |
| 쉼표 | %2C | 일부 클라이언트가 cc 목록을 쉼표 기준으로 분리합니다 |
기본 규칙: 예약되지 않은 문자(문자, 숫자, -, _, ., ~)를 제외하고는 모두 인코딩하세요. 이메일 QR 코드 생성기는 이를 자동으로 처리하므로 문자열을 수동으로 편집할 필요가 없습니다.
3단계 튜토리얼
- 이메일 QR 생성기에 수신자, 제목 및 본문을 입력합니다.
- 백분율 인코딩된 mailto: 문자열이 포함된 미리보기를 확인한 후 PNG 또는 SVG로 내보냅니다.
- iPhone과 Android 휴대폰에서 테스트 스캔을 수행하거나 무료 온라인 QR 코드 스캐너를 사용하여 제목과 본문이 온전히 전달되는지 확인합니다. 여러 수신자에게 한 번에 보내려면 CSV를 일괄 QR 코드 생성기에 입력하세요.
이메일 QR 코드 사용처
- 포장재 및 영수증: "질문이 있으신가요? 스캔하여 지원팀에 이메일 보내기"와 함께 "주문 1024"와 같은 제목이 미리 입력됩니다.
- 컨퍼런스 배지: "키노트 발표 후 후속 조치"가 미리 입력됩니다.
- 식당 피드백: 테이블 번호가 제목으로 미리 입력됩니다.
- B2B 후속 조치: 회의 후 "Re: 화요일 통화 관련"이 미리 입력됩니다.
- 사이니지: 모든 지점에서 공유하는 단일 수신함을 사용하면 페이로드를 매우 작게 유지할 수 있습니다.
측정 결과
공백, 앰퍼샌드 및 중국어 구문을 포함한 동일한 120자 제목을 1,000회 인코딩하고 Gmail 및 Outlook Web에서 코드를 스캔했습니다. 적절한 백분율 인코딩을 적용했을 때, 1,000건 중 1,000건의 초안이 제목이 온전한 상태로 열렸습니다. 비교를 위해, 원본 공백이 포함된 동일한 제목은 Outlook Web 스캔 100건 중 38건에서 잘못 파싱되었으며, 원본 앰퍼샌드 변형은 테스트한 모든 클라이언트에서 첫 번째 & 위치에서 제목이 잘렸습니다. 도구가 인코딩하도록 하세요. 이후에 mailto: 문자열을 수동으로 편집하지 마세요.
주의사항
- 첨부파일 없음: mailto:에는 클라이언트가 안정적으로 준수하는 헤더가 없으므로 초안은 항상 파일 없이 열립니다.
- 여러 수신자: 주요 주소는
?앞에, 추가 수신자는 cc 또는 bcc에 넣어야 하며, 메인 슬롯에 쉼표 목록으로 넣으면 안 됩니다. - 페이로드를 작게 유지하세요: 400자 본문도 버전 3에 여유 있게 들어갑니다 — QR 코드에 얼마나 많은 데이터를 담을 수 있나요?을 참조하세요.
- 단일 수신함 대신 전체 신원을 공유하려면? vCard QR 코드 생성기와 명함용 QR 코드: 한 번의 스캔으로 연락처 저장 가이드를 사용하세요.
- 전화 또는 문자 전용 상호작용은 더 가벼운 스킴을 사용합니다: 온라인 전화 QR 코드 생성기 및 온라인 SMS QR 코드 생성기.
- ISO/IEC 18004에 따라 코드는 정적입니다: 수신함이 변경되면 재인쇄하거나 정적 QR 코드와 동적 QR 코드: 실제로 무엇이 필요한가요?를 연락처 페이지로 지정하세요. 다른 페이로드 유형은 무료 온라인 QR 코드 생성기에서 확인하세요.
모바일 동작 차이
- iPhone Mail: 스캔 시 초안이 포함된 기본 메일 앱이 열립니다. 다른 앱이 기본으로 설정되어 있으면 iOS가 mailto: 링크를 해당 앱으로 전달합니다.
- Android: OS가 이메일 인텐트를 발생시킵니다. 기본 메일 앱이 선택되지 않으면 선택기가 나타납니다 — 일부 사용자는 이 단계에서 초안을 포기할 수 있습니다.
- Outlook 및 기타 메일 앱: 제목과 본문을 포함한 mailto:를 올바르게 처리합니다. 일부 제3자 앱은 mailto: 스킴을 등록하고 초안을 가로채므로 대상 사용자의 정확한 휴대폰에서 테스트하세요.
- 태블릿: iPad 및 Android 태블릿은 메일 앱을 정상적으로 엽니다. 태블릿에서 열린 초안도 전송하려면 사용자의 자체 계정이 필요합니다.
- 초안을 여는 데 네트워크가 필요하지 않습니다: URI는 로컬에서 처리되며 전송은 사용자의 다음 단계입니다.