Какие права (scopes) нужны для подключения

Минимально требуются права **CRM** и **Пользователи**. Если в будущем планируется выгрузка задач, событий календаря или данных телефонии, включите эти права сразу — добавить их позже можно в любой момент без перегенерации URL вебхука.

Можно ли использовать один вебхук для нескольких пайплайнов

Да. Один URL вебхука можно использовать в нескольких пайплайнах Renta (например, один пайплайн на каждый тип отчёта). Все пайплайны будут использовать одни и те же права доступа, заданные при создании вебхука.

Что происходит с пользовательскими полями (UF_CRM_*), созданными после настройки пайплайна

Renta запрашивает метаданные пользовательских полей в начале каждого запуска. Поля, добавленные в админ-панели Bitrix24 после первоначальной настройки, автоматически появятся в колонке `custom_fields_values` при следующей синхронизации — повторная настройка не требуется.

Как хранятся телефонные номера и адреса электронной почты

Телефоны, email-адреса, ссылки на сайты и мессенджеры хранятся в виде структурированных массивов (`phone`, `email`, `web`, `im`). Каждый элемент массива содержит значение, его тип (Work, Home и т.д.) и идентификатор канала.

Поддерживает ли Renta смарт-процессы Bitrix24

Смарт-процессы (пользовательские типы CRM-сущностей) пока не входят в текущий релиз. Поддержка смарт-процессов через универсальный метод `crm.item.list` запланирована в одном из следующих релизов.

Bitrix24

Выгружайте CRM-данные из Bitrix24 напрямую в ваше хранилище с помощью Renta. Централизуйте сделки, лиды, контакты, компании и пользовательские поля для расширенной аналитики, отчётности по воронке продаж и отслеживания конверсий — без единой строки кода.

Аутентификация

Renta подключается к Bitrix24 через входящий вебхук — постоянный токен с ограниченными правами, который генерируется прямо в вашем портале Bitrix24. OAuth-авторизация и установка сторонних приложений не требуются.

URL вебхука одновременно является адресом и секретом: он включает адрес вашего портала, идентификатор пользователя и токен доступа. Относитесь к нему как к паролю и не публикуйте в открытых источниках.

Подключите источник Bitrix24

Настройка интеграции займет около пяти минут. Вам нужно создать входящий вебхук в портале Bitrix24 и вставить его URL в Renta.

Создайте входящий вебхукStep 1

В левом боковом меню Bitrix24 перейдите в Разработчикам > Другое > Входящий вебхук. Если раздел не отображается, обратитесь к администратору портала.

Вебхук для вызова REST API.
Скопируйте этот URL — он понадобится на следующем шаге.
Настройка прав.
Выберите как минимум CRM (crm) и Пользователи (user). Вы можете добавить другие права (например, Задачи, Телефония) на будущее. Права доступа можно обновить в любое время без изменения URL вебхука.
Сохранить.
Нажмите на кнопку сохранения.

Окно настройки входящего вебхука в Bitrix24

Перейдите в каталог подключенийStep 2

В Renta откройте Connections > Catalog. Найдите Bitrix24 в категории CRM и кликните по карточке, чтобы открыть форму добавления.

Добавьте новый источник Bitrix24Step 3

Заполните форму подключения:

Source name.
Укажите понятное название источника.
Webhook URL.
Вставьте скопированный из Bitrix24 URL вебхука.
Save.
Нажмите Save. Renta проверит ссылку на доступность портала и наличие необходимых прав.

Форма добавления источника Bitrix24 в Renta

Настройки пайплайна

При создании пайплайна с источником Bitrix24 настройте следующие параметры.

Типы отчётов

Выберите CRM-объект для выгрузки. Каждый тип отчёта соответствует одной таблице в хранилище и одному методу Bitrix24 REST API.

Тип отчёта	Метод Bitrix24 API	Описание
Deals (сделки)	crm.deal.list	Сделки со стадией, воронкой, суммой и ответственным менеджером.
Leads (лиды)	crm.lead.list	Входящие лиды с источником, статусом, телефоном, email и пользовательскими полями.
Contacts (контакты)	crm.contact.list	Отдельные контактные лица, связанные с компаниями, сделками и лидами.
Companies (компании)	crm.company.list	Профили компаний с отраслью, выручкой и контактными данными.
Activities (активности)	crm.activity.list	CRM-активности: звонки, письма и встречи, привязанные к сделкам или лидам.
Users (пользователи)	user.get	Пользователи портала Bitrix24 — используются для джойнов по полям assigned_by_id и responsible_id.
Deal categories (воронки)	crm.dealcategory.list	Описание воронок продаж: названия и порядок сортировки.
Deal stages (стадии)	crm.status.list	Стадии всех воронок с названиями, цветами и семантическими метками (выиграно/проиграно/в работе).
Currencies (валюты)	crm.currency.list	Справочник валют с кодами, символами и курсами. Базовая валюта задаётся на уровне портала.
Userfields (поля)	crm.*.userfield.list	Метаданные всех пользовательских полей (UF_CRM_*) по сделкам, лидам, контактам и компаниям: названия, типы и значения перечислений.

