Битрикс24 → Google BigQuery - выгрузка отчетов по API

Интеграция по передаче данных из CRM Bitrix24 в Google BigQuery работает на базе Webhooks и собирает данные в режиме реального времени.

В этой статье мы описали:

– Процесс создания интеграции для передачи данных о продажах из CRM-системы в базу данных Google BigQuery;

– Структуру передаваемых данных;

– Частота обновления данных.

Процесс создания новой интеграции

1. На главной странице сервиса найдите категорию Данные из CRM и нажмите на иконку Битрикс 24 или на кнопку Создать интеграцию.

1.1. При выборе кнопки Создать интеграцию на странице выбора источника данных нажмите на следующем экране на кнопку Битрикс 24.

2. На следующей странице нажмите на кнопку Добавить новый аккаунт или выберите ранее созданный.

3. На шаге Выбор источника данных укажите название источника данных в поле Название подключения. Указывайте имя, по которому вам будет просто понять что это за источник данных.

4. В следующее поле требуется ввести идентификатор вебхука. Его требуется получить в CRM-системе. Ниже мы опишем, как это сделать.

5. Для этого авторизуйтесь в аккаунте Битрикс24. Перейдите в раздел настроек вебхук. Он располагается по адресу название-вашего-проекта.ru/marketplace/hook/.

На этой странице требуется нажать на кнопку Добавить вебхук и выбрать в появившемся выпадающем списке пункт Входящий вебхук (выделена красной рамкой на скриншоте ниже).

6. В появившемся окне требуется заполнить данные в полях: Название и Описание. В списке Права доступа поставьте галочку около пункта CRM.

7. После заполнения всей информации сохраните вебхук нажав на кнопку Добавить вебхук в правом верхнем углу.

8. После создания вебхука, на странице с информацией по нему, будет доступен URL для вызова REST API. Эта ссылка потребуется для завершения создания нового источника в Differture. Ссылка нужна без /profile на конце. Скопируйте ссылку и вернитесь в интерфейс Differture.

9. В интерфейсе Differture на экране из пункта 4 вставьте ссылку в поле. Нажмите кнопку Сохранить.

10. После этого на экране станет доступен новый источник. Нажмите на его карточку для перехода к следующему этапу — выбору хранилища данных.

11. Выберите хранилище данных, в которое будут передаваться данные из Битрикс24. На данный момент инструмент поддерживает передачу данных в Google BigQuery.

12. Нажмите на кнопку Sign in with Google, чтобы перейти к поп-апу с авторизацией. Пройдите авторизацию в системе Google — выберите тот аккаунт, на котором есть доступ к хранилищу, и в которое требуется передавать данные.

13. Выберите привязанную только что учетную запись и переходим к завершающему этапу настройки.

14. В выпадающем списке поля Выгружаемая сущность выберите данные по какому типу сущности (отчёту) требуется передавать данные в хранилище.

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

15. Выберите нужный вам проект Google BigQuery, а также соответствующую базу данных (датасет), в которую будут передаваться данные. Вы также можете создать новый датасет, чтобы передавать в него данные.

16. Выберите с какого момента требуется выгрузить данные из Битрикс24 в поле Начало выгрузки данных и время обновления в поле Время обновления (UTC +03).

Нажмите на кнопку Запустить.

17. Ваш коннектор готов к передаче данных. На финальном экране Статус интеграции доступна сводная информация по вашему новому подключению. Вы можете отредактировать подключение или вернуться к исходному экрану с списком всех подключений на вашем аккаунте.

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

Типы передаваемых данных

В отчётах, по умолчанию, передаются соответствующие наборы полей. Полный список по каждому отчёту можно посмотреть в официальной документации Битрикс24 по ссылкам ниже:

Лиды: https://dev.1c-bitrix.ru/rest_help/crm/leads/crm_lead_fields.php

Сделки: https://dev.1c-bitrix.ru/rest_help/crm/cdeals/crm_deal_fields.php

Компании: https://dev.1c-bitrix.ru/rest_help/crm/company/crm_company_fields.php

Контакты: https://dev.1c-bitrix.ru/rest_help/crm/contacts/crm_contact_fields.php

В отчётах, по умолчанию, передаются соответствующие наборы полей. Полный список по каждому отчёту можно посмотреть в официальной документации Битрикс24 по ссылкам ниже:

Лиды: https://dev.1c-bitrix.ru/rest_help/crm/leads/crm_lead_fields.php

Сделки: https://dev.1c-bitrix.ru/rest_help/crm/cdeals/crm_deal_fields.php

Компании: https://dev.1c-bitrix.ru/rest_help/crm/company/crm_company_fields.php

Контакты: https://dev.1c-bitrix.ru/rest_help/crm/contacts/crm_contact_fields.php

Частота обновления данных

Мы получаем данные из Битрикс24 в режиме реального времени. Каждые 10 минут инструмент выгружает эти данные в ваш проект в Google BigQuery.