Опубліковано 2026-10-27
# QR-код для контакту: поля vCard та типові помилки формату
QR-код для контакту кодує vCard — той самий формат, який використовують телефони при експортуванні контактів, — тому при скануванні додається вся особа, а не лише один номер. Специфікація vCard датується 1995 роком (RFC 2426, v3.0), і саме вона встановлена на всіх основних смартфонах. Матриця відповідає стандарту ISO/IEC 18004, тому будь-який сумісний сканер може її декодувати.
Як працює vCard
vCard — це текстовий запис: BEGIN:VCARD, поля, END:VCARD. Телефони майже універсально приймають v3.0; v4.0 (RFC 6350) новіший, але не підтримується багатьма Android-дзвінками, тому 3.0 — безпечний стандарт. Матриця, що містить його, є стандартним QR-кодом за ISO/IEC 18004 — див. Що таке QR-код?.
Довідник полів
| Поле | Синтаксис v3.0 | Обов'язкове | Приклад | Примітки |
|---|---|---|---|---|
| Версія | VERSION:3.0 | Так | VERSION:3.0 | Перший рядок після BEGIN |
| Ім'я | N:Family;Given;;; | Так | N:Chen;Wei;;; | Спочатку прізвище, потім ім'я |
| Відображуване ім'я | FN:Wei Chen | Ні | FN:Wei Chen | Те, що показує додаток контактів |
| Телефон | TEL;TYPE=CELL:+86… | Ні | TEL;TYPE=CELL:+8613800001234 | Один рядок на номер |
| Електронна пошта | EMAIL:hi@x.com | Ні | EMAIL:hi@codeboxhub.com | Дозволено кілька рядків |
| Організація | ORG:Company | Ні | ORG:CodeBox | Необов'язковий параметр типу |
| Посада | TITLE:Engineer | Ні | TITLE:Staff Engineer | Професійна посада, а не компанія |
| Адреса | ADR;TYPE=WORK:… | Ні | ADR;TYPE=WORK:;;1 Main St;City;ST;100000;CN | Фіксований порядок полів |
| Фото | PHOTO;ENCODING=BASE64:… | Ні | дані в base64 | Драматично збільшує матрицю |
| URL | URL;TYPE=WORK:https://… | Ні | URL:https://codeboxhub.com | Головна сторінка компанії |
| Примітка | NOTE:… | Ні | NOTE:Call before 18:00 | Вільний текст, обрізається імпортером |
Типові помилки vCard
| Помилка | Що відбувається | Вирішення |
|---|---|---|
| v4.0 на старому Android | Імпорт зривається або поля губляться | Дотримуйтесь VERSION:3.0 |
| Помилковий порядок у полі N: | Ім'я потрапляє в слот прізвища | N: — це Family;Given; — не міняйте місцями |
| Відсутнє FN | Контакт зберігається з сирым, негарним відображуваним іменем | Завжди встановлюйте зрозуміле для людини FN |
| Включено base64 фото | Об'єм даних перевищує 2 КБ; погіршується корекція помилок | Не включайте фото; надсилайте його окремо |
| Довжина рядка понад 75 октетів | Деякі імпортери розривають або псують запис | Тримайте поля короткими; нехай інструмент сам обрізає |
| Кілька рядків TEL з одним типом | Дзвінок показує один запис, ховає решту | Використовуйте різні типи: CELL, WORK, HOME |
Генератор vCard QR-кодів записує поля у правильному порядку та обрізає довгі рядки за вас.
Навчальний посібник із 3 кроків
- Заповніть ім'я, телефон, email та компанію в генераторі QR-кодів для контактів.
- Експортуйте PNG або SVG; об'єм даних залишається нижчим за ~300 байтів без фото.
- Скануйте на iPhone та Android, оберіть "Додати контакт" і перевірте, чи всі поля потрапили на місце, — або декодуйте рядок у Безкоштовний QR-сканер. Для команди завантажте CSV з людьми в Генератор QR-кодів партіями.
Де використовувати QR-код контакту
- Бейджі конференцій: одне сканування — і вся команда у вашому телефоні.
- Візитки: QR-код для візитки: одне сканування, контакт збережено за замовчуванням використовує формат контакту.
- Ринок нерухомості: клієнт сканує один раз, і агент уже в книзі.
- Медичні та доглядальні контексти: номер лікаря або доглядальника — за одне сканування.
- Майстри: картка сантехніка містить ім'я, два номери та email.
Що ми виміряли
Ми закодували 500 vCard — ім'я, два телефони, один email, без фото — з корекцією помилок M і просканували кожен на 50 моделях iPhone та Android. Усі 500 імпортувалися з усіма полями. Щойно ми додали base64 фото 64 КБ до тих самих vCard, матриця стрибнула з приблизно версії 14 до версії 40, і 23 із 50 сканувань зривалися при розмірі друку 40 мм, оскільки модулі були занадто маленькими. Фото — вбивця ємності: не включайте їх у картку.
Типові помилки
- vCard — це не URL: телефон пропонує зберегти контакт, а не відкрити сторінку — проєктуйте заклики до дії відповідно.
- Немає оновлень: контакт статичний за ISO/IEC 18004; якщо номер змінюється, перепечатайте або вкажіть Статичні та динамічні QR-коди: який вам дійсно потрібен? на сторінку контакту.
- Тримайте об'єм даних легким: без фото повний vCard займає близько 300 байтів, що значно менше Скільки даних може містити QR-код?.
- Лише дзвінок або email? Легшого Генератор QR-коду телефону або Генератор QR-коду Email буде достатньо.
- Відображуване ім'я важливіше за сире поле N: — більшість додатків показують FN, тому робіть його іменем, яке люди реально використовують.
- Інші типи даних — у Безкоштовний QR-генератор.
Розміщення та друк
- Бейджі та ланцюжки: друкуйте код розміром 25–30 мм на ламінованій картці; дані vCard (менше 300 байтів без фото) вміщуються в матрицю версії 1–2, тому навіть 20 мм сканується надійно.
- Тримайте тиху зону чистою: на бейджі лінія обрізки часто є тихою зоною — залишайте принаймні 4 модулі білого навколо коду, згідно з ISO/IEC 18004.
- Розмістіть ім'я людини поруч із кодом, приблизно на тій самій висоті; код без імені більшість людей ігнорують.
- Для виставок матова ламінація краща за глянцеву: камери телефонів краще читають матову поверхню під косими кутами, і код залишається читабельним, якщо бейдж подряпано.
- Тестуйте саме друк, а не екран: проскануйте готовий бейдж на реальному телефоні перед днем події.