Параметры

Выберите конкретные поля, которые нужно включить в таблицу назначения. Структура датасета полностью определяется выбранными параметрами. Невыбранные поля не попадут в выгрузку.

Для включения инкрементальной загрузки по сделкам, лидам, контактам, компаниям и активностям добавьте поле date_modify (или last_updated для активностей). Без этого поля Renta будет выполнять полную выгрузку при каждом запуске.

Date range

Пользователь может не выгружать все записи (например, все лиды), а ограничить их через Date range. В Date range мы указываем период, и учитывается поле DATE_MODIFY, по которому фильтруются данные. То есть, если нужны лиды, которые были обновлены после какого-то периода, для этого можно использовать Date range.

Стратегия синхронизации

В таблице ниже описано, как Renta синхронизирует каждый тип отчёта Bitrix24.

Стратегия	Типы отчётов	Описание
Инкрементальная (merge)	Deals, Leads, Contacts, Companies, Activities	Renta загружает только записи, изменённые с момента последнего успешного запуска, используя фильтр Bitrix24 по полю `DATE_MODIFY`. Записи обновляются (upsert) в таблице назначения по уникальному полю `id`. К окну выборки применяется трёхчасовой защитный нахлёст для учёта задержек репликации в Bitrix24 — дубликаты автоматически схлопываются на стороне хранилища.
Полная выгрузка	Users, Deal categories, Deal stages, Currencies, Userfields	Эти таблицы являются справочниками настроек и не имеют поля с датой изменения. Renta перезагружает весь датасет при каждом запуске. Такие таблицы небольшие (как правило, менее 500 строк), поэтому влияние на производительность незначительно.

Инкрементальная загрузка требует хранилища с поддержкой merge-операций: Google BigQuery или ClickHouse. При подключении к другим хранилищам Renta переключается на полную перезапись по выбранному периоду.

Пользовательские поля

Администраторы портала Bitrix24 могут добавлять пользовательские поля (с префиксом UF_CRM_) к сделкам, лидам, контактам и компаниям. Renta автоматически захватывает все пользовательские поля — ручная настройка схемы не требуется.

Значения пользовательских полей хранятся в колонке custom_fields_values в виде структурированного массива. Каждый элемент массива содержит:

Подполе	Описание
field_code	Внутренний ключ поля в Bitrix24, например UF_CRM_1719402824087.
field_name	Читаемое название поля, заданное в админ-панели Bitrix24, например «Оценка качества лида».
field_type	Тип данных поля, как он определён в Bitrix24: string, integer, enumeration, boolean, datetime и др.
field_value	Значение поля для данной записи, сохранённое как текстовая строка. Списочные значения сериализуются в JSON.
field_id	Числовой идентификатор определения поля.
is_computed	Признак, вычисляется ли поле автоматически средствами Bitrix24.

Для запроса пользовательских полей в BigQuery разверните массив и фильтруйте по коду или названию поля:

SELECT
  id,
  title,
  cf.field_name   AS custom_label,
  cf.field_value  AS custom_value,
  cf.field_type   AS custom_type
FROM `project.dataset.deals` d,
UNNEST(custom_fields_values) AS cf
WHERE cf.field_name = 'Оценка качества лида';

Тип отчёта Userfields выгружает отдельную справочную таблицу, в которой каждому ключу UF_CRM_* сопоставлены его название, тип и — для полей-перечислений — полный список допустимых значений. Соедините эту таблицу с custom_fields_values, чтобы декодировать числовые идентификаторы перечислений в читаемые названия.

Многозначные поля

Для лидов, контактов и компаний Bitrix24 хранит телефонные номера, email-адреса, ссылки на сайты и мессенджеры как многозначные поля. Renta выгружает каждое из них в виде структурированного массива.

Колонка	Содержимое
phone	Телефонные номера со значением и типом (Work, Home, Mobile, Fax и др.).
email	Email-адреса со значением и типом (Work, Home и др.).
web	URL сайтов со значением и типом (Work, Home, Facebook и др.).
im	Идентификаторы мессенджеров со значением и типом (Telegram, WhatsApp, Skype и др.).

Чтобы выгрузить рабочие телефонные номера лидов в BigQuery:

SELECT
  id,
  title,
  p.value AS phone_number
FROM `project.dataset.leads` l,
UNNEST(phone) AS p
WHERE p.value_type = 'WORK';

Расписание синхронизации

Renta поддерживает автоматическое расписание, запуск через API и интеграцию с внешними оркестраторами: Apache Airflow, Dagster и Prefect. Подробнее — в документации по расписанию.

Часто задаваемые вопросы

Ready to get started?

Build your data pipeline today or get a personalized demo. Start free!

Need help?

Get expert support to ensure your project succeeds. We're here to help!

Feature requests?

Help shape our product! Share your ideas for new features and integrations.