Как настроить ИИ-агента в amoCRM через BPMN-конструктор "Процессы"

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

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

Chat AI — это одна из функций BPMN-виджета «Процессы».
Это сильно отличает его от подобных продуктов — это не просто умный чат-бот, а настоящий AI-агент, ему доступны сотни инструментов автоматизации, которые настраиваются без программирования.

Chat AI — это один из элементов BPMN-виджета «Процессы». Самая базовая настройка — это добавить его в процесс и запустить, после этого он начинает "слушать" входящие сообщения в amoCRM отвечать на них, согласно промпту. В элемент Chat AI можно добавить обработчики (функции), которые запускаются в тот момент, когда что то произошло в чате.
Например: клиент позвал менеджера → запустится функция и процесс пойдет по этой ветке → а на ветку добавляем, постановку задачи.

Работа с виджетами Команды F5

Испльзуйте решения от F5 для реализации задач любого уровная. Функционал BPMN-редактора расширяется виджетами, которые можно задейстовать для ИИ-агентов. Например:

• «Документы» - агент создаст договор, счет, билет и отправит его клиенту
• «КАССА» - агент создаст ссылку на оплату в ЮKassa и проконтролирует оплату
• «Уведомление в Телеграм - агент отправит сообщение в Телеграм, если клиент негативит
• «Интеграция с Google Sheets» - агент читает или записывает данные в таблицу
• «Почтовик» - агент отправит информацию на почту
• Отправить WEB hook - агент отправит API запрос или прочтет страницу на сайте
• Запустить SalesBot в amoCRM и т.д.

Подключение любых каналов источников лидов

Chat AI работает со всеми подключенными каналами в amoCRM, будь то чат на сайте, мессенеджер, соцсеть, Авито и т.д. Вы можете подключить источники лидогенарции через любое стороннее решение: Radist.Online, i2crm, Wazzup, Wahelp, WABABA, amoCRM...
Для более нативной работы с рекомендуем подключить виджет Chatter. В этом случае вы получите дополнительные преимущества:

• Сообщения от агента будут отображаться как от робота, а не от пользователя
• В Chatter можно добавить неограниченное кол-во каналов, например несколько Телеграм ботов и прикреплять к ним различных чат-ботов для решения задач в рамках одной воронки

1. Установите виджет Процессы в amoCRM по ссылке и сохраните настройки
2. Если вы не зарегистрированы на сайте F5AI.RU, зарегистрируйтесь и создайте ключ в разделе API ключи
3. Перейдите в настройки amoCRM → Левое меню "Процессы" → Вкладка API и вставьте ключ в блоке "Ключи F5AI" и сохраните.

Первичная настройка завершена
Сайт F5AI.RU — продукт Команды F5, предназначенный для интеграции ИИ-функционала в различные решения. Платформа поддерживает биллинг запросов и оплату токенов. Вы можете добавлять несколько ключей для контроля расходов разных агентов.

После регистрации вы получаете 500 руб. на баланс — этого достаточно для тестирования возможностей сервиса.

Перейдите во вкладку Процессы (настройки amoCRM → Процессы)

1. Нажмите кнопку "Новый процесс", задайте название, выберите сущность Сделка и сохраните
2. Добавьте новый элемент Chat AI
3. В настройках Chat AI выберите ключь F5AI из списка
4. Добавьте текст промпта (пример ниже)

5. Выберите модель нейросети, например gpt-4o-mini
6. Выберите температуру "1" и максимальную длину "512", подробнее об этих настройках ниже
7. Сохраните настройки Chat AI
8. Сохраните настройки процесса и опубликуйте его

Готово!
Вы только что создали работающего ИИ бота, он уже может отвечать клиентам во всех чатах.

Бот отвечает на входящие сообщения, если процесс с Chat AI запущен (активен) в сделке. Для теста вы можете вручную запустить процесс в сделке по кнопке, затем написать сообщение в мессенеджер, бот ответит вам приветственным сообщением.

Как стартовать процесс автоматически на все входящие сообщения?

