Webjack
Вход Начать
Получение лидов и сделок из Bitrix24 Создание или обновление сделки в OkoCRM

Интеграция

Получение лидов и сделок из Bitrix24 → Создание или обновление сделки в OkoCRM

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

  1. Настройка получения событий из Bitrix24: подключение портала, выбор лида или сделки, подписка на событие или исходящий вебхук с URL.
  2. Действие создаёт сделку в OkoCRM или обновляет найденную по названию, контакту, статусу или ID. После записи можно привязать контакт к сделке.

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

Не хотите настраивать сами? Сделаем бесплатно

Напишите, какие сервисы нужно связать. Специалист настроит интеграцию, проверит, что данные доходят, и оставит вам готовый процесс.

Получить бесплатную настройку Или следуйте инструкции ниже

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

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

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

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

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

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

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

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

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

Регион «Webhook»

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

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

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

Как подключить OkoCRM

«Подключение» хранит токен API аккаунта OkoCRM. С ним Вебджек создаёт и обновляет контакты и сделки.

  1. Войдите в OkoCRM.
  2. Нажмите иконку аватара, затем имя пользователя.
  3. Прокрутите профиль вниз и скопируйте значение поля «Токен для API».
  1. В Вебджеке откройте подключение «OkoCRM».
  2. Вставьте токен в поле «Токен API».
  3. Нажмите «Подключить».

Вебджек проверяет токен запросом списка пользователей. Если токен принадлежит одному пользователю, подключение получит его имя и почту. Иначе название будет «OkoCRM».

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

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

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

Источник «Bitrix»

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

Выбор типа источника

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

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

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

URL источника

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

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

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

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

Действие «OkoCRM: Создать или обновить сделку»

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

Что делает действие

«Действие» создаёт сделку в OkoCRM или обновляет уже существующую. После записи можно привязать контакт.

Обязательные поля при создании: «Название сделки», «Воронка», «Этап воронки».

Как настроить

  1. Выберите подключение «OkoCRM». Воронки, этапы и пользователи подгрузятся из аккаунта.
  2. В поле «Обработка дубликатов» выберите режим:
    • «Не проверять на дубликаты». Всегда создавать новую сделку.
    • «Не создавать при дубликате». Если сделка найдена, новую не создавать.
    • «Обновить дубликат, иначе создать». Обновить найденную сделку или создать новую.
    • «Только обновить дубликат». Менять только найденную сделку.
  3. Заполните поля и отметьте колонки поиска или записи.
  4. Если сделку нужно связать с контактом, заполните «ID контакта».
  5. Нажмите «Сохранить».

Поиск дубликата идёт по «Названию сделки», если у поля включён поиск. Дополнительно можно сузить выборку:

  • «Строка поиска». Текст уходит в поиск OkoCRM, если он длиннее названия.
  • «Искать дубликат по ID контакта» вместе с «ID контакта». В дубликаты попадут только сделки этого контакта.
  • «Отбор по статусу». «Все», «Открытые» или «Закрытые». Закрытой считается сделка на этапе с типом успеха или отказа.

Этих трёх условий достаточно для поиска, даже если колонки полей не отмечены. Поле «ID» открывает сделку напрямую. Если ID нет в OkoCRM, действие останавливается с сообщением «Не найден объект».

Несколько совпадений без галочки «Выбирать дубль по макс. ID» останавливают действие с ошибкой «Количество дубликатов больше одного».

«ID контакта» после создания или обновления привязывает контакт к сделке. Если режим «Не создавать при дубликате» и сделка уже найдена, привязка не выполняется. Ошибка привязки пишется в журнал и не отменяет уже сохранённую сделку.

После выполнения доступны «ID сделки», «Дубликат» и «ID ответственного».

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

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

integrations: Входящие данные, статус и история отобразятся в «Истории операций»

Застряли на подключении или полях?

Соберём обработку «Получение лидов и сделок из Bitrix24 → Создание или обновление сделки в OkoCRM», проверим тест и запустим.

Получить бесплатную настройку