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	?????????? ?????? ?? ????????? ? ????? (???????, ????????, ?????????, ???? ? ??.).
email	Email-?????? ?? ????????? ? ????? (???????, ???????? ? ??.).
web	URL ?????? ?? ????????? ? ????? (???????, ????????, 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.