1. Зайдите в настройки той воронки, где нужно общаться с клиентами через нейро-консультанта;
2. Добавьте новый триггер на том этапе, где требуется общение, например, на этапе "Новая заявка";
3. Найдите в списке виджетов "Процессы" и нажмите Добавить
4. В настройках триггера выберите условие "Выполнить: При создании беседы входящим сообщением в любом источнике"
5. Выберите пункт "Запустить" и выберите созданный вами процесс
6. Сохраните настройки воронки цифровой воронки

Готово!
Теперь Chat AI будет отвечать клиентам автоматически.

Промпт – это набор инструкций для работы нейросети.
В этом поле необходимо описать следующие вещи:

• Задать роль боту и какие задач он должен выполнять в переписке: квалифицировать, запрашивать контакты, консультировать по продукту и т.д.
• Добавить любую информацию, о которой должен знать чат-бот в этой конкретной задаче: о компании, о товарах и услугах, ценах, скидках и т.д
• Задать стиль общения, что должен говорить, и немаловажно, что не должен говорить;
• Через переменные можно обогатить промпт данными из amoCRM, тогда бот будет знать все о клиенте и отвечать более релевантно. Например: какой домик он бронировал, сколько будет гостей и т.д.

Полезные переменные для ИИ-агента:
— {{date.now}} - текущая дата и время, по умолчанию нейросеть не знает в каком времени существует
— {{client.name}} - чтобы обращался к клиенту по имени
— информация о клиенте, компании, сделки из кастомных полей
— текущий статус сделки, если необходимо, чтобы агент вел клиента по воронке, в этом случае необходимо описать действия агента на разных этапах.
— {{lead.dialogMessages}} - последние сообщения в диалоге с клиентом, если они были до запуска Chat AI, по умолчанию бот не знает о тех сообщениях, которые были до его запуска.
Полезная статья о том, как правильно писать промт есть здесь.

Следует учитывать, что чем больше промпт, тем больше тратится на каждый запрос в нейросеть. Рекомендуем добавлять в промпт не более 5-10 тыс. символов.
Не старайтесь решать сразу огромный пул задач, задав боту все возможные сценарии работы в одном промпте. Двигайтесь последовательно.

Модель — более высокая модель (на данный момент GPT 4.1 от Open AI) дает более качественные результаты.

Температура - при более высокой температуре ответы будут более творческими, при низкой более точными и “сухими”. Слишком высокие значения могут привести к несвязным ответам и галлюцинациям. Рекомендуем от 0.5 до 1, чтобы ответы были более сбалансированными.

Максимальная длина - ответ от GPT всегда будет обрезан на данное количество символов, даже если он будет неполным.

Менеджер перехватил общение - галочка добавляет новую ветку, которая запустится в тот момент, когда менеджер сам напишет сообщение из amoCRM. На эту ветку, например, можно добавить остановку процесса, чтобы Chat AI перестал отвечать.

Добавить интервал перед ответом
Функция добавляет задержку перед ответом клиенту. Если за это время клиент напишет несколько сообщений, бот объединит их и ответит на все одним сообщением. Это делает диалог более естественным, отражая человеческую манеру общения.

Ограничить историю сообщений - Если переписка затягивается и достигает сотен сообщений, это может привести к чрезмерной трате токенов, так как в каждом запросе к нейросети уходит вся история переписки. В какой то момент, история может попросту не влезть в контекстное окно и бот перестаент отвечать. Этого можно избежать, если ограничить максмальную длину цепочки сообщений. Chat AI будет удалять сообщения начиная с самых первых, это позволит не раздувать контекст, однако “долговременная память” нейросети будет сокращаться с каждым новым сообщением.

Повторить ответ от GPT, если клиент не ответил в течение
Если клиент не отвечает, бот продублирует свое сообщение один раз. Через системный промпт, можно прописать этот текст в точности как он уйдет клиенту или попросить генерировать его каждый раз с нуля, исходя из контекста.


Тестирование промпта

• Вы можете протестировать промпт, написав сообщение и получив ответ от бота, или нажмите на «Тестировать» прямо в настроойках Chat AI. Это поможет понять, насколько хорошо он выполняет поставленные задачи.
• Если ответы не соответствуют ожиданиям, промпт можно скорректировать: уточнить инструкции, добавить примеры диалогов, изменить стиль общения или дополнить информацию.
• Постоянное тестирование и доработка помогут добиться оптимального результата.

Название обработчика * – это произвольный текст "для себя", для понимания функции обработчика.

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

• “Клиент сообщил номер телефона”
• “Клиент позвал менеджера”
• “Разговор зашел в тупик”
• “Клиент выражает негатив”
• "Получены все данные для полной квалификации" - например, если в промпте было указано, что для полной квалификации обязательны: телефон, email, адрес

Обработчик может извлекать данные из диалога и передавать их по ветке, если в ней заданы переменные (не обязательны)

Название переменной * - обязательно поле для переменной на латинском. Релевантное название того, что будет храниться в этой переменной. ChatAI на основе ИИ сама понимает, какие данные положить в переменную, исходя из его названия. Например: phone_number, client_name, account_id и т.д.
Для корректной обработки задавайте переменным осмысленные имена латинскими словами:
не правильные переменные: imya, ulitsa, den_rojdeniya
правильные переменные: name, street_address, birthday_date

Тип переменной - не обязательное поле. Можно установить текст, число или флаг.

Флажок “Обязательная переменная” - Если переменную сделать обязательной, то обработчик запустится только в том случае, если переменная известна. Обязательными можно сделать несколько переменных и все они будут влиять на условие запуска.
Пример: для квалификации нам нужно узнать телефон и email. Мы добавляем обработчик “Получены контакты” с двумя этими переменными, и телефон сделаем обязательным. В ходе переписки клиент сообщает email, обработчик не запустится, так как еще нет телефона, бот продолжит общение и попросит телефон, если клиент напишет верифицируемый телефон обработчик запускается.

Другой клиент сначала сообщает телефон, но не говорит email, в этом случае обработчик запустится сразу, так как email мы не сделали обязательным.

Описание переменной - не обязательное поле, но очень функциональное. Понятное описание того, что и как будет храниться в переменной. В ней сразу можно прописать модификатор, даже своими словами! Например, если написать: “Дата встречи в формате ДД.ММ.ГГГГ”, Chat AI поймёт, что дату нужно отдать в формате “15.04.2024” и не важно, как именно ее озвучил клиент. Это важно, если данные необходимо записать в определенные поля с нужным типом или форматом.

При работе с датами важно сообщить боту текущую дату и время через промпт, чтобы Chat AI мог извлечь корректное значение для сообщений вроде "запишите на завтра в 9 утра"

Возможные значения - список значений, которые может содержать переменная. Важная настройка для списков. Например, наше списковое поле в amoCRM содержит значения: PHP, Python, LUA, JavaScript. Если записать этот список для переменной, то не важно как напишет клиент в диалоге: яваскрипт, javascript, JS. Chat AI поймёт, что имеется в виду, сопоставив его со своим списком, и вернёт именно “JavaScript”, это корректное значение уже можно записать в поле amoCRM.

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

Чтобы записать эту переменную в amoCRM, добавьте на выходную ветку из этого обработчика элемент "Изменить Сделку" и присвойте значение процессной переменной нужному полю.

Шаг 1. Создаем процесс "Квалификация" для сущности Сделка.

Шаг2. Добавляем в процесс элемент Chat AI. Пишем системный промт, не забываем основные правила написания хороших запросов - кратко и однозначно, например:

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

1. Приветствуй клиента и узнай, чем ты можешь помочь.
2. Если клиент интересуется оптовыми закупками, собери следующую информацию:

• Имя и контактный номер клиента.
• Тип продукции, которую он хочет закупать.
• Ожидаемые объемы закупок.
• Опыт работы с нашей продукцией (новый клиент или уже закупал).
• Особые требования к условиям оплаты и доставки.

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

Шаг 3. Заполним остальные поля: выбираем Модель gpt-4, остальные поля можем оставить по умолчанию.

Шаг 4. Так как нас интересует не только получение данных, но и их запись в amoCRM, добавляем обработчик “Сделали квалификацию”, в описании так и напишем “Получили все квалификационные данные”. Это описание коррелирует с нашим промптом, в котором мы задали задачу.

Здесь мы пишем, что получили исчерпывающие данные для квалификации: Имя и Номер телефона, Тип продукции, Объемы закупок и тд.

Шаг 5. Чтобы сохранить полученные данные, нужно использовать переменные. Chat AI сам умеет корректно извлекать нужные данные и даже модифицировать.

• Имя - укажем понятное для нейросети название переменной, например, "name" с типом текст.
• Номер телефона - здесь подойдет "phone_number" тоже с типом текст.
• Тип продукции - "product_type"
• Дата доставки -"date"

Шаг 6. Обязательным шагом является указание переменных, в которые будут записаны полученные значения.
Для этого следует создать соответствующие Локальные переменные. О переменным и работе с ними подробнее тут.

Для Даты Доставки оставляем тип "Текст". Эту дату нужно сохранить в поле с типом "Дата и время", а для этого в amoCRM мы должны передать фиксированный формат: 30.05.2024 14:50, поэтому в описании переменной так и напишем “Дата которую выбрал клиент в формате d.m.Y H:i”, выбираем локальную переменную и готово.

Теперь, если клиент скажет: "давайте завтра в 9 утра", ChatAI исходя из того, что ему сообщили текущую дату в промпте, извлечет корректную дату в формате 15.05.2025 9:00

Шаг 7. Добавим следующий шаг процесса - Изменить Контакт. Записываем всё полученные обязательные переменные, которые мы указали в Chat AI.
Запишем Имя, Номер телефона, или другие поля, если они были получены.

То есть присвоим полям в amoCRM значения процессных переменных {{bpmn.proc(name)}}, {{bpmn.proc(phone_number)}} и т.д.

Так же создадим задачу для связи с клиентом и уточнения данных о его заказе.

Сообщение от бота - отправляет клиенту конкретный текст без необходимости генерации ответа нейронкой, просто ваш заданный текст. Если нужно добавить текст в историю переписки, но не показывать его клиенту, используйте флажок "Не отправлять в чат клиенту". Это сообщение нейросеть будет "видеть" при последующей переписке.

Ответ обработчику - запущенный обработчик может принимать ответ. Текст ответа так же анализируется нейросетью и Chat AI самостоятельно делает выводы о том, что написать клиенту.
Пример:

• Есть обработчик, который запускается, когда клиент сообщил желемую дату записи
• На выход этой ветки мы добавляем элемент "Веб хук", делающий запрос по API во внешнюю систему
• После вебхука далее добавляем Chat AI toll и в него вставляем ответ из хука через переменную.
• Если система ответила TRUE, этот ответ вернется в обработчик, Chat AI поймет, что запись была успешна и сообщит об этом клиенту.
• Если система ответит FALSE, Chat AI сам предложит клиенту перезаписаться, при получении новой даты, снова запустится обработчик и API запрос с новой датой.

В ответе обработчику может содержаться текст, числа или даже JSON-массив. Chat AI самостоятельно обработает эти данные и примет решение о дальнейших действиях.

Если стоит галочка “Не отправлять ответ в чат клиенту”, Chat AI ничего не напишет клиенту, но данные, пришедшие в ответе, сохранятся в контекст диалога и могут быть использованы в дальнейшей переписке.

Функция ответа обработчику отвечает именно на тот обработчик, на ветке которого он добавлен.

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

Завершение Chat AI - Останавливает обработку входящих чатов и прекращает ответы нейросети клиенту.
Если эта галочка была использована совместно с функцией “Сообщение от бота”, то сообщение отправится и обработка завершается.
Если галочка была использована совместно с функцией “Ответ обработчику”, то ответ уйдет, Chat AI ответит клиенту, после этого обработка завершится.