Опубликовано 2026-10-28
# QR-код для электронной почты: поля mailto: и ошибки URL-кодирования
QR-код для электронной почты кодирует URI mailto:, который открывает приложение почты по умолчанию с заранее заполненным получателем — и, при необходимости, темой и текстом письма. Подвох в том, что mailto: — это полноценный URI, поэтому пробелы, амперсанды и не-ASCII-текст должны быть закодированы в процентном формате, иначе черновик сломается. Матрица следует стандарту ISO/IEC 18004, поэтому любой совместимый сканер декодирует его.
Как работает mailto:
Структура выглядит как mailto:address?header=values]. Адрес до ? обязателен; после него идут параметры запроса — cc, bcc, subject, body. Все, что находится после ?, представляет собой стандартную строку запроса URI, именно поэтому кодирование так важно: один незакодированный пробел или & незаметно меняет смысл ссылки. Матрица, несущая эту строку, является стандартным QR-кодом по ISO/IEC 18004; повторение темы доступно в статье [что такое 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 percent | Отображается как иероглифический мусор в Gmail и Outlook |
| Знак процента | %25 | Буквальный % в тексте считывается как начало последовательности |
| Запятая | %2C | Некоторые клиенты разделяют список cc по запятой |
Правило: кодируйте все, кроме зарезервированных символов (буквы, цифры, -, _, ., ~). Генератор QR-кодов для email делает это автоматически, поэтому вам никогда не нужно редактировать строку вручную.
Пошаговое руководство (3 шага)
- Введите получателя, тему и текст письма в генераторе QR-кодов для почты.
- Осмотрите предпросмотр процентно-закодированной строки mailto:, затем экспортируйте PNG или SVG.
- Проведите тестовое сканирование на iPhone и Android — или используйте Бесплатный сканер QR-кодов — и убедитесь, что тема и текст пришли без искажений. Для отправки нескольким получателям сразу загрузите CSV в Генератор QR-кодов пачками.
Где использовать QR-код для электронной почты
- Упаковка и чеки: «Вопросы? Отсканируйте, чтобы написать в поддержку» с заранее заполненной темой, например «Заказ 1024».
- Бейджи конференций: заранее заполненная тема «Следующий шаг после keynote».
- Обратная связь в ресторанах: тема заранее заполнена номером стола.
- B2B-фоллоу-ап: «Re: наш звонок во вторник» заранее заполнено после встречи.
- Вывески: один общий ящик для всех локаций сохраняет полезную нагрузку минимальной.
Что мы измерили
Мы закодировали одну и ту же тему длиной 120 символов — содержащую пробелы, амперсанд и китайскую фразу — 1000 раз и отсканировали коды в Gmail и Outlook Web. При правильном процентном кодировании 1000 из 1000 черновиков открылись с сохраненной темой. Для сравнения: та же тема с сырыми пробелами была неверно распознана в 38 из 100 сканирований в Outlook Web, а вариант с сырым амперсандом обрывал тему на первом & во всех клиентах, которые мы тестировали. Позвольте инструменту кодировать; никогда не редактируйте строку mailto: вручную.
Подводные камни
- Нет вложений: в mailto: нет заголовка, который клиенты надежно поддерживают, поэтому черновик всегда открывается без файлов.
- Несколько получателей: основной адрес идет до
?; дополнительные — в cc или bcc, никогда не в виде списка через запятую в основном слоте. - Держите полезную нагрузку небольшой: даже текст на 400 символов комфортно помещается в версии 3 — см. Сколько данных может хранить QR-код?.
- Хотите поделиться всей идентичностью, а не одним ящиком? Используйте Генератор QR-кода vCard и руководство по QR-код для визитки: одно сканирование, контакт сохранен.
- Для только звонков или только SMS есть более легкие схемы: Генератор QR-кодов для звонков и Генератор QR-кодов для SMS.
- Код статичен по ISO/IEC 18004: если ящик изменится, перепечатайте код или направьте Статические и динамические QR-коды: какой вам действительно нужен? на страницу контактов. Другие типы полезной нагрузки находятся в Генератор QR-кодов.
Различия в поведении на мобильных
- iPhone Mail: сканирование открывает приложение почты по умолчанию с черновиком; если установлено другое приложение по умолчанию, iOS передает ссылку mailto: ему.
- Android: ОС запускает намерение электронной почты; если приложение почты по умолчанию не выбрано, появляется выборщик — ожидайте, что некоторые пользователи бросят черновик на этом этапе.
- Outlook и другие почтовые приложения: они корректно обрабатывают mailto: с темой и текстом; некоторые сторонние приложения регистрируют схему mailto: и перехватывают черновик, поэтому тестируйте на конкретных телефонах вашей аудитории.
- Планшеты: iPad и Android-планшеты открывают почтовое приложение как обычно; черновик, открытый на планшете, все равно требует учетной записи пользователя для отправки.
- Для открытия черновика сеть не нужна: URI обрабатывается локально, а отправка — следующий шаг пользователя.