Sales Ninja — документация

# Bitrix24

В меню: Настройки → Интеграции → Bitrix24.

Bitrix24 — источник лидов, сделок и справочников для целей Sales Ninja. Интеграция читает CRM по входящему webhook; цели после подключения создаются вручную.

# Уровни интеграции

Уровень Доступно Где настраивается
Project ✅ Настройки → Интеграции → Bitrix24
ML-сигнал — —
JS-действие — —

# Зачем подключать

# Что нужно подготовить

  1. URL входящего webhook Bitrix24 с доступом на чтение CRM.
  2. Пользовательские поля в лидах и/или сделках под yclid и Yandex Client ID (системные имена вида UF_CRM_*). Штатных универсальных полей yclid / Client ID в Bitrix24 нет — UTM и «источник» сами по себе для точного матча не заменяют идентификаторы.
  3. Передача этих полей с сайта (форма, виджет или серверная интеграция) — Sales Ninja не заполняет их в Bitrix24 сам.

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

  1. Настройки → Интеграции → Добавить → Bitrix24.
  2. Заполните Название и URL входящего webhook.
  3. Сохраните: система проверит webhook.
  4. Нажмите Синхронизировать каталог — локальный снимок стадий, воронок и CRM-полей. Цели читают именно этот каталог.
  5. Создайте цель типа Bitrix24 (см. ниже).

# Цель Bitrix24

  1. Цели → Добавить → тип Bitrix24.
  2. Выберите интеграцию.
  3. В блоке источника укажите сущность (лид / сделка), стадии и при необходимости воронки. Несколько стадий — фильтр одной цели, не отдельная цель на каждую стадию.
  4. В маппинге полей укажите, куда в CRM пишутся yclid, Client ID и при необходимости UTM.
  5. Запустите Быструю проверку на форме цели — она покажет, есть ли строки и ключи матча в выборке.
  6. Подключите цель к моделируемой конверсии.

Общий playbook: От интеграции к цели.

# Ограничения и типичные ошибки

Симптом Что проверить
Ошибка авторизации URL webhook, права на чтение CRM
Каталог пустой / неполный «Синхронизировать каталог»; после новых UF-полей — обновить снова
Сделки есть, матча нет Заполненность yclid / Client ID в карточках; маппинг полей в цели
«Готовность» на форме красная Подсказки блока «Готовность настройки» и результат быстрой проверки

# Связано

← Calltouch →