Перейти к инструменту
ViewCSV
Без загрузки на сервер

Конвертация контактов CSV в VCF (vCard)

contacts.csv· ПРИМЕР6 строк · 7 столбцов
Версия vCard
4.0 (RFC 6350) — для современных телефонов и приложений; 3.0 (RFC 2426) — для старых адресных книг.
Сопоставьте столбцы с полями контакта
Дополнительные параметры
BEGIN:VCARD
VERSION:4.0
FN:Сергей Смирнов
N:Смирнов;Сергей;;;
ORG:ООО «Байкал Логистик»
EMAIL;TYPE=home:contact1@example.test
TEL;TYPE=cell,voice:+7 495 068-70-96
ADR:;;;Нижний Новгород;;;
END:VCARD
BEGIN:VCARD
VERSION:4.0
FN:Татьяна Кузнецов
N:Кузнецов;Татьяна;;;
ORG:ООО «Кедр»
EMAIL;TYPE=home:contact2@example.test
TEL;TYPE=cell,voice:+7 495 471-69-53
ADR:;;;Екатеринбург;;;
NOTE:Met at the trade fair\nPrefers email
END:VCARD
BEGIN:VCARD
VERSION:4.0
FN:Александр Попов
N:Попов;Александр;;;
ORG:ООО «Кедр»
EMAIL;TYPE=home:contact3@example.test
TEL;TYPE=cell,voice:+7 495 491-47-90
ADR:;;;Москва;;;
END:VCARD
BEGIN:VCARD
VERSION:4.0
FN:Иван Иванов
N:Иванов;Иван;;;
ORG:ООО «Кедр»
EMAIL;TYPE=home:contact4@example.test
TEL;TYPE=cell,voice:+7 495 430-06-76
ADR:;;;Омск;;;
NOTE:VIP\, call before 10:00
END:VCARD
BEGIN:VCARD
VERSION:4.0
FN:Сергей Михайлов
N:Михайлов;Сергей;;;
ORG:ООО «Кедр»
EMAIL;TYPE=home:contact5@example.test
TEL;TYPE=cell,voice:+7 495 092-75-20
ADR:;;;Москва;;;
END:VCARD
BEGIN:VCARD
VERSION:4.0
FN:Андрей Смирнов
N:Смирнов;Андрей;;;
ORG:ООО «Север»
EMAIL;TYPE=home:contact6@example.test
TEL;TYPE=cell,voice:+7 495 100-35-60
ADR:;;;Нижний Новгород;;;
END:VCARD

6 строк · 1 файл

Откройте список контактов в CSV — конвертер сопоставит столбцы вроде First Name, Email и Phone с полями vCard и запишет по карточке на строку в один файл .vcf, который можно импортировать в телефон или адресную книгу. Проверьте сопоставление, выберите vCard 4.0 или 3.0 и скачайте файл. Файл конвертируется в вашем браузере и никогда не загружается на сервер.

Как преобразовать CSV в vCard

  1. Нажмите Открыть файл, перетащите на инструмент выгрузку .csv, .tsv или .txt из CRM, электронной таблицы или почтовой программы или выберите Вставить. Если имена выглядят как «кракозябры», проверьте разделитель и кодировку в разделе Параметры импорта.
  2. Выберите Версия vCard: vCard 4.0 — для современных телефонов и приложений, vCard 3.0 — для старых адресных книг.
  3. Проверьте блок Сопоставьте столбцы с полями контакта. Столбцы сопоставляются по названию заголовка; любое поле можно изменить или выбрать для него Не использовать. Редкие поля находятся в разделе Дополнительные параметры.
  4. Нажмите Скачать VCF и импортируйте файл в телефон, Google Контакты, Outlook или Контакты Apple.

Если в списке лишние пробелы или дубликаты, сначала приведите его в порядок: очистка данных CSV удаляет пробелы и дубликаты, а в инструменте «Переименование и перестановка столбцов CSV» перед конвертацией можно переименовать, переставить или удалить столбцы.

Какие поля записываются

Полное имяFN — имя, под которым показывается контакт. Если поле не сопоставлено или пусто, оно собирается из обращения, имени, отчества или второго имени, фамилии и суффикса; если и их нет — из организации, затем из личного или рабочего email.
Имя, фамилия, отчество или второе имя, обращение, суффиксN — структурированное имя (Last;First;Middle;Prefix;Suffix). vCard 3.0 записывает его всегда, потому что в 3.0 оно обязательно; 4.0 — только если хотя бы у одной части есть значение.
Псевдоним, организация, должностьNICKNAME, ORG и TITLE.
Email (личный), Email (рабочий)EMAIL;TYPE=home и EMAIL;TYPE=work.
Мобильный, рабочий и домашний телефонTEL;TYPE=cell,voice, TEL;TYPE=work,voice и TEL;TYPE=home,voice. Номера копируются как записаны, включая пробелы и +.
Улица и дом, город, регион или область, почтовый индекс, странаОдно поле ADR с частями в порядке vCard; записывается, если хотя бы у одной части есть значение.
Сайт, день рождения, заметкиURL, BDAY и NOTE. День рождения копируется как записан, поэтому используйте дату вида 1985-04-12.

