ИИ-агент в amoCRM своими руками: как создать помощника для сделок

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

API это способ программы читать и менять данные amoCRM по адресу вида https://поддомен.amocrm.ru/api/v4/. Вебхук работает в обратную сторону: amoCRM сама присылает событие на адрес вашего сервера.

Понадобятся права администратора аккаунта: только он создает интеграции. Еще нужен n8n на сервере с доменом, чтобы amoCRM могла достучаться до вебхука, и модель. Ollama запускает открытые моделимодель с открытыми весами Модель с открытыми весами (open-weights model) это нейросеть, файлы параметров которой можно скачать и запустить на своем оборудовании. Подробнее в словаре на вашем компьютере или сервере и распространяется по лицензии MIT.

Приватная интеграция это подключение, которое работает только в вашем аккаунте. Ей выдается токентокен Токен это кусочек текста: слово, часть слова или знак, с которыми работает языковая модель. Подробнее в словаре, ключ доступа к API.

1. Откройте раздел «амоМаркет» в своем аккаунте и нажмите «Создать интеграцию».

2. Укажите название и описание, выберите доступы, заполните «Ссылку для перенаправления» (Redirect URI) и загрузите логотип. Хук об отключении интеграции можно не указывать, это поле необязательное.

3. Сохраните интеграцию, в ее окне откройте вкладку «Ключи» и нажмите «Сгенерировать токен». Выберите дату окончания: срок от 1 дня до 5 лет.

4. Сразу скопируйте токен: он показывается один раз. Долгосрочный токен не требует обмена и обновления, а отозвать его можно кнопкой «Отозвать доступ» на вкладке «Выданные доступы».

Токен передается в каждом запросе заголовком Authorization со словом Bearer и самим токеном. Храните его в учетных данных n8n, а не в тексте сценария.

1. В n8n создайте сценарий с узлом «Webhook», в поле «HTTP Method» выберите POST. В поле «Respond» выберите «Immediately» (ответить сразу): amoCRM ждет ответа не дольше 2 секунд, а модель думает дольше.

2. Опубликуйте сценарий и скопируйте «Production URL» узла.

3. В amoCRM в разделе «амоМаркет» нажмите в правом верхнем углу «WEB HOOKS», вставьте адрес, отметьте событие добавления сделки и нажмите «Сохранить».

4. Создайте тестовую сделку и откройте вкладку «Executions» сценария в n8n. amoCRM присылает данные в формате x-www-form-urlencoded, среди них id новой сделки.

Если за 2 часа набралось больше 100 неуспешных ответов и последний тоже неуспешный, amoCRM отключит вебхук и уведомит администраторов. Включить его снова можно в настройках кнопкой «Включить».

1. После узла «Webhook» поставьте «AI Agent». В параметре «Prompt» выберите «Define below» (задать ниже) и подставьте в поле «Prompt (User Message)» данные сделки из вебхука.

2. В опциях узла добавьте «System Message» и опишите, как оценивать заявку и в каком виде писать вывод: три строки, без обещаний клиенту.

3. Подключите модель, например узел «Ollama Chat Modelчат-модель Чат-модель это языковая модель, дообученная вести диалог: она понимает роли собеседников, следует инструкциям и отвечает на реплики, а не просто продолжает текст. Подробнее в словаре» с открытой моделью на своем сервере. Документация n8n требует подключить к агенту и хотя бы один инструмент.

4. Добавьте узел «HTTP Request»: POST на https://поддомен.amocrm.ru/api/v4/leads/номер-сделки/notes с заголовком Authorization. В теле JSON передайте список из одного примечания: note_type со значением common и params с полем text, где ответ модели.

5. Создайте еще одну тестовую сделку и откройте ее карточку: в ней должно появиться текстовое примечание от интеграции.

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

В сделке лежат имя, телефон и переписка клиента, а это персональные данные. По 152-ФЗ их сбор и хранение ведутся в базах на территории России, а перед передачей за рубеж оператор с 1 марта 2023 года уведомляет Роскомнадзор.

Модель, которая читает сделки, держите на сервере в России. Как мы устраиваем хранение данных клиентов, описано на странице о безопасности данных.

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

Работать с вебхуками через API, а не через интерфейс, можно с тарифа «Расширенный» или «Профессиональный».

Отвечать клиентам в чатах amoCRM такой помощник не умеет. По документации API чатов интеграция работает как транспорт сообщений из сторонней чат-системы и видит только чаты, которые создала сама. Это отдельная разработка.

Агента, который отвечает в мессенджерах, заводит и двигает сделку по воронке и передает разговор менеджеру, мы подключаем под ключ: пилот за 14 дней от 150 000 ₽ с метрикой в договоре. Подробности на странице ИИ-агента для amoCRM.

n8n в этой сборке работает по лицензии Sustainable Use License (fair-code): у себя ставить и менять можно, перепродавать как облачный сервис нельзя. Похожую сборку в другой CRM мы разобрали отдельно, а как выбрать CRM под агента, писали в блоге.