BI Data Connector для Битрикс24 и Power BI

BI аналитика в Битрикс24

Битрикс24 очень популярная CRM, однако, она имеет скудный функционал собственной системы отчетности, сложную структуру данных и API. Для решения этой проблемы разработчики Битрикс24 ввели интеграцию собственной системы с ведущими аналитическими платформами на рынке (Power BI, Google Data Studio, Yandex Datalens). Штатный нативный коннектор Битрикс24, "BI-Аналитика". Эта интеграция дает разработчикам множество возможностей для выстраивания систем аналитики практически любой сложности.

Скриншот интерфейса BI-Аналитики в Битрикс24

Это решение реально работает очень быстро, у него достаточно гибкий функционал по фильтрам и выборкам.

Однако при попытке создать полноценную модель на базе этой интеграции в ходе разработки мы столкнулись с рядом проблем:

Ограничения строк по тарифным планам Битрикс24.

Приходится настраивать фильтрацию модели, ограничивая объём данных или переходить на вышестоящий тариф в Битрикс24.
Штатный коннектор Битрикс24 выгружает ограниченный набор сущностей.
Это приводит к тому, что у нас в рамках этой интеграции нет возможности строить полноценную систему аналитики.
Т.е. если мы хотим построить отчет, в котором присутствуют, к примеру Счета или Смарт-процессы, то на базе этой интеграции у нас это сделать не получится.

Наше решение

Мы, рекламное агентство Media Targeting, являемся партнёром Битрикс24 и в 2018-м году выпустили первую версию коннектора BI Data.

Приложение получило более 750 установок на клиентских порталах, включая Яндекс.Лицей, Splat и другие крупные компании.

Сейчас мы представляем версию 2.0, основанную на нативном коннекторе BI-Аналитика Битрикс24 и получающую данные как из нативного коннектора, так и по REST API.

С BI Data Connector для Битрикс24 и Power BI, вы можете без проблем обрабатывать и анализировать данные из вашей CRM системы. Это решение позволяет вам преобразовывать сырые данные в полезную информацию для принятия обоснованных бизнес-решений. С помощью интуитивно понятных дашбордов и отчетов, вы можете легко отслеживать ключевые показатели эффективности (KPI).

Все настройки встроены в отчёт Power BI
Быстрая выгрузка данных
Выгрузка дополнительных полей, используя REST API
Нет ограничений на тариф Битрикс24, не нужна подписка на Маркет

Примеры отчётов

Сводный отчёт (скачать шаблон .pbit):

Посмотреть другие примеры отчётов

Возможности коннектора BI Data

1. Данные через нативный коннектор:

сделки (crm_deal)
история сделок (crm_deal_stage_history)
лиды (crm_lead)
история лидов (crm_lead_status_history)
звонки (telephony_call)
компании (crm_company)
контакты (crm_contact)
товарные позиции в лиде (crm_lead_product_row)
товарные позиции в сделке (crm_deal_product_row)
пользовательские поля сделок (crm_deal_uf)
пользовательские поля лидов (crm_lead_uf)
проекты/группы (socialnetwork_group)
дела (crm_activity)
пользователи (user)
смарт-процессы (crm_dynamic_items_XXX)
счета (новые) (crm_item_31)
пользовательские поля контактов (crm_contact_uf)
пользовательские поля компаний (crm_company_uf)
задачи (task)
каталог товаров (crm_product)
стадии CRM (crm_stages)

2. Дополнительно по REST API:

департаменты (department.get)
направления сделок (crm.dealcategory.list)
статусы CRM (crm.status.list)
счета (старые) (crm.invoice.list)
предложения (crm.quote.list)
реквизиты (crm.requisite.list)
разделы товаров (crm.productsection.list)
универсальные списки (lists.*)
доп. поля задач (tasks.task.get)
и другие методы...

Полезные ресурсы:

Создание вебхука

Пошаговая инструкция по созданию вебхука в Битрикс24

Подключение шаблона

Инструкция по подключению шаблона Power BI

Примеры дашбордов

Готовые примеры отчётов и дашбордов

Для партнёров

Информация и материалы для партнёров

Шаблон для разработки

Готовый .pbit файл для разработки отчётов

Презентация (.pdf)

Презентация для партнёров в формате PDF

Поддерживаемые методы BI-Аналитики (основные)

crm_deal – сделки
crm_lead – лиды
crm_deal_uf – пользовательские поля сделок
crm_lead_uf – пользовательские поля лидов
crm_deal_stage_history – история сделок
crm_lead_status_history – история лидов
telephony_call – звонки
crm_company – компании
crm_company_uf – пользовательские поля компании
crm_contact – контакты
crm_contact_uf – пользовательские поля контакта
socialnetwork_group – проект/группа
crm_activity – дело
crm_lead_product_row – товарные позиции в лиде
crm_deal_product_row – товарные позиции в сделке
crm_product - товары
crm_product_property - свойства товаров
crm_product_property_value - значения свойств товаров
crm_dynamic_items_ХХХ - смарт-процессы (зависит от ID)
crm_smart_proc - список смарт-процессов
crm_stages - стадии сущностей CRM
user - пользователи
task - задачи
task_stages - стадии задач
task_uf - пользовательские поля задачи

Дополнительные методы REST API (примеры)

crm.invoice.* - счета (старые)
crm.item.* - работа с элементами CRM (включая новые счета, предложения, смарт-процессы)
crm.status.list - статусы
crm.requisite.* - реквизиты
crm.product.* - товары
crm.productsection.* - разделы товаров
crm.dealcategory.* - направления сделок
tasks.task.* - задачи (новый REST)
lists.* - универсальные списки
department.get - структура компании

Функциональные таблицы (служебные)

crm_fields - Структура таблиц BI-Аналитики
crm_userfields_enum - Значения списочных пользовательских полей BI-Аналитики

Настройка коннектора: пошаговая инструкция

1 Создание вебхука для подключения шаблона

Перейдите на своём портале по пути: CRM → Интеграции → Rest API
или по адресу: ваш-портал.bitrix24.ru/devops/
На вкладке "Готовые сценарии" нажмите "Импортировать/экспортировать данные"
Затем выберите "Другое"
В открывшемся окне:
- Дайте название вебхуку
- Снимите галку "Виджеты"
В пункте "Настройка прав" выберите: CRM, Структура компании, Телефония, Пользователи
Нажмите "Сохранить".
Результат созданного вебхука хранится по пути:
CRM → Интеграции → Rest API → Интеграции
или по адресу: ваш-портал.bitrix24.ru/devops/list/

2 Подключение шаблона Power BI

Откройте файл шаблона Power BI.
Перейдите на портале Битрикс24 в CRM → Аналитика → BI-Аналитика
В качестве параметров подключаемого шаблона "Адрес_сервера_Б24" и "Секретный_ключ" используйте значения полей "Адрес сервера" и "Секретный ключ" блока Power BI
Перейдите на портале Битрикс24 в CRM → Интеграции → Rest API. На вкладке "Интеграции" найдите ранее созданный вебхук и откройте его.
В качестве параметра "Адрес_вебхука" используйте значение поля "Вебхук для вызова rest api".
В шаблоне нажмите "Загрузить". На все вопросы до начала загрузки данных отвечайте утвердительно.
Дождитесь окончания загрузки данных.
Сохраните файл в формате .pbix.

Коробочная версия коннектора BI Data

Помимо облачной, представлена коробочная версия коннектора, которая позволяет развернуть его на машинах под управлением Linux или Windows.

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

Скачать:

Обращайтесь, предоставим бесплатно триал на 30 дней и поможем с настройкой.

Инструкция для настройки коробочной версии

Убедитесь, что в Битрикс24 без ограничений работает модуль BI-Аналитика (Путь: CRM -> Аналитика -> BI-Аналитика -> Microsoft Power BI). Если действуют ограничения, появится предупреждение.
В Битрикс24 создайте вебхук для работы коннектора (Путь: Разработчикам -> Другое -> Вебхуки -> Добавить вебхук -> Входящий вебхук):
- Задайте имя (например, "BI Data Box Connector").
- В "Настройка прав" выберите скоупы: crm, task (или tasks), department, user, telephony, lists.
- Сохраните и скопируйте URL вебхука (вида https://yourdomain.bitrix24.ru/rest/XXX/yyyyyyyyyyyy/).
Запустите исполняемый файл коннектора: server_bi_data.exe (Windows) или ./server_bi_data (Linux).
Откройте файл шаблона Power BI (box_template.pbix).
Перейдите в Редактор Power Query (Главная -> Преобразование данных).
Выберите функцию "Данные Б24" (или аналогичную) и заполните параметры:
- Адрес сервера Б24: Скопируйте из CRM -> Аналитика -> BI-Аналитика -> Microsoft Power BI -> "Адрес вашего сервера".
- Секретный ключ: Скопируйте из CRM -> Аналитика -> BI-Аналитика -> Microsoft Power BI -> "Ваш секретный ключ".
- Адрес вебхука: Вставьте URL вебхука, скопированный в п.2.
- Метод CRM Аналитики: Укажите нужный метод из списка поддерживаемых коробочной версией (см. ниже).
- Выбрать столбцы (опционально): Укажите нужные поля через запятую без пробелов (Пример: ID,DATE_CREATE,TITLE).
Нажмите "Вызвать" или "Обновить". В результате будет возвращена таблица с данными.

Поддерживаемые методы коробочной версии

Методы BI-Аналитики:

crm_deal – сделки
crm_lead – лиды
crm_deal_uf – польз. поля сделок
crm_lead_uf – польз. поля лидов
crm_deal_stage_history – история сделок
crm_lead_status_history – история лидов
crm_company – компании
crm_company_uf – польз. поля компании
crm_contact – контакты
crm_contact_uf – польз. поля контакта
crm_activity – дела
crm_lead_product_row – товарные позиции в лиде
crm_deal_product_row – товарные позиции в сделке
telephony_call – звонки

Методы REST API:

api_user - пользователи
api_department - отделы
api_crm_status - статусы
api_task - задачи
api_crm_product - товары CRM
api_crm_productsection - разделы товаров CRM
api_list - список универсальных списков
api_list_field_<IBLOCK_ID> - поля универсального списка
api_list_element_<IBLOCK_ID> - элементы универсального списка
api_crm_invoice - счета (старые)
api_crm_category_<entityTypeId> - направления сделок/смарт-процессов
api_crm_item_<entityTypeId> - смарт-процесс

Стоимость

У нас нет ограничений по количеству выгружаемых данных. Подписка распространяется на 1 портал Битрикс24.

Стоимость \ Версия	Облачная версия	Коробочная версия
Подписка 1 месяц	2 000 ₽	2 000 ₽
Подписка на 1 месяц (при оплате за год)	1 800 ₽	1 800 ₽
Покупка навсегда	—	80 000 ₽
Разработка отчётов	Оценка по ТЗ, от 2 000 ₽ / час

Работаем по безналичному расчёту, без НДС. Реквизиты ИП.

Расширяем возможности Битрикс24