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

Коннектор Битрикс24 и другие приложения для Битрикс24

Техническая документация

Подробное руководство по использованию BI Data Connector для интеграции Битрикс24 и Power BI

Создание вебхука
Подключение шаблона
API методы
Решение проблем

Создание вебхука в Битрикс24

Шаг 1: Переход в раздел REST API

Перейдите в административную панель Битрикс24:

https://ваш-портал.bitrix24.ru/devops/

Или через меню: CRM → Интеграции → Rest API

Шаг 2: Создание нового вебхука

  1. На вкладке "Готовые сценарии" нажмите "Импортировать/экспортировать данные"
  2. Выберите "Другое"
  3. В открывшемся окне:
    • Дайте название вебхуку (например: "BI Data Connector")
    • Снимите галку "Виджеты"
    • Оставьте галку "Входящий вебхук"

Шаг 3: Настройка прав доступа

В разделе "Настройка прав" выберите следующие права:

CRM (crm)
Структура компании (department)
Телефония (telephony)
Пользователи (user)
Задачи (task)
Списки (lists)

Шаг 4: Сохранение и получение URL

После нажатия "Сохранить" вы получите URL вебхука вида:

https://ваш-портал.bitrix24.ru/rest/123/abc123def456/
Важно: Сохраните этот URL - он понадобится для подключения шаблона Power BI

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

Шаг 1: Получение параметров BI-Аналитики

Перейдите в Битрикс24: CRM → Аналитика → BI-Аналитика

В блоке Microsoft Power BI скопируйте:

  • Адрес сервера - понадобится как параметр "Адрес_сервера_Б24"
  • Секретный ключ - понадобится как параметр "Секретный_ключ"

Шаг 2: Настройка параметров в Power BI

  1. Откройте файл шаблона Power BI (.pbit)
  2. При открытии появится окно с параметрами
  3. Заполните параметры:
Параметр Описание Пример
Адрес_сервера_Б24 Адрес сервера из BI-Аналитики https://your-portal.bitrix24.ru/rest/bi/...
Секретный_ключ Секретный ключ из BI-Аналитики abc123def456...
Адрес_вебхука URL созданного вебхука https://your-portal.bitrix24.ru/rest/123/...

Шаг 3: Загрузка данных

  1. Нажмите "Загрузить" в окне параметров
  2. На все вопросы до начала загрузки отвечайте "Да"
  3. Дождитесь завершения загрузки данных
  4. Сохраните файл в формате .pbix
Готово! Ваш отчёт Power BI подключен к данным Битрикс24

Доступные API методы

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

Основные методы для получения данных через нативный коннектор:

crm_deal Сделки
crm_lead Лиды
crm_company Компании
crm_contact Контакты
telephony_call Звонки
task Задачи

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

Методы для получения расширенных данных:

department.get Структура компании
crm.status.list Статусы CRM
crm.invoice.list Счета (старые)
lists.* Универсальные списки

Решение проблем

Ошибка "Не удалось подключиться к источнику данных"

Возможные причины:

  • Неверно указан адрес сервера или секретный ключ
  • Недостаточно прав у вебхука
  • Вебхук был удалён или деактивирован

Решение:

  1. Проверьте параметры подключения в CRM → Аналитика → BI-Аналитика
  2. Убедитесь, что вебхук существует и активен
  3. Проверьте права доступа вебхука

Медленная загрузка данных

Возможные причины:

  • Большой объём данных
  • Ограничения тарифа Битрикс24
  • Сетевые проблемы

Решение:

  1. Используйте фильтрацию данных по датам
  2. Рассмотрите переход на коробочную версию
  3. Оптимизируйте запросы в Power BI

Отсутствуют некоторые поля

Возможные причины:

  • Поля не включены в нативный коннектор
  • Недостаточно прав доступа
  • Поля были удалены в Битрикс24

Решение:

  1. Используйте REST API методы для получения дополнительных полей
  2. Проверьте настройки прав вебхука
  3. Обратитесь в техническую поддержку

Нужна помощь?

Если у вас остались вопросы или нужна техническая поддержка:

  • Проверьте раздел FAQ
  • Свяжитесь с нашей технической поддержкой
  • Закажите индивидуальную консультацию
Связаться с поддержкой