Каждое поле берётся из одного столбца, а при автоматическом сопоставлении каждый столбец используется не больше одного раза. Ячейка с двумя адресами, например a@example.com; b@example.com, остаётся одним значением; перенесите второй адрес в отдельный столбец и сопоставьте его с Email (рабочий).

Экранирование, обрезка пробелов и длинные строки

  • Автоматическое сопоставление не учитывает регистр, пробелы, подчёркивания, дефисы и точки и распознаёт распространённые заголовки выгрузок контактов, а также их аналоги на нескольких языках (Vorname, Nachname, Teléfono, 姓名…). Простой столбец Phone сопоставляется с Мобильный телефон, а Email — с Email (личный).
  • Запятые, точки с запятой и обратные косые черты в значениях экранируются как \,, ; и \\, а перенос строки становится \n, как требует RFC 6350. Acme, Inc. остаётся одним названием организации.
  • Пробелы вокруг каждого значения удаляются. Имена с диакритикой, на кириллице и других письменностях записываются в UTF-8.
  • Строки длиннее 75 байт переносятся на строки продолжения, которые начинаются с пробела, без разрыва многобайтовых символов. Строки заканчиваются на CRLF.
  • Строка без имени, организации и email не может стать корректной карточкой, поэтому она пропускается и учитывается в уведомлении над предпросмотром.

Если контакты импортируются неправильно

  • «Сопоставьте с полем контакта хотя бы один столбец». Ни один заголовок не распознан. Выберите столбцы сами в блоке сопоставления столбцов с полями контакта.
  • После импорта вместо имён «кракозябры» вроде é или ����. CSV прочитан не как UTF-8. Выберите его кодировку в параметрах импорта (у старых выгрузок из Outlook или Excel это часто Windows-1252, у файлов из русской Windows — Windows-1251), проверьте предпросмотр и скачайте файл заново.
  • Пропал контакт. В его строке не было имени, организации и email, и она была пропущена; уведомление над предпросмотром показывает, сколько таких строк. Сопоставьте столбец с именем или заполните строку.
  • Старая адресная книга не принимает файл. Переключите версию на vCard 3.0 и скачайте файл ещё раз.

Ограничения и конфиденциальность

Файлы до 25 МБ, 100 000 строк или 2 млн ячеек открываются с живым предпросмотром первых 200 строк. Бо́льшие файлы конвертируются в потоковом режиме: файл читается частями дважды (сначала чтобы измерить столбцы, затем чтобы записать результат), уведомление сообщает, что скачанный файл охватывает весь файл, а кнопки Копировать нет. Один выходной файл ограничен 4 ГБ.

Контактные данные остаются на вашем устройстве: конвертация идёт в фоновом обработчике в этой вкладке, Отмена её останавливает, а CSV никогда не отправляется на сервер. При Пакетная конвертация нескольких файлов для каждого файла используется текущее сопоставление столбцов, поэтому пакетно конвертируйте только файлы с одинаковыми заголовками.

Пример: три контакта в формате vCard 4.0

Три строки из выгрузки контактов, преобразованные в vCard 4.0 с автоматическим сопоставлением. Запятая в Acme, Inc. и перенос строки в заметке экранированы; строка только с организацией получает имя по организации; в последней строке нет ни имени, ни организации, ни email, поэтому она пропущена. В скачанном файле окончания строк CRLF.

CSV
First Name,Last Name,Company,Email,Phone,City,Notes
Ana,García,"Acme, Inc.",ana@example.com,+34 600 123 456,Madrid,"Met at the expo
Prefers email"
,,Northwind Traders,,+1 206 555 0100,Seattle,
,,,,,,No contact details
VCF
BEGIN:VCARD
VERSION:4.0
FN:Ana García
N:García;Ana;;;
ORG:Acme\, Inc.
EMAIL;TYPE=home:ana@example.com
TEL;TYPE=cell,voice:+34 600 123 456
ADR:;;;Madrid;;;
NOTE:Met at the expo\nPrefers email
END:VCARD
BEGIN:VCARD
VERSION:4.0
FN:Northwind Traders
ORG:Northwind Traders
TEL;TYPE=cell,voice:+1 206 555 0100
ADR:;;;Seattle;;;
END:VCARD

Вопросы и ответы

Что выбрать — vCard 4.0 или 3.0?

Начните с 4.0 (RFC 6350) — эта версия рассчитана на современные телефоны и приложения. Выберите 3.0 (RFC 2426), если старая адресная книга или CRM не принимает файл; в 3.0 к тому же всегда есть обязательное для неё структурированное имя.

Получится ли по файлу на каждый контакт?

Нет. Все карточки попадают в один файл .vcf, по блоку BEGIN:VCARD…END:VCARD на строку, а адресные книги импортируют их как отдельные контакты.

Можно ли добавить фотографии или группы контактов?

Этим конвертером — нет. Он записывает имена, организацию, должность, email, телефоны, один адрес, сайт, день рождения и заметки.

Стандарты и справочные материалы