Вебхук для Битрикс 24
Veeneo может отправлять офлайн-конверсии из Битрикс24 в яндекс метрику, используя вебхук.
События в системы аналитику будут отправляться при достиженнии заданных условий в блоке 3. Например, можно настроить отправку конверсии в метрику на событие(добавление лида/сделки) или когда сделка приходит на определенную стадию, в конкретной воронке.
Внимание! Перед началом работы включите учет офлайн-конверсий.
![Document image Document image](https://images.archbee.com/9uMSHEm02UuyRb4W3S8nw/AmirX5mSRZHQmmi47Y8e0_image.png?format=webp)
![Document image Document image](https://images.archbee.com/9uMSHEm02UuyRb4W3S8nw/ywCo0VZ82y3ZJ4-Pp7cwD_image.png?format=webp)
Он может быть доступен в левом меню или в него можно попасть через верхнее меню пройдя по пути: Интеграции -> REST API
Кликаем на "Интегрировать с внешними системами" -> "Синхронизировать контрагентов"
![Document image Document image](https://images.archbee.com/9uMSHEm02UuyRb4W3S8nw/fANW624WIxF5Q6NYUasVQ_image.png?format=webp)
- Даем название интеграции
- Копируем URL в поле "Вебхук для вызова rest api"
- Включаем исходящий вебхук
- В "URL вашего обработчика" вставляем "https://api.veeneo.ru/webhooks/bitrix24/ym-conversions"
- Токен копируем и вставляем в поле "Токен приложения"
- Назначаем события, при которых Veeneo будет получать уведомления от Битирикс24: - ONCRMDEALADD - ONCRMDEALUPDATE - ONCRMLEADADD
- Выбираем права "CRM"
- Сохраняем
- Получаем токен, кликнув на ссылку "Получить токен"
- Указываем ID счетчика метрики, в который будут отправляться офлайн-конверсии
Человеческие названия для пользовательских полей могут быть недоступны и это нормально. Если загрузка прошла успешно, то вы увидите таблицу справа с полями.
![Document image Document image](https://images.archbee.com/9uMSHEm02UuyRb4W3S8nw/4KsVbvHjpeHRTYPqROM53_image.png?format=webp)
Всего их 3:
- CLIENT_ID
- USER_ID
- YCLID
Подробнее про идентификаторы тут.
![Document image Document image](https://images.archbee.com/9uMSHEm02UuyRb4W3S8nw/vSZmCISdupafRT7mUdZbg_image.png?format=webp)
- Кнопка для дублирования/размножения поля. Когда идентификатор может храниться в нескольких полях карточки, мы можем добавить эти поля в настройках связки. Тогда veeneo будет перебирать указанные поля до тех пор, пока не найдет первое заполненное. Найдя первое заполненное поле, veeneo будет использовать его для загрузки текущей офлайн-конверсии в метрику. Полей может быть сколько угодно.
- Использование регулярного выражения Иногда бывает, что поле с идентификатором заполняется строкой, где сам идентификатор находится где-то внутри неё. Например: - _ym_uid=11111222222223333344444; _ym_d=2222222; _ym_isad=1 - здравствуйте, ваш номер чата [1111112222333334444] Настройка включает/отключает использование регулярного выражения для извлечения идентификатора из поля. Внимание! Регулярное выражение обязательно протестируйте на вкладке "Тестирование Regex". Например для строки: "_ym_uid=11111222222223333344444; _ym_d=2222222; _ym_isad=1" регулярное выражение будет "ym_uid=(\d*)", что в итоге дает нам "11111222222223333344444" в результате.
- Поле куда нужно вставить регулярное выражение. Для каждого поля регулярное выражение может быть свое уникальное.
- Хеширование Md5 Включает/отключает хеширование md5 для найденного идентификатора. Доступно только для USER_ID.
Маппинг поля происходит путем перетаскивания поля из списка справа в поле "Mapping field". Внимание! Важно указывать именно ID поля. Если человеческое название поля недоступно, то узнать ID поля можно пройдя в его редактирование. Перейдя в редактирование, вы увидите в URL что-то подобное: https://{ваш домен битрикс}/crm/configs/fields/CRM_DEAL/edit/UF_CRM_1716899173/ UF_CRM_1716899173 - это и есть ID нужного поля. Теперь идем в список полей в veeneo и перетаскиваем поле с таким ID в "Mapping field".
![Document image Document image](https://images.archbee.com/9uMSHEm02UuyRb4W3S8nw/mfSGP980Or-mH-kE2kqD1_image.png?format=webp)
Из метрики загружаются цели только с типом "Событие", тк с другими типами нельзя загрузить офлайн-конверсии.
Все ненужные цели мы удаляем нажав на кнопку "Х".
Оставшиеся нужные цели, мы заполняем перетаскивая нужные стадии, чтобы получилось так:
![Document image Document image](https://images.archbee.com/9uMSHEm02UuyRb4W3S8nw/lg5NL95H3KDEO1RZ2bEq6_image.png?format=webp)
Когда всё будет заполнено, можно нажимать "Добавить вебхук".
Важно учитывать, что в отключенном проекте вебхук работать не будет. Так же конверсии не будут загружаться в метрику, если у самого вебхука статус "Выключен".
![Document image Document image](https://images.archbee.com/9uMSHEm02UuyRb4W3S8nw/Uf8mFUxT4VvVFjMzZ6kH__image.png?format=webp)