# Выгрузка данных из Битрикс24 в Хранилище данных

Как выгрузить данные о лидах и сделках из Bitrix24 в базу данных.

## Как это работает

С помощью этого коннектора вы можете автоматически выгружать лиды и сделки из CRM Bitrix24 в Хранилище данных ROMI center или в другую базу данных. Это нужно для настройки сквозной аналитики, атрибуции и отчётности.

Каждый источник (например, Яндекс Директ, CRM, Яндекс Метрика) формирует в Хранилище данных свою таблицу. Все данные обновляются по автоматически — вручную выгружать их не требуется. Если нужно загрузить исторические данные, это можно сделать по запросу в техподдержку.

![Таблица с лидами из CRM: даты, статус, источник и метки визита](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-1.png)

Пример таблицы с данными из CRM

## Инструкция по подключению

> **Примечание**
> После подключения «получателя данных» (то есть базы, в которую будут загружаться данные), станет доступен коннектор Bitrix24.
>
> Куда можно выгружать данные:
>
> 1.  [Хранилище ROMI center](https://help-ru.romi.center/peredacha-dannyh-v-hranilishche-romi-center)\*
> 2.  [Clickhouse](https://help-ru.romi.center/peredacha-dannyh-v-clickhouse)
> 3.  [MySQL](https://help-ru.romi.center/peredacha-dannyh-v-mysql)
>
> \*Хранилище данных — встроенная структура ROMI center, в которую автоматически сохраняются таблицы с данными, выгруженными из разных источников.
>
> После выгрузки данных их можно преобразовывать в разделе «Трансформация»:
>
> *   объединять таблицы между собой — например, расходы из рекламных каналов + сделки из CRM;
> *   присваивать источники сделкам с помощью моделей атрибуции — например, по визитам из Яндекс Метрики;
> *   готовить отчёты и визуализации в Yandex Datalens и других BI-системах.

Подключение состоит из двух этапов:

*   настройка в кабинете ROMI center (пункты 1,2, 7-9);
*   настройка вебхука на стороне Битрикс24 (пункты 3-6).

1\. Выберите Bitrix24 в списке других источников данных и нажмите «Продолжить».

![Список источников данных в кабинете ROMI center с выбором Bitrix24](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-2.png)

2\. Чтобы настроить подключение и указать «Вебхук для вызова rest api», перейдите в свой аккаунт Битрикс24.

![Форма подключения Битрикс24 с полем для вставки вебхука rest api](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-3.png)

3\. Вебхук можно найти в личном кабинете Bitrix24, в разделе «Разработчикам».

![Раздел «Разработчикам» в левом меню личного кабинета Битрикс24](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-4.jpg)

4\. В открывшемся окне прокрутите вниз до блока «Другое».

![Блок «Другое» в разделе «Разработчикам» Битрикс24](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-5.jpg)

5\. Выберите «Входящий вебхук».

![Выбор пункта «Входящий вебхук» среди вариантов в блоке «Другое»](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-6.jpg)

6\. Укажите параметры «Входящего вебхука».

![Настройка входящего вебхука: ссылка для rest api и права CRM, Пользователи](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-7.jpg)

> **Примечание**
> Обратите внимание:  
> В разделе «Настройка прав» нужно указать две сущности: «CRM» и «Пользователи».

6.1 Скопируйте «Вебхук для вызова rest api» и вставьте его в настройках кабинета ROMI center (шаг 2 в инструкции).

6.2 В поле «Настройка прав» нажмите ссылку «+ выбрать» и выберите значение «CRM». Нажмите кнопку «Сохранить».

> **Примечание**
> Если вам требуется найти ранее созданный вебхук и проверить его настройки:
>
> 1.  Перейдите в раздел «Разработчикам»
> 2.  Откройте в верхнем меню «Интеграции»
> 3.  Найдите нужный вебхук и слева от него кнопку с тремя полосками
> 4.  Во вплывающем окне выберите «Редактировать».

![2\. Проверка настроек вебкуха](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-8.png "2. Проверка настроек вебкуха")

![1\. Проверка настроек вебкуха](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-9.png "1. Проверка настроек вебкуха")

7\. После предоставления доступа, вы перейдете к настройке отправки данных.

![Список Bitrix24 в подключениях ROMI center после предоставления доступа](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-10.png)

> **Примечание**
> Коннектор ROMI center подключается к вашей CRM и выгружает:
>
> *   лиды и сделки, которые были перемещены или созданы в выбранном вами этапе.
> *   любые поля внутри лидов и сделок, которые вы укажете (менеджеры, utm-метки и т.д.)
>
> Далее формирует из них таблицу и сохраняет в хранилище. При каждом обновлении таблица дополняется актуальными данными из CRM.

8\. Укажите параметры для отправки данных:

![Настройка отправки данных: стадия сделки и список выгружаемых полей](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-11.png)

8.1 Укажите стадию, при переходе в которую лиды и сделки будут выгружаться.

8.2 Выберите, какие поля из лидов и сделок вы хотите выгружать.

> **Примечание**
> **Рекомендуем добавить эти параметры к выгрузке из всех этапов:**
>
> *   Стадия (STATUS\_ID) — стадия лида
> *   Стадия сделки (STAGE\_ID) — стадия сделки
> *   Дата создания (DATE\_CREATE) — дата создания лида/сделки

8.3 Латинскими буквами укажите название параметра. Так он будет называться в таблице, сформированной ROMI center.

8.4 Выберите тип данных:

*   «String» (Текст) — любая текстовая информация. Пример: utm\_source, город.
*   «Int64» (Целое число) — число без дробной части (клики, показы и т.д). Пример: 100, 500, 12345.
*   «Float64» (Число с дробью) — число с десятичной частью (расходы, выручка и т.д). Пример: 10.5, 3.14, 99.99.
*   «Date» (Дата) — дата в формате ГГГГ-ММ-ДД. Пример: 2025-01-01.

9\. Готовое подключение выглядит так:

![Готовое подключение Bitrix24 в списке источников хранилища ROMI center](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-12.png)

> **Примечание**
> 1\. Если вам требуется выгружать новый источник данных в уже добавленное хранилище, нажмите «Новый источник».
>
> 2\. Если вам нужно добавить нового получателя данных («куда» отправлять данные), нажмите «Новый получатель данных».

## Что дальше делать с таблицей

Теперь данные из Bitrix24 автоматически обновляются в вашем Хранилище данных. Вы можете использовать их для дальнейшей аналитики.

*   Объединить с другими источниками (например, с расходами из рекламных кабинетов по utm-меткам) в модуле [«Объединение данных»](https://help-ru.romi.center/obedinenie-dannyh-iz-raznyh-istochnikov);
*   Присвоить источники сделкам с помощью модуля «Модели атрибуции» — по визитам из [Метрики Logs API](https://help-ru.romi.center/vygruzka-dannyh-yandeks-metrika-logs-api);
*   Визуализировать данные в BI-системах (например, Yandex DataLens) для построения отчётов.

### Примеры отчетов с данными из CRM

![2\. Пример отчета с данными из CRM](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-13.png "2. Пример отчета с данными из CRM")

![1\. Пример отчета с объединенными данных из CRM, Яндекс Метрики и рекламным площадками](https://help-ru.romi.center/images/vygruzka-dannyh-iz-bitrix24/image-14.png "1. Пример отчета с объединенными данных из CRM, Яндекс Метрики и рекламным площадками")
