Попробовать

Интеграция с Битрикс24

📂 В этой статье вы узнаете как интегрировать коннектор Smart Data Hub для получения данных о лидах и сделках из «Битрикс24

Битрикс24 – это единая платформа для организации работы всей компании. В составе платформы пять модулей: CRMСовместная работаЗадачи и проектыСайты и магазины и Автоматизация. Возможности каждого модуля функционально ограничены выбранным тарифным планом. Дополнительная функциональность Битрикс24 расширяется установкой приложений сторонних разработчиков, доступных через собственный маркетплейс приложений «Битрикс24.Маркет Плюс». Битрикс24 доступна в любой операционной системе и поставляется как в облачной, так и в коробочной версии.

Мы рассмотрим интеграцию сервиса Smart Data Hub c облачной версией продукта «Битрикс24». Также данная инструкция позволяет выполнить интеграцию с коробочной версией «1С-Битрикс24» в редакции «Корпоративный портал -50, -100, -250 и -500» (при работе с лидами и сделками).

📦 Что отправляем в Smart Data Hub?

В аналитическую платформу получаем значения полей CRM-сущности Сделка (воронки сделок, стандартная воронка лидов, кастомные поля). Обратите внимание, коннектор с данной версией продукта не работает с архивной сущностью Заказ.

Процесс интеграции выполняется в 2 этапа:

  1. добавление приложения в вашей CRM;
  2. добавление интеграции в Smart Data Hub.

🔗 Возможности Битрикс24

Этап 1. Добавление приложения в вашей CRM

1. Авторизуйтесь на портале «Битрикс24» по адресу https://имя_вашего_портала.bitrix24.ru, где «имя_вашего_портала» – адрес вашего портала.

2. Слева в меню найдите раздел «Приложения», а в нём подраздел «Разработчикам» и перейдите в него. 

Либо сразу перейдите по ссылке https://имя_вашего_портала.bitrix24.ru/devops/, где «имя_вашего_портала» – адрес вашего портала.

3. Далее, среди предлагаемых способов интеграций, выберите «Другое»:

Затем выберите вариант «Локальное приложение»:

4. В открывшемся окне заполняем поля формы:

5. Если вы всё верно сделали, то окно автоматически обновится — созданное приложение добавится на сервер вашего портала Битрикс24 и появятся два новых поля. Если этого не произошло — перейдите к шагу 6.


Для дальнейшей настройки нам понадобится содержимое новых полей «Код приложения (client_id)» и «Ключ приложения (client_secret)» — скопируйте и сохраните содержимое этих полей. Затем нажмите кнопки «Сохранить» и «Закрыть»:


6.
 Вне которых случаях, после создания локального приложения необходимо войти в его настройки вручную. Для этого слева в меню выбираем «Приложения», далее «Разработчикам», далее «Интеграции»:

Откроется список установленных локальных приложений. Выберите приложение Smart Data Hub:

Затем, через контекстное меню приложения выберите «Редактировать», скопируйте и сохраните содержимое полей «Код приложения (client_id)» и «Ключ приложения (client_secret)»:

7. На этом установка локального приложения в Битрикс24 завершена — переходим к следующему этапу.

Этап 2. Добавление интеграции в Smart Data Hub

8. Перейдите в личный кабинет Smart Data Hub по ссылке https://cloud.smartanalytics.io/ru (на отдельной открытой вкладке или через закладку).

Через меню слева перейдите на страницу «Коннекторы», далее находим в списке необходимую интеграцию с «Битрикс24» и кликаем на кнопку «Подключить»:

9.  Авторизация.

Введите ранее полученные код приложения, ключ приложения, а также адрес портала с указанием протокола «https://», необходимые для авторизации приложения в сервисе. Затем кликните на кнопку «Подключить»:

10. Фильтрация  (этап можно пропустить). 

После успешного установления связи между порталом Битрикс24 и коннектором сервиса Smart Data Hub переходим к заданию условий фильтрации данных. 

Для этого выберите параметр в левой части окна и, удерживая курсор, перенесите в правую часть: 

Также для выбора параметра можно дважды кликнуть по нему — он автоматически перенесется в правую часть:

Введите (или выберите из предложенных) значение для данного поля. Затем кликните на кнопку «Далее»:

11. Соответствия полей

Данный этап интеграции разделен на два шага. Каждый можно использовать, открыв соответствующий раздел в поле выбора слева (на рисунке ниже области «1» или «2»).

На рисунке ниже:
1) Сделка, Лид… — список воронок с перечнем выгруженных статусов сделок и лидов;
2) Кастомные поля — список выгружаемых аналитических полей (UTM-метки, ID метрики и т.п.);
3) Область контейнеров с заголовками, сформированными сервисом по умолчанию: Обращения, Некачественные, Лиды, Оплачен:

11.1 Соответствия полей. Шаг первый. Вариант с группировкой.

Укажите сервису как группировать поступающие данные по статусам из выбранной нами воронки продаж, соотнося статусы из Битрикс24 в левой части с таковыми в Smart Data Hub  в правой части экрана. Так Вы определите контейнеры, соответствующие статусам сделок в Битрикс24


На рисунке ниже:
1) Выбранная вами воронка, после клика на значок показывает список статусов воронки из Битрикс24;
2) Заголовки контейнеров отражают статусы воронки в сервисе Smart Data Hub, их можно переименовать кликнув по названию;
3) Удерживая курсор, перенесите статусы в каждый «контейнер», тем самым группируя их:

Группировку статусов выполняют, когда в отчете необходимо увидеть результат по группе статусов в целом. Так, например, «успешных» или «провальных» статусов может быть несколько, как и несколько вариантов статуса «в работе»… Если вы решили использовать группировку, то для завершения первого шага переходите к п.11.2.

Соответствия полей. Шаг первый. Вариант без группировки.
Теперь рассмотрим вариант без группировки статусов. Также соотносите статусы воронки в левой части экрана с контейнерами в правой части, каждый из которых, для удобства переименуйте согласно статусу. В данном примере мы применили группировку только для статуса «Сделка провалена», добавив все доступные негативные статусы выбранной воронки:

11.2 Для завершения первого шага осталось «Указать маркер» в контейнерах. В Smart Data Hub предусмотрено четыре маркера: Завершенная сделкаОтказВозврат и Пауза в обработке. Каждый из маркеров может быть установлен только на одном этапе (в одном контейнере). Маркер необходим для указания сервису логики обработки статусов сделки при формировании будущих отчетов. 

Маркер Отказ сообщает сервису о том, чтобы тот не проставлял предыдущий статус как пройденный. В статусе «Сделка провалена» сервис не проставит предыдущие статусы, если сделка на них не находилась. Так как, фактически, пользователь может получить провал в любом статусе сделки и сразу поставить в CRM статус «Сделка провалена» пропустив промежуточные статусы.

Маркер Завершенная сделка сообщает сервису о том, что при перемещении сделки в этот статус значение поля «Сумма сделки» в Битрикс24 необходимо передать в поле «Объем продаж» в Smart Data Hub. В статусе «Сделка успешна» сервис автоматически проставляет все предыдущие статусы как пройденные, даже если пользователь не проводил сделку в этих статусах, так как считается, что иначе сделка не была бы успешной, если не прошла статус: встреча, договор, оплата и т. п.

В итоге контейнеры примут следующий вид:

Так же можно настроить получение иных данных из Битрикс24. Для этого перейдите на вкладку «Кастомные поля» и перетащите все необходимые кастомные поля в контейнер «Остальные поля», по которым необходимо забирать данные в систему Smart Data Hub. Если контейнер «Остальные поля» оставить пустым, то сервис загрузит значения всех доступных полей, если же что-то выбрать, то только выбранные:

11.3 Соответствия полей.  Второй шаг.

Статусы воронки Вы перенесли, теперь, по аналогии, необходимо перенести пользовательские поля — они находятся слева, во вкладке «Кастомные поля», в область контейнеров справа. Обратите внимание, что названия и количество контейнеров уже задано — они недоступны для создания, изменения или удаления.

Например, переносим пользовательские поля содержащие значения «UTM-меток». (Если вы принимаете данные «UTM-меток» в системное поле «Битрикс24», то данные из него будут переданы в любом случае — в списке полей оно скрыто). Так же это может быть поле со значением идентификатора пользователя Яндекс.Метрики (_ym_uid):

После того, как закончите распределение всех статусов и полей, нажмите кнопку «Далее».

12. Калькуляция (этап можно пропустить).

На данном этапе необходимо добавить дополнительные вычисляемые поля на основе уже имеющихся численных значений. Предложенные поля из левой части необходимо перенести в правую часть…

…и дописать к ним какие-либо арифметические действия, после чего значения полей будут вычисляться автоматически:

После завершения настроек необходимых полей нажмите кнопку «Закрыть»:

Поздравляем, интеграция завершена! 🥳

После успешного завершения интеграции, под логотипом «Битрикс24» будет отображаться статус интеграции «Подключено»:

Если вам, по каким-либо причинам, необходимо отключить, сбросить настройки или отредактировать интеграцию с «Битрикс24», либо сменить настройки доступов, то для этого наведите курсор на коннектор и кликните на значок троеточия, а в открывшемся меню выберите нужный вариант:

Советуем также почитать:
Интеграция с amoCRM
Интеграция с RetailCRM
Меню действий коннектора и описание статусов интеграции