Интеграция

Получение лидов и сделок из Bitrix24 → Запрос в MacroCRM

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

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

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

Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в 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» и нажмите «Сохранить».

Действие «Запрос в MacroCRM»

В MacroCRM создаётся заявка с данными клиента из сценария. Укажите сервер, ключ, сайт и заполните поля заявки.

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

Ключ в MacroCRM

В MacroCRM откройте раздел «Компания» → «Интеграции».
Добавьте сайт с понятным названием интеграции.
Скопируйте «Сайт (домен)» и «Защищенный ключ (app_secret)».

Параметры запроса

В поле «Сервер MacroCRM» выберите сервер аккаунта.
В поле «Действие» выберите тип заявки, например «Заявка на покупку».
Вставьте «Защищенный ключ (app_secret)» и «Сайт (домен)».
Заполните обязательные поля «Имя» и «Телефон».
При необходимости укажите «E-mail», «Теги», «ID объекта», «Коментарий», «ID менеджера», «Дата встречи» и UTM-метки.
Нажмите «Сохранить».

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

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