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

# amoCRM

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

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

# Что подключается

Read-only интеграция с amoCRM по API v4. Sales Ninja хранит параметры интеграции проекта и использует access token для чтения аккаунта, воронок, статусов сделок, тегов, пользовательских полей и сделок.

# Что нужно для подключения

  • Аккаунт amoCRM с правом администратора.
  • Приватная интеграция amoCRM.
  • Integration ID (client_id) из amoCRM.
  • Secret key (client_secret) из amoCRM.
  • Долгосрочный access token amoCRM. Обычный OAuth access token живет около суток, а Sales Ninja сейчас не хранит refresh_token и не выполняет OAuth refresh-flow.

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

  1. В amoCRM зайдите под администратором.
  2. Откройте раздел интеграций / amoМаркет и создайте приватную интеграцию для Sales Ninja.
  3. Укажите название интеграции, описание, нужные права на данные аккаунта и Redirect URI. В текущем ручном сценарии Sales Ninja не использует редирект, но amoCRM требует валидный HTTPS URL при настройке OAuth-интеграции.
  4. Сохраните интеграцию и на вкладке ключей скопируйте Integration ID и Secret key.
  5. На вкладке ключей нажмите «Сгенерировать токен», выберите срок действия и сразу скопируйте токен. amoCRM показывает долгосрочный токен только один раз.
  6. В Sales Ninja откройте «Настройки → Интеграции → Добавить → amoCRM».
  7. Заполните поля:
    • «Название» - любое понятное имя внутри Sales Ninja, например amoCRM основной аккаунт;
    • «ID интеграции» - Integration ID из amoCRM;
    • «Секретный ключ» - Secret key из amoCRM;
    • Access token - долгосрочный токен amoCRM.
  8. Сохраните интеграцию. Sales Ninja проверит токен через API amoCRM и сохранит подтвержденный аккаунт и домен.
  9. После подключения создайте цель типа amoCRM: выберите интеграцию, статусы сделок, теги и поля для матчинга (snSessionId, yclid, ymClientId), если такие поля есть в amoCRM.

# Что становится доступно

  • Импорт сделок и лидов. Sales Ninja периодически читает изменения сделок и фиксирует переход в выбранные статусы как конверсии в проекте.
  • Привязка к сессиям Sales Ninja. Конверсия сопоставляется с пользователем по snSessionId, yclid, ymClientId, URL-данным, пользовательским полям и рематчингу по времени.
  • Цели по статусам. Каждый выбранный статус становится отдельной целью Sales Ninja и может использоваться в моделируемых конверсиях, антиботах, сегментах, A/B-тестах и т.п.

# Ограничения

  • Импорт идёт пачками, не моментально. Типичная задержка — единицы минут.
  • Sales Ninja не редактирует сделки в amoCRM - только читает.
  • Если токен истек или был отозван в amoCRM, интеграцию нужно переподключить новым долгосрочным токеном.
  • При смене Secret key или Integration ID в amoCRM обновите эти значения в Sales Ninja.

# Документация amoCRM

# Связанные страницы

← CallTouch →