Что агент делает в amoCRM
Своими руками в amoCRM собирается помощник менеджера. Он получает данные новой сделки, просит модель оценить заявку и оставляет в карточке примечание: что хочет клиент, чего не хватает для расчета, какой следующий шаг.
API это способ программы читать и менять данные amoCRM по адресу вида https://поддомен.amocrm.ru/api/v4/. Вебхук работает в обратную сторону: amoCRM сама присылает событие на адрес вашего сервера.
Понадобятся права администратора аккаунта: только он создает интеграции. Еще нужен n8n на сервере с доменом, чтобы amoCRM могла достучаться до вебхука, и модель. Ollama запускает открытые моделимодель с открытыми весами. Модель с открытыми весами (open-weights model) это нейросеть, файлы параметров которой можно скачать и запустить на своем оборудовании. на вашем компьютере или сервере и распространяется по лицензии MIT.
Шаг 1: приватная интеграция и токен
Приватная интеграция это подключение, которое работает только в вашем аккаунте. Ей выдается токентокен. Токен это кусочек текста: слово, часть слова или знак, с которыми работает языковая модель., ключ доступа к API.
1. Откройте раздел «амоМаркет» в своем аккаунте и нажмите «Создать интеграцию».
2. Укажите название и описание, выберите доступы, заполните «Ссылку для перенаправления» (Redirect URI) и загрузите логотип. Хук об отключении интеграции можно не указывать, это поле необязательное.
3. Сохраните интеграцию, в ее окне откройте вкладку «Ключи» и нажмите «Сгенерировать токен». Выберите дату окончания: срок от 1 дня до 5 лет.
4. Сразу скопируйте токен: он показывается один раз. Долгосрочный токен не требует обмена и обновления, а отозвать его можно кнопкой «Отозвать доступ» на вкладке «Выданные доступы».
Токен передается в каждом запросе заголовком Authorization со словом Bearer и самим токеном. Храните его в учетных данных n8n, а не в тексте сценария.
Шаг 2: вебхук о новой сделке
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 отключит вебхук и уведомит администраторов. Включить его снова можно в настройках кнопкой «Включить».
Шаг 3: модель пишет примечание
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 дней от 149 000 ₽ с метрикой в договоре. Подробности на странице ИИ-агентаИИ-агент. ИИ-агент это нейросеть, которая сама выполняет задачу по шагам: ищет данные и пользуется программами, а в конце проверяет результат. для amoCRM.
n8n в этой сборке работает по лицензии Sustainable Use License (fair-code): у себя ставить и менять можно, перепродавать как облачный сервис нельзя. Похожую сборку в другой CRM мы разобрали отдельно, а как выбрать CRM под агента, писали в блоге.