Как скачать контакты из Битрикс в Excel: все способы выгрузки

При попытке выгрузить базу контактов из Битрикс24 в Excel пользователи часто сталкиваются с ограничениями стандартного функционала: экспортируются не все поля, данные разбиваются на несколько файлов или теряют форматирование. Проблема усугубляется, если нужно выгрузить не только контакты, но и связанные с ними сделки, лиды или пользовательские поля — стандартный экспорт через интерфейс CRM не всегда справляется с этой задачей. В 80% случаев ошибки возникают из-за неправильно настроенных прав доступа или попытки выгрузить более 5000 записей за один раз.

Стандартный инструмент экспорта в Битрикс24 позволяет сохранить контакты в форматах .xlsx или .csv, но имеет скрытые ограничения: например, при выгрузке через раздел "Контакты" не сохраняются истории взаимодействий, а поля с множественным выбором (теги, источники) экспортируются в нечитаемом виде. Чтобы избежать потери данных, важно заранее настроить структуру выгружаемой таблицы и использовать альтернативные методы для больших объемов.

Эта инструкция покрывает все актуальные способы выгрузки — от базового экспорта через веб-интерфейс до автоматизированных решений через REST API. Особое внимание уделено сохранению связей между сущностями (контакт → сделка → компания) и работе с пользовательскими полями, которые часто "теряются" при стандартной выгрузке.

1. Стандартный экспорт контактов через веб-интерфейс

Самый простой способ выгрузить контакты — использовать встроенную функцию экспорта в разделе CRM → Контакты. Этот метод подходит для баз до 2000 записей и не требует технических навыков. Алгоритм действий:

1. Перейдите в раздел CRM → Контакты (или Лиды/Сделки, если нужны другие сущности).

2. Отфильтруйте список по нужным параметрам (например, по дате создания или ответственному).

3. Нажмите кнопку Ещё → Экспорт в верхнем меню.

4. Выберите формат: Excel (.xlsx) или CSV (для дальнейшей обработки в других системах).

⚠️ Внимание: При экспорте через веб-интерфейс не сохраняются связи между сущностями (например, привязка контакта к компании или сделке). Эти данные придется восстанавливать вручную или использовать альтернативные методы выгрузки.

✅ Подходит для разовых выгрузок небольших баз
✅ Не требует доступа к API или технических знаний
❌ Ограничение в 5000 записей за одну операцию
❌ Потеря пользовательских полей сложных типов (прикрепленные файлы, множественный выбор)

Если вам нужно выгрузить больше 5000 контактов, разбейте экспорт на части по фильтрам (например, по алфавиту или датам создания). Для сохранения связей между сущностями переходите к следующему методу.

Убедитесь, что у вас есть права на экспорт данных|Отфильтруйте ненужные записи|Проверьте наличие всех нужных колонок в таблице|Сохраните резервную копию перед выгрузкой-->

2. Экспорт через отчеты CRM (сохранение связей)

Для выгрузки контактов вместе со связанными сделками, компаниями или лидами используйте раздел CRM → Отчеты. Этот метод позволяет сохранить иерархию данных, но требует предварительной настройки структуры отчета.

Пошаговая инструкция:

Перейдите в CRM → Отчеты → Создать отчет.
Выберите тип отчета: "Список контактов" или "Связанные сущности".
Добавьте нужные колонки, включая пользовательские поля. Для сохранения связей добавьте колонки типа "Сделки контакта" или "Компании контакта".
Настройте фильтры и группировки при необходимости.
Сохраните отчет и нажмите "Экспорт в Excel".

Преимущество этого метода — сохранение связей между сущностями в отдельных колонках. Например, в экспортированном файле будет колонка "Сделки", где перечислены ID и названия связанных сделок.

Формат экспорта	Сохранение связей	Ограничение записей	Поддержка пользовательских полей
Стандартный экспорт	❌ Нет	5000	Частично
Экспорт через отчеты	✅ Да (в отдельных колонках)	10 000	✅ Полная
API-экспорт	✅ Да (гибкая настройка)	Неограничено	✅ Полная

⚠️ Внимание: При экспорте через отчеты данные о связях сохраняются в виде текстового списка (например, "Сделка #123, Сделка #456"). Для дальнейшего анализа в Excel потребуется разделить эти данные по столбцам с помощью функции ТЕКСТ.ПО.СТОЛБЦАМ или макроса.

3. Выгрузка через REST API (для больших баз)

Если вам нужно выгрузить более 10 000 контактов или автоматизировать процесс, используйте REST API Битрикс24. Этот метод требует базовых знаний программирования или использования сервисов типа Postman.

Базовый алгоритм:

Получите webhook-URL в настройках портала (Приложения → Вебхуки).
Используйте метод crm.contact.list для получения списка контактов.
Для выгрузки связанных сущностей (сделок, компаний) используйте методы crm.deal.list и crm.company.list с параметром filter[CONTACT_ID].
Сохраните данные в формате JSON и конвертируйте в Excel с помощью скрипта или инструментов типа Pandas (Python).

Пример запроса для получения контактов с пагинацией:

https://ваш_портал.bitrix24.ru/rest/1/ваш_webhook/crm.contact.list?
select[]=ID&select[]=NAME&select[]=LAST_NAME&select[]=PHONE&
start=-1

Для автоматизации процесса можно использовать готовые скрипты на Python или PHP. Например, этот скрипт выгружает контакты в CSV:

Пример скрипта на Python для выгрузки контактов

import requests

import csv

webhook = "https://ваш_портал.bitrix24.ru/rest/1/ваш_webhook/"

url = webhook + "crm.contact.list"

response = requests.get(url)

data = response.json()["result"]

with open("contacts.csv", "w", newline="", encoding="utf-8") as file:

writer = csv.DictWriter(file, fieldnames=data[0].keys())

writer.writeheader()

writer.writerows(data)

⚠️ Внимание: При работе с API учитывайте ограничения Битрикс24:

Не более 2 запросов в секунду
Максимальный размер ответа — 50 МБ
Для выгрузки более 50 000 записей используйте пагинацию (start)

4. Экспорт через 1С или внешние интеграции

Если ваша компания использует 1С или другие внешние системы, настройте автоматический обмен данными через:

⚙️ Стандартный коннектор 1С-Битрикс (для предприятий)
🔄 Zapier или Make (ex-Integromat) (для автоматизации)
📊 Power Query в Excel (для прямой загрузки)

Для настройки обмена через 1С:

Установите модуль обмена данными с Битрикс24 в вашей конфигурации 1С.
Настройте правила синхронизации в разделе Администрирование → Обмен данными.
Выберите направление обмена: "Выгрузка из Битрикс в 1С".
Запустите синхронизацию и экспортируйте данные из 1С в Excel.

Преимущество этого метода — возможность настроить регулярный автоматический экспорт без ручного вмешательства. Например, можно настроить ежедневную выгрузку новых контактов в Excel-файл на сетевом диске.

Стандартный экспорт через веб-интерфейс|Экспорт через отчеты CRM|REST API и скрипты|Интеграция с 1С или другими системами-->

5. Решение проблем при экспорте

Частые ошибки и их решения:

🔴 "Экспорт прерван из-за большого объема данных" → Разбейте выгрузку на части по 3000-4000 записей или используйте API.
🔴 "В экспортированном файле пустые ячейки" → Проверьте права доступа к пользовательским полям в настройках CRM.
🔴 "Не экспортируются поля типа 'Файл' или 'Множественный список'" → Используйте API или отчеты с кастомными полями.
🔴 "Файл Excel открывается с ошибкой формата" → Сохраните файл в формате .csv и импортируйте в Excel вручную.

Если при экспорте через API вы получаете ошибку "QUERY_LIMIT_EXCEEDED", уменьшите количество запрашиваемых полей или используйте пагинацию. Для ускорения выгрузки больших баз можно использовать асинхронные методы API (например, batch).

Для диагностики проблем с экспортом проверьте:

Логи ошибок в Администрирование → Логи.
Настройки квоты API в Приложения → Вебхуки.
Формат даты/времени в настройках портала (должен совпадать с форматом в Excel).

6. Оптимизация экспортированных данных в Excel

После выгрузки данные часто требуют доработки:

📋 Разделение ячеек с несколькими значениями (например, несколько телефонов в одной ячейке) → используйте функцию ТЕКСТ.ПО.СТОЛБЦАМ.
🔍 Поиск дублей → примените условное форматирование для выделения повторяющихся email или телефонов.
📊 Связывание данных → используйте ВПР или XLOOKUP для объединения таблиц контактов и сделок.
🗑️ Очистка мусора → удалите служебные колонки типа "UF_*", если они не нужны.

Пример формулы для извлечения домена из email (колонка B):

=ПСТР(B2;ПОИСК("@";B2)+1;ДЛСТР(B2))

Для автоматизации обработки больших файлов можно использовать макросы VBA. Например, этот код удаляет пустые строки и сортирует данные по алфавиту:

Sub CleanAndSort()
Columns("A:Z").SpecialCells(xlCellTypeBlanks).EntireRow.Delete
Range("A1").CurrentRegion.Sort Key1:=Range("B1"), Order1:=xlAscending
End Sub

FAQ: Частые вопросы по экспорту контактов

Можно ли выгрузить историю взаимодействий (звонки, письма) вместе с контактами?

Стандартными средствами — нет. История взаимодействий хранится в отдельных сущностях (crm.activity). Для выгрузки нужно использовать API-метод crm.activity.list с фильтром по ID контакта или специальные отчеты в Битрикс24.

Как экспортировать контакты с прикрепленными файлами?

Файлы не экспортируются стандартными методами. Варианты решения:

Используйте API-метод disk.folder.getchildren для скачивания файлов по ID.
Настройте интеграцию с облачным хранилищем (Google Drive, Yandex Disk) через Zapier.
Вручную скачайте файлы через интерфейс Битрикс24 и прикрепите их к Excel-файлу.

Почему при экспорте теряются русские символы в CSV?

Проблема возникает из-за неверной кодировки. Решения:

При сохранении в Excel выбирайте кодировку UTF-8.
Открывайте CSV-файл через Notepad++ и пересохраняйте в UTF-8 без BOM.
Используйте формат .xlsx вместо CSV для сохранения кириллицы.

Как выгрузить контакты с пользовательскими полями?

Пользовательские поля (UF) экспортируются только если:

Они добавлены в колонки таблицы перед экспортом.
В настройках поля установлен флаг "Показывать в списке".
Для API-экспорта используйте параметр select[]=UF_*.

Поля типа "Файл", "HTML/текст" или "Множественный список" могут экспортироваться в нечитаемом виде — для них требуется дополнительная обработка.

Можно ли настроить автоматический экспорт контактов в Excel?

Да, для этого используйте:

Роботы Битрикс24 (раздел CRM → Роботы) с триггером по расписанию.
Внешние сервисы типа Zapier или Make для связи Битрикс24 с Google Sheets.
Скрипты на Python/PHP с запуском по cron.

Для настройки робота выберите действие "Экспорт данных" и укажите email для отправки файла.