Настройка интеграции перед подключением
1. На платформе «Битрикс 24» в верхнем горизонтальном меню перейдите в раздел «Интеграции» → «Rest API».
2. В открывшимся раздее выбрать «Другое».
3. В данном окне необходимо настроить исходящий вебхук и локальное приложение.
4. ИСХОДЯЩИЙ ВЕБХУК:
4.1 В поле «URL вашего обработчика» укажите следующий адрес: https://accountN.edpro.biz/api/v1/bitrix24/webhook?token=fbf023ae052e64dc9954a96ce710bbb3, где N — ID Вашего аккаунта.
4.2 В поле «События» выбрать следующие пункты:
- Создание сделки (ONCRMDEALADD)
- Обновление сделки (ONCRMDEALUPDATE)
- Создание контакта (ONCRMCONTACTADD)
- Обновление контакта (ONCRMCONCATUPDATE)
- Создание компании (ONCRMCOMPANYADD)
- Обновление компании (ONCRMCOMPANYUPDATE)
- Добавление элемента смарт-процесса (ONCRMDYNAMICITEMADD)
- Изменение элемента смарт-процесса (ONCRMDYNAMICITEMUPDATE)
- Удаление элемента смарт-процесса (ONCRMDYNAMICITEMDELETE)
- Добавление счета (ONCRMINVOICEADD)
- Изменение счета (ONCRMINVOICEUPDATE)
- Удаление счета (ONCRMDINVOICEELETE)
4.3 Нажмите «Сохранить» для завершения создания исходящего вебхука, после чего закройте окно для возвращения в раздел «Другое».
5. ЛОКАЛЬНОЕ ПРИЛОЖЕНИЕ:
5.1 Отметьте галочкой «Использует только API».
5.2 В поле «Путь вашего обработчика» вставьте следующий адрес https://accountN.edpro.biz/api/v1/bitrix24/handle?token=fbf023ae052e64dc9954a96ce710bbb3, где N — ID Вашего аккаунта.
5.3 В поле «Путь для первоначальной установки» вставьте следующий адрес: https://accountN.edpro.biz/api/v1/bitrix24/oauth?token=fbf023ae052e64dc9954a96ce710bbb3, где N — ID Вашего аккаунта.
5.4 В пункте «Настройка прав» выберите CRM (crm).
5.5 Нажмите «Сохранить» для завершения настройки локального приложения.
5.6 После перезагрузки формы скопируйте поля «Код приложения (client_id)» и «Код приложения (client_id)» в соответствующие поля формы слева.
Настройка интеграции после подключения
Настройте соотстветствие между данными платформы и Битрикс24, выбрав необходимое поле. В случае когда вы не можете найти новодобавленное поле — для повторной синхронизации списка дополнительных атрибутов нажмите на «данную кнопку» в Вашем аккаунте:
Поля E-mail, Телефон и т.д. при отсутствия выбора будут использовать поля Битрикс по умолчанию.
Как передать информацию о партнере из Битрикс24 на платформу EdproBiz
На платформе EdproBiz закрепление за партнером происходит по партнерской ссылке, которая имеет уникальный код партнера.
Пример ссылки, https://project8868641.tilda.ws/page45819251.html?fuid=000000000&utm_source=partnerlink&subid=12671&subid2=62ce9ys4c,
где 000000000 – это уникальный код партнера, который позволяет системе понять, что этот лид пришел именно от этого партнера.
ID партнера можно посмотреть в карте клиента:
Для фиксации этих меток необходимо:
1. В Битрикс24 создать поле, в которое будет записываться ID партнера из ссылки (fuid).
Новое поле можно создать в разлеле Настройки — Настройки CRM — Настройки форм и отчетов — Пользовательские поля — Сделка — Добавить поле в сделку.
Заполняем основные поля. Название можно задать произвольное. Сохраняем.
2. Разместить скрипт на сайте, чтобы он сохранял значение fuid в это поле на стороне Б24.
3. В настройках интеграции на платформе EdproBiz созданное доп. поле также необходимо сопоставить с полем «ID партнера заказа».
После этого информация будет передаваться в EdproBiz, где на основании поля ID партнера заказа будет происходить закрепление (при условии, что клиент ранее не имел партнера).
Пример кода для работы партнерских ссылок
*** Данный скрипт можно взять за основу, при необходимости Ваши специалисты могут сами написать JS-скрипты для корректного захвата поля fuid на Вашем сайте.
<script> $(document).ready(function () { setTimeout(function(){ /* Добавление поля fuid в форму */ function makeFuidField() { let $form = $('form'); if ($form.length && !$form.find('input[name="fuid"]').length) { $('<input>', { 'type': 'hidden', 'name': 'fuid', }).prependTo($form); console.log('fuid field added'); } } makeFuidField(); /* Заполнение партнерского кода из get параметра fuid */ function fillFuid() { let params = (new URL(document.location)).searchParams; $fuid = $('form input[name="fuid"]'); if ($fuid.length) { $('form input[name="fuid"]').val(params.get("fuid")); console.log('fuid sets'); } } $('form button[type="submit"]').click(function () { fillFuid(); }); fillFuid(); }, 2000); }); </script>2 способ передачи информации — это ручное создание сделки в Битрикс24.
Для этого необходимо создать поле, в котором будете указывать ID или email партнера заказа и сопоставить его в настройках интеграции.
При создании сделки вручную необходимо указывать информацию о партнере.
Закрепление произойдет, если клиент ранее не был ни за кем закреплен.
Также есть возможность указывать ID или email партнера пользователя, если это необходимо:
