Миграция данных из Excel в Bitrix24: пошаговое руководство
Перенос клиентской базы, сделок и задач из Excel в Bitrix24 — это одна из первых задач после начала проекта. Если файл уже готов, но вы не уверены, как правильно загрузить данные без потери информации, ниже — проверенный чек‑лист, который позволяет выполнить миграцию за один‑два дня.
В статье описаны все детали: от подготовки таблиц до проверки корректности импортированных записей. При необходимости вы сможете автоматизировать процесс, используя готовый скрипт API.
Подготовка Excel‑файла к импорту
Bitrix24 принимает CSV‑файлы, поэтому первым шагом будет «очистка» Excel‑таблицы. Следуйте этим пунктам, чтобы избежать типичных ошибок.
- Уберите скрытые столбцы и формулы. При экспорте в CSV сохраняются только видимые значения.
- Приведите названия полей к официальным названиям. Список полей Bitrix24 можно посмотреть в разделе Импорт > Шаблоны полей интерфейса.
- Разделите данные по сущностям. Одна таблица — контакты, другая — компании, третья — сделки. Перекрестные ссылки (например, «Компания» в контакте) должны быть указаны в виде названия компании, а не её ID.
- Проверьте кодировку. CSV должен быть в UTF‑8 без BOM, иначе русские символы отобразятся как «??».
- Сохраните файл. В Excel выберите Сохранить как → CSV (UTF‑8).
Выбор способа импорта в Bitrix24
Существует два основных метода:
| Метод | Плюсы | Минусы | Когда использовать |
|---|---|---|---|
| Импорт через CSV‑файл | Простота, нет необходимости в программировании | Ограниченный набор полей, ручная загрузка | Одноразовый перенос небольших таблиц (до 5 000 записей) |
| Импорт через REST‑API | Полный контроль, возможность автоматизации | Требует навыков разработки, настройка токенов | Регулярные загрузки, большие объёмы (10 000+ записей) |
Для большинства клиентов достаточно CSV‑импорта, однако если планируется регулярное обновление данных из Excel‑отчётов, лучше настроить скрипт, использующий интеграцию CRM через API.
Импорт контактов и компаний
В Bitrix24 импортируются одновременно, если указать связь между записями.
- Откройте CRM → Контакты, нажмите Импорт → CSV‑файл.
- Выберите подготовленный файл contacts.csv.
- В мастере сопоставления полей укажите:
- «Имя» → NAME
- «Фамилия» → LAST_NAME
- «Электронная почта» → EMAIL
- «Компания» → COMPANY_TITLE (поле, которое связывает с записью компании)
- Снимите галочку с «Пропускать строки с ошибками», чтобы увидеть проблемные записи сразу.
- Запустите импорт и дождитесь завершения. В случае ошибок откройте Журнал импорта и исправьте исходный CSV.
После импорта перейдите в CRM → Компании и проверьте, что все компании созданы и привязаны к контактам.
Импорт сделок и их привязка к контактам/компаниям
Сделки требуют указания стадии и ответственного, иначе они окажутся в «Не определено». Подготовьте отдельный CSV‑файл deals.csv со следующими полями:
- «Название сделки» → TITLE
- «Стадия» → STAGE_ID (например, C1:NEW)
- «Бюджет» → OPPORTUNITY
- «Контакт» → CONTACT_ID (можно указать имя контакта, если ID неизвестен)
- «Компания» → COMPANY_ID
- «Ответственный» → ASSIGNED_BY_ID (ID сотрудника в Bitrix24)
- В разделе CRM → Сделки** нажмите **Импорт** → **CSV‑файл**.
- Загрузите deals.csv и в мастере сопоставления укажите соответствия полей.
- Для полей CONTACT_ID и COMPANY_ID включите опцию «Создавать связь по названию», если в файле указаны названия, а не ID.
- Проверьте, что стадии совпадают с вашими воронками. При необходимости создайте недостающие стадии в CRM → Настройки → Воронки продаж.
- Запустите импорт.
После завершения откройте любую сделку и убедитесь, что в правой колонке отображаются привязанные контакт и компания.
Проверка и корректировка импортированных данных
Автоматический импорт может пропустить дубли или создать пустые записи. Выполните быстрый аудит:
- В CRM → Контакты включите фильтр «Без компании» и «Без e‑mail». Если такие записи есть, проверьте исходный CSV.
- В CRM → Сделки отфильтруйте «Стадия = Не определено». Часто это результат неправильного сопоставления STAGE_ID.
- Запустите встроенный инструмент Дубликаты (CRM → Инструменты → Дубликаты) и объедините найденные совпадения.
- Для массового исправления используйте Экспорт → CSV**, отредактируйте файл и повторно импортируйте, выбрав опцию «Обновить существующие записи».
Автоматизация повторных загрузок
Если в вашей компании регулярно обновляются списки клиентов, настройте небольшой скрипт на Python или PHP, который будет:
- Читать Excel‑файл из общей папки (например, SharePoint).
- Конвертировать его в CSV‑формат с нужной кодировкой.
- Отправлять запрос
POST https://yourdomain.bitrix24.ru/rest/1/your_token/crm.contact.add(илиcrm.deal.add) для каждой строки. - Логировать ответы API в отдельный файл, чтобы быстро находить ошибки.
Такой скрипт можно интегрировать в услуги D7 по поддержке и автоматизации бизнес‑процессов, а также настроить запуск в планировщике задач Windows или cron‑job Linux.
Частые вопросы
Можно ли импортировать данные напрямую из Excel без конвертации в CSV?
В веб‑интерфейсе Bitrix24 поддерживается только CSV. Однако некоторые сторонние плагины позволяют загрузить XLSX, но они не входят в стандартный набор и могут вызвать проблемы с кодировкой.
Как импортировать пользовательские поля, которые добавлены в CRM?
При добавлении пользовательского поля в разделе CRM → Настройки → Поля запишите его техническое название (например, UF_CRM_123). В CSV‑файле добавьте столбец с тем же названием и укажите нужные значения. При сопоставлении полей в мастере импорта выберите «Пользовательское поле».
Что делать, если при импорте возникла ошибка «Недостаточно прав»?
Убедитесь, что токен API (для метода REST) или пользователь, под которым вы делаете импорт, имеет роль «Администратор» или «Только чтение/запись» в CRM. При работе через веб‑интерфейс проверьте, что вы вошли под аккаунтом, которому предоставлены права «Импортировать данные».
Можно ли импортировать историю взаимодействий (звонки, письма) из Excel?
Да, но такие записи требуют отдельного API‑вызова crm.activity.add. В CSV‑файле укажите тип активности, дату, описание и привязку к контакту/сделке. После импорта рекомендуется открыть запись в CRM и проверить корректность отображения.
Готовый план миграции поможет избежать типовых ошибок и сэкономит время вашей команде. Если понадобится помощь с настройкой импорта, автоматизацией или обучением сотрудников, закажите консультацию — D7 поможет быстро запустить CRM без потери данных.
Рассчитать стоимость под вашу задачу
Бесплатная консультация: разберём задачу и предложим решение за 1 день. Без обязательств.
Спасибо! Заявка принята — скоро свяжемся.
Не удалось отправить. Позвоните нам: +7 (926) 842-67-07 — или нажмите «Отправить» ещё раз.