Импорт контактов из CSV-файла

Что понадобится

• Право на импорт контактов и право создавать контакты. Если кнопки «Импорт» нет или AISAR пишет, что прав недостаточно, попросите администратора компании выдать их в разделе ролей.
• Файл в формате CSV (расширение .csv или .txt) до 10 МБ, не больше 50 000 строк и 200 колонок. В первой строке должны быть заголовки колонок.
• Нужен хотя бы телефон или имя в каждой строке, которую вы хотите импортировать. Дубли ищутся по телефону внутри вашей компании.

Шаг 1. Подготовьте файл

В Excel или Google Таблицах сохраните таблицу как «CSV (разделители запятые)». Кодировку и разделитель AISAR определит сам, а если определит неверно, их можно выбрать вручную в «Настройках файла». Проще всего начать с готового шаблона: на первом шаге мастера есть кнопка «Скачать шаблон».

В файле можно передать имя, фамилию (или имя и фамилию одной колонкой), телефон, email, компанию, должность, дату рождения, теги, ответственного и заметку. Несколько колонок можно отдать в телефон, email, теги и заметки: контакт получит все значения.

Шаг 2. Загрузите файл

1. Откройте раздел Контакты и нажмите «Импорт». На телефоне импорт спрятан в меню «⋯», пункт «Импорт из файла».
2. Перетащите CSV-файл в окно или нажмите «Выбрать файл». AISAR загрузит файл и покажет найденные заголовки.
3. Если имена и кириллица выглядят «кракозябрами», откройте «Настройки файла» и выберите кодировку (UTF-8 или Windows-1251) и разделитель, затем файл будет прочитан заново.

Шаг 3. Сопоставьте колонки

Для каждой колонки файла выберите поле AISAR или оставьте «Не импортировать». Часть колонок AISAR распознает по названиям. Остальные можно сопоставить вручную или нажать «Сопоставить с ИИ»: ИИ видит только заголовки колонок и первые 20 строк файла, остальные строки он не получает. Любую подсказку можно поменять вручную или вернуть как было.

Там же задаются параметры. Если контакт с таким телефоном уже есть: «Пропустить» (строка не импортируется), «Обновить пустые поля» (по умолчанию: заполним только то, чего у контакта ещё нет) или «Перезаписать» (данные из файла заменят данные контакта; нужно право редактировать контакты). Тег для всех импортированных (по нему потом легко найти весь импорт), ответственный по умолчанию (подставится там, где в файле пусто) и переключатель «Связать с WhatsApp по номеру», чтобы входящее сообщение с этого номера не создало дубль контакта. Сообщения при этом не отправляются.

Шаг 4. Проверьте без записи

AISAR прогонит файл вхолостую и покажет итог: сколько контактов будет создано, сколько обновится, сколько дублей внутри файла (берётся первая строка) и сколько строк с ошибками. Ниже виден предпросмотр первых строк в том виде, в каком они попадут в AISAR. Строки с ошибками можно скачать отдельным файлом, исправить и загрузить заново. Ошибочные строки не мешают импорту остальных.

Шаг 5. Запустите импорт

Нажмите «Импортировать». Импорт идёт в фоне: окно можно закрыть, по завершении придёт уведомление. После этого скачайте отчёт с результатом по каждой строке или откройте контакты с тегом импорта. Если вы изменили сопоставление или параметры после проверки, AISAR попросит проверить файл ещё раз.

Что импорт делает и чего не делает

• Импорт не отправляет сообщений контактам и не запускает автоматизации вроде «новый контакт, отправить приветствие»: иначе список из тысяч номеров получил бы рассылку, а канал мог бы заблокироваться. Если приветствие нужно, сделайте осознанную рассылку по тегу импорта.
• Импортированные контакты не уходят во внешние CRM (Битрикс24, amoCRM) автоматически: файл обычно сам выгружен из CRM. Событие «контакт создан» для вебхуков при импорте не отправляется.
• В компании одновременно выполняется один импорт, а загрузок в сутки на компанию не больше 20. Файл и запись об импорте хранятся 7 суток, потом удаляются, поэтому скачайте отчёт заранее.
• На контакт принимается до 10 телефонов и 10 email, лишние отбрасываются с предупреждением в отчёте.

Если что-то пошло не так

• «Слишком много загрузок подряд»: загрузка файла ограничена 10 разами в час на сотрудника, подождите и повторите.
• «Импорт уже идёт»: дождитесь завершения текущего импорта в компании, затем начните новый.
• «Исходный файл уже удалён» или «Импорт уже нельзя изменить»: загрузите файл заново.
• Если один и тот же клиент всё же задвоился, объедините карточки по инструкции «Дубли контактов: почему возникают и как объединить».

Автоматизировать загрузку из своей системы можно через API, см. раздел «Импорт контактов из CSV» в справочнике контактов.