Интеграция

Получение лидов и сделок из Bitrix24 → Отправка статусов событий в VK Ads

В этой инструкции настроим связку Bitrix24 → VK Ads (конверсии): получение данных по лидам и сделкам из Bitrix24, отправку статусов событий в VK Ads. Ниже — шаги по порядку, с примерами.

Отдельные инструкции: источник «Получение лидов и сделок из Bitrix24» · действие «Отправка статусов событий в VK Ads»

Создание подключений

Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.

Подключение Bitrix24

Приложение в маркетплейсе

Перед подключением через OAuth установите приложение Webjack в маркетплейсе Bitrix24 для своей страны:

Россия - webjack.connector
Беларусь - webjack.connector_by
Казахстан - webjack.webjack_kz

Создание подключения

В меню слева выберите «Подключения».
Нажмите «+».
Выберите тип «Bitrix» и нажмите «Выбрать».
В поле «Сайт» укажите адрес портала Bitrix24, например https://company.bitrix24.ru.
В поле «Регион» выберите способ подключения.

Регион «Россия», «Беларусь» или «Казахстан»

Убедитесь, что приложение для этой страны уже установлено в портале.
В поле «Регион» выберите «Россия», «Беларусь» или «Казахстан».
При необходимости включите «Использовать постоянные IP».
Нажмите «Подключить» и авторизуйтесь в Bitrix24 под администратором портала.
После успешной авторизации подключение появится в списке.

Регион «Webhook»

Используйте этот способ, если приложение из маркетплейса установить нельзя - например, на коробочном Bitrix24.

В Bitrix24 создайте входящий вебхук с правами CRM.
Скопируйте URL вебхука для вызова REST API.
В поле «Сайт» вставьте этот URL.
В поле «Регион» выберите «Webhook».
При необходимости включите «Использовать постоянные IP».
Нажмите «Подключить».

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

В списке типов источника выберите «Bitrix» и нажмите кнопку «Выбрать».

Источник «Bitrix»

При изменении лида или сделки в Bitrix24 данные сущности поступают в обработку. Выберите подключение портала, событие и способ доставки - подписку или URL исходящего вебхука.

Подключение и событие

В поле «Подключение» выберите аккаунт Bitrix24.
В поле «Событие» отметьте «Лид изменен» или «Сделка изменена».
Если события должны приходить через API Bitrix24, включите «Подписаться на событие».
Нажмите «Сохранить».

URL источника

Откройте вкладку «Источник данных».
Скопируйте «URL» - он нужен для исходящего вебхука, если подписка не включена.

Исходящий вебхук в Bitrix24

Используйте этот блок, если не включали «Подписаться на событие».

В Bitrix24 откройте «CRM» → «Сделки» или «Лиды» (по выбранному событию).
Нажмите «Роботы».
Нажмите «Создать».
Откройте «Другие роботы» и выберите «Исходящий вебхук».
Укажите условие срабатывания, вставьте скопированный «URL» и нажмите «Сохранить».

Действие «Отправка данных о статусах событий в VK Ads»

Статусы событий уходят в воронку CRM VK Ads. ID конверсии - это vk_conversion_id из лида формы: сохраните его в CRM и после конверсии передайте обратно в VK Ads.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"

Параметры отправки

В поле «Токен» укажите токен авторизации воронки CRM из VK Ads.
В поле «ID конверсии» укажите vk_conversion_id из данных лида формы.
В поле «Название события» укажите название, например DEAL.
В поле «Статус события» укажите статус из данных сценария.
Нажмите «Сохранить».

Как получить токен

Откройте рекламный кабинет VK Реклама.
Перейдите в раздел «Конверсии».
Откройте вкладку «Воронки CRM и коллтрекинг».
Нажмите «Добавить воронку» и выберите «Webjack».
Скопируйте «Токен авторизации» и нажмите «Подключить».

Запустите обработку

В обработку начнут поступать данные из настроенного источника.
По очереди выполнятся все добавленные действия.
Входящие данные, статус и история отобразятся в «Истории операций».