Вектор • Техническая документация

Настройка и техническая интеграция
Вектора с amoCRM

Страница для интеграторов и настройщиков, которые подключают и настраивают Вектор у клиента: роли и доступ, типы шагов, импорт из другого редактора, отслеживание исполнения и подключение вебхуков. Техническая страница, поэтому здесь — точные формулировки.

Подготовка аккаунта

С чего начать: требования к amoCRM

Перед подключением убедитесь, что в аккаунте клиента есть нужные права и не закрыты технические доступы.

1

Учётная запись с правами администратора

Для установки приложения Вектор нужен аккаунт администратора аккаунта amoCRM. Сам процесс затем выполняется от пользователя с правами на конкретные воронки, сделки, контакты и поля — это соответствует принципу минимальных прав.

2

Доступ к управлению приложениями и API

Приложение авторизуется через официальную модель краткоживущих ключей: не просит и не хранит пароль пользователя. Проверьте, что в amoCRM не отключён раздел «Приложения» и разрешены запросы на сервер Вектора.

3

Выделенный пользователь для процесса (желательно)

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

4

Сетевая доступность (для вебхуков)

Если внешние системы (CRM-партнёры, телефония, боты) отправляют события через вебхуки — их серверы должны иметь доступ к endpoint’у Вектора, а при строгом брандмауэре нужно открыть нужные домены и протокол.

🔑

О безопасности подключения

Вектор работает через официальное подключение amoCRM с ограниченными правами на избранные справочники. Обмен данными защищён, секреты и ключи не раскрываются в интерфейсе клиенту и в логах, а подключение всегда можно отозвать из аккаунта.

Действия на схеме

Типы шагов, из которых собираются процессы

Любой сценарий в Векторе — это последовательность шагов. Ниже — весь доступный набор с пояснением, что каждый шаг делает в аккаунте amoCRM.

СтартТочка входа: событие amoCRM, по которому запускается процесс.
КонецЗавершение маршрута сделки в процессе.
Смена статусаПереводит сделку в выбранный этап воронки.
ПолеЗаписывает или считывает значения полей сделки, контакта, компании.
ЗадачаСтавит менеджеру задачу с дедлайном и ответственным.
УсловиеВетвление «если … то» по значениям полей и результатам задач.
МультиусловиеВетвление сразу на несколько вариантов по набору правил.
Ожидание ответаЖдёт выполнения задачи менеджером или заполнения формы на сделке.
ОжиданиеПауза на время или до наступления условия/события.
Вебхук / запросОтправляет событие или HTTP-запрос во внешний сервис и обрабатывает ответ.
ОтветственныйНазначает или меняет ответственного за сделку.
ПисьмоОтправляет уведомление по почте по правилам аккаунта.
УведомлениеИнформирует выбранных сотрудников о событии сделки.
Под-процессЗапускает отдельный размеченный маршрут внутри общего сценария.
ТегиДобавляет или снимает теги со сделки и контакта.
Автоответ чатаЗапускает диалог-автоответчика при событии в воронке.
ПримечаниеДобавляет пояснение-комментарий к сделке при прохождении шага.
Перенос процессов

Импорт из другого редактора бизнес-процессов

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

📥

Формат импорта и что переносится

Процесс экспортируется из текущего редактора в JSON и импортируется в Вектор. На холст восстанавливаются шаги и связи в том виде, как они были размещены. Настройки, привязанные к конкретному аккаунту amoCRM (воронки, статусы, поля, пользователи), остаются пустыми до вашей привязки.

Так же переносится и готовый файл из каталога схем ("главная" → «Схемы»): вы выбираете статусы и поля из своего аккаунта.

🧩Восстановление шагов и связей

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

🛠️Подсветка недостроенных шагов

Шаги, которым нужна привязка к вашему аккаунту, подсвечиваются. По ним удобно пройтись по очереди и ничего не пропустить.

🧪Валидация перед запуском

Проверка находит отсутствие старта, «повисшие» ветки и незаполненные обязательные настройки — проблема видна до того, как процесс уйдёт в работу.

Мониторинг исполнителя и клиента

История исполнения процесса

Разбор «почему сделка встала» — по шагам, а не по памяти менеджера. Каждый запуск по сделке сохраняет хронологию прохождения маршрута.

🧭Трассировка по шагам

Видно, какие шаги выполнены на сделке, а какой шаг ждёт задачу, ответ или наступление условия. Легко понять текущее состояние процесса.

🔍Поиск причин остановки

Для застрявшей сделки сразу виден шаг, на котором процесс остановился. Это сокращает разбор «почему клиент не получил ответ» до минут.

⚠️Мониторинг ошибок

При сбое шага (временная ошибка API, некорректное значение поля) фиксируется причина и выполняется повторная попытка по правилам процесса. Отчёт подскажет, что донастроить.

Соединение с окружением компании

Интеграции и webhook’и

Вектор соединяет amoCRM с CRM-партнёрами, телефонией, чатами и сервисами, которые уже использует компания. Формулировки даны без громоздких номеров версий API — подключение описывается по сути.

🌐

Официальное подключение к amoCRM

Вектор работает как приложение amoCRM с краткоживущими ключами доступа. Это значит: нет хранения паролей, подключение отзывается из аккаунта в любой момент, а сам процесс видит только разрешённые ему справочники. Пока amoCRM развивает свой API — Вектор поддерживает актуальные каналы, и схемы не ломаются при обновлениях.

🔗Webhook’и наружу

Процесс может отправлять события в свои сервисы и ERP — статусы, данные сделки, уведомления. Ответ вебхука можно обработать и развить маршрут по нему.

📞События телефонии и ботов

Звонки, заявки из форм и чат-ботов запускают шаги процесса автоматически — новый лид сразу получает звонок по расписанию маршрута.

🧩Под-процессы и вложенные маршруты

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

🗄️

Нагрузка и надёжность

Шаги выполняются в порядке очереди с учётом лимитов amoCRM: при высокой частоте событий процесс ставит действия в очередь и повторяет временные сбои, не теряя сделки и не «сжигая» квоту аккаунта.

FAQ интегратора

Технические вопросы настройки

Ответы для тех, кто подключает и сопровождает Вектор у клиента. Остальные вопросы — на главной или по контактам.

Файл в формате JSON: восстанавливаются шаги и связи. Шаги, привязанные к воронкам/полям конкретного аккаунта, после импорта подсвечиваются для донастройки. Валидатор подскажет, чего не хватает перед публикацией.
Да, общие лимиты API amoCRM действуют. Вектор соблюдает их: при пике события выполняются в очереди, при временной ошибке делается повторная попытка. На стандартной работе отдела лимиты не являются узким местом.
Администратор ставит приложение. Дальше процесс работает от пользователя с правами только на нужные воронки, сделки и поля. Не выдавайте процессу доступ ко всему аккаунту — лучше настроить отдельного пользователя или сузить справочники.
Официальное подключение amoCRM с краткоживущими ключами — пароль пользователя не участвует. Ключи хранятся защищённо, в историю и клиенту не выводятся, подключение при необходимости отзывается из amoCRM.
Откройте «Историю исполнения» по конкретной сделке: вы увидите шаг, вызвавший проблему, и причину (значение поля, отсутствие статуса, ошибка вебхука). Исправьте настройку в редакторе и перезапустите шаг — по правилам процесса выполняется повторная попытка.

Некогда настраивать самим? Настроим под ключ

Соберём и запустим маршрут под вашу воронку: разберём текущие процессы, перенесём нужные, подключим интеграции и покажем, как сопровождать «Историю исполнения».