Оформление

amoCRM

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

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

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

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

Подготовьте доступ ​

  1. Администратор amoCRM должен создать интеграцию в разделе amoMarket → Установленные → Создать интеграцию. Используйте интеграцию именно нужного аккаунта.
  2. В разрешениях выберите «Данные аккаунта» (crm). Для чтения сделок отдельные права на файлы, удаление файлов и уведомления не нужны. Доступ также зависит от прав пользователя, выдавшего токен.
  3. Во вкладке «Ключи и доступы» скопируйте ID интеграции и секретный ключ. Там же создайте долгосрочный токен, выберите срок действия и сразу скопируйте его: повторно его не показывают.

Данные подключения ​

Откройте Настройки проекта → Интеграции → Добавить, выберите сервис и задайте понятное название подключения.

ПолеЧто вставить
ID интеграцииID интеграции из вкладки «Ключи и доступы» в amoCRM; это не ID аккаунта.
Секретный ключСекретный ключ из той же интеграции amoCRM.
Долгосрочный токенДолгосрочный токен из этой интеграции; код авторизации сюда не подходит.

Нажмите Сохранить. При редактировании оставьте скрытый сохранённый секрет без изменений, если не хотите заменить его.

После сохранения ​

При сохранении проверяем токен и определяем аккаунт amoCRM. Затем создайте цель amoCRM, выберите подключение и обновите справочники кнопкой рядом с этим выбором. Укажите нужные статусы или теги. Подключение не создаёт цели автоматически. Токен не продлевается автоматически: после истечения срока его нужно заменить.

Если подключение не работает ​

Убедитесь, что ID, секрет и токен относятся к одной интеграции и аккаунту. Нужен долгосрочный токен, а не код авторизации. Проверьте срок действия, разрешение «Данные аккаунта» и доступ пользователя к сделкам.

Инструкции сервиса ​

Цель amoCRM ​

  1. Откройте Данные → Цели → Создать → Звонки и CRM → amoCRM, выберите подключение и обновите каталог.
  2. Выберите статусы заявок в нужных воронках или хотя бы один обязательный тег. Полностью пустой отбор не сохраняется. Если выбраны только обязательные теги, заявки учитываются независимо от текущего статуса.
  3. Для обязательных тегов задайте Достаточно любого или Нужны все. Исключаемые теги задаются отдельно. Проверьте, что обязательные и исключаемые теги не противоречат друг другу.
  4. В Выручка выберите Бюджет заявки или Не передавать. Остальные денежные настройки описаны в выручке и прибыли целей.
  5. Выберите пользовательские поля Sales Ninja session id, yclid и Yandex Client ID, которые сайт действительно передаёт в CRM. При необходимости укажите UTM-поля. Доступное поле без значения не связывает заявку с визитом.
  6. Сохраните цель, дождитесь синхронизации и проверьте конверсии: статус/теги записи, привязку к визиту и сумму.

Выберите несколько равнозначных статусов в одной цели. Если квалификация и покупка — отдельные этапы вашего бизнеса, создайте для них отдельные цели и добавьте в воронку.

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

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

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

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

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

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