Внедрение и интеграции / Разбор архитектуры

ИИ-бот для amoCRM: как встроить ответы в сценарий Salesbot

Разберите роли Salesbot и внешнего ИИ в amoCRM: условия запуска, передача контекста, продолжение сценария и остановка автоматизации.

ЕСЛИ КОРОТКО

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

Состояния Salesbot и внешнего ИИОткрыть схему крупнее ↗

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

Разделите оркестрацию и формирование ответа

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

Документация amoCRM описывает API для запуска Salesbot по сущности, а также отдельный API-метод остановки. Успешное принятие задачи API ещё не подтверждает, что бот завершил сценарий или отправил клиенту сообщение. Планируйте проверку состояния сделки и фактической переписки. Смотрите текущие требования и параметры в документации API Salesbot amoCRM.

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

Опишите состояния до подключения модели

Набросайте конечный маршрут на карточке сделки: ожидание сообщения, сбор уточнений, вызов ИИ, проверка результата, продолжение Salesbot, передача менеджеру, завершение. Для каждого перехода запишите входное условие и систему, которая подтверждает результат.

Например, новый чат может запустить согласованную ветку. Если запрос типовой и ответ найден в проверенном контексте, интеграция возвращает его в чат, а Salesbot продолжает следующий шаг. Если данных нет, клиент просит человека или вопрос выходит за полномочия, сценарий передаёт разговор сотруднику и прекращает автоматические сообщения. Условный переход должен быть явным, чтобы ИИ и Salesbot не отвечали параллельно.

Уточните, что произойдёт при повторном событии, долгом ответе внешнего сервиса и ручном вмешательстве менеджера. Если сотрудник начал писать клиенту, автоматизация должна уступить управление по согласованному правилу. Не запускайте новый экземпляр бота только потому, что интеграция повторно получила уведомление.

Передавайте ограниченный контекст и ожидаемый результат

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

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

Дайте интеграции минимально необходимый доступ. Если сценарий должен отправить сообщение, проверьте фактический ответ API до подтверждения клиенту. Если он изменяет поля сделки, ограничьте перечень полей и запишите, когда изменение разрешено. Общие правила подтверждения действий и обработки повторов описаны в руководстве об интеграции с CRM.

Проверьте остановку и конфликт сценариев

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

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

Критерий приёмки — не просто успешный вызов API, а отсутствие конкурирующих сообщений, правильное продолжение по результату и предсказуемое поведение при сбое. Если организация использует несколько триггеров Digital Pipeline, протестируйте их вместе: действие одного сценария может повлиять на запуск другого.

Чек-лист архитектуры

  • Определён триггер, который запускает Salesbot.
  • Известно, каким компонентом вызывается внешний ИИ.
  • Контекст и допустимые поля ограничены задачей.
  • Формат ответа и условия продолжения сценария согласованы.
  • При пробеле данных или просьбе клиента включается передача менеджеру.
  • После передачи Salesbot прекращает конфликтующие сообщения.
  • Проверены повторный запуск, тайм-аут и поздний ответ сервиса.
  • Менеджер видит причину передачи и собранный контекст.

Ограничения и следующий шаг

Методы API, доступность обработчиков и права зависят от аккаунта, версии документации и подключённых компонентов. Документация описывает возможности amoCRM, но не подтверждает наличие готовой интеграции автора. Нужно отдельно согласовать архитектуру, безопасный обмен контекстом и тестирование на используемых в компании воронках.

Для обсуждения схемы подготовьте текущие триггеры Salesbot, пример диалога и перечень полей сделки, к которым нужен доступ. Затем можно определить объём работ и границы автоматизации на странице внедрения.

Частые вопросы

Может ли Salesbot сам отправлять ответы внешнего ИИ?

Это зависит от подключённой интеграции или компонента. Наличие Salesbot и API amoCRM само по себе не означает, что внешний ИИ уже подключён.

Зачем отдельно останавливать Salesbot при передаче менеджеру?

Чтобы автоматические сообщения не продолжали сценарий одновременно с сотрудником и не создавали у клиента противоречивые инструкции.

Обсудим внедрение

Расскажите о бизнесе и обращениях, которые хотите передать ИИ. Начнём с одного процесса.