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

# RetailCRM

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

RetailCRM — источник заказов, статусов и справочников для целей Sales Ninja. Интеграция только читает данные; цели после подключения создаются вручную.

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

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

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

  • Передавать в Sales Ninja реальные заказы и статусы из RetailCRM.
  • Строить цели по статусам / сайтам / полям и использовать их в моделируемых конверсиях.
  • Не зависеть от ручных выгрузок, если заказы уже живут в RetailCRM.

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

  1. Адрес кабинета RetailCRM (например https://example.retailcrm.ru).
  2. API-токен с правами на чтение:
    • order_read — заказы и история;
    • reference_read — справочники (статусы, сайты…);
    • custom_fields_read — пользовательские поля для автодополнения в целях.
  3. Идентификаторы Яндекса в заказе или клиенте: yclid и Yandex Client ID. UTM полезны как запасной признак, точный матч начинается с идентификаторов.

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

  1. Откройте Настройки → Интеграции → Добавить → RetailCRM (в форме: «Интеграция с RetailCRM»).
  2. Заполните Название, Адрес RetailCRM, API-токен.
  3. Сохраните: система проверит доступ на чтение заказов.
  4. Нажмите Синхронизировать каталог — локальный снимок статусов, сайтов, способов оформления и CRM-полей. Цели читают именно этот каталог.
  5. Создайте цель типа RetailCRM (см. ниже) — интеграция сама цель не создаёт.

# Цель RetailCRM

  1. Цели → Добавить → тип RetailCRM.
  2. Выберите интеграцию.
  3. Настройте фильтры на одной цели: статусы заказов, сайты и другие поля формы. Не создавайте отдельную цель на каждый статус — статусы это фильтр.
  4. При необходимости задайте способ расчёта прибыли.
  5. Подключите цель к моделируемой конверсии (часто УМК).

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

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

Симптом Что проверить
Ошибка авторизации Адрес кабинета, формат токена, права order_read
Каталог пустой / коды вместо названий reference_read, custom_fields_read, повторная синхронизация
Заказы есть, матча нет yclid / Client ID в заказе или клиенте
Цель без нужных статусов Каталог устарел — «Синхронизировать каталог»

Sales Ninja не пишет в RetailCRM и не меняет заказы.

# Связано

← Rick.ai →