Действие ИИ-агента — это собственный инструмент агента, который он вызывает прямо в диалоге, чтобы отправить заявку в вашу CRM или дёрнуть внешний API. Вы не пишете код: описываете словами, когда действие нужно вызвать («когда клиент оставил имя и телефон — отправь заявку»), и агент сам решает вызвать его в нужный момент. Так связка ии агент + заявка в CRM превращается в готовый сценарий: клиент общается в чате, а лид падает в Bitrix24, amoCRM, ваш бэкенд по вебхуку или во встроенную мини-CRM — автоматически.

В этом гайде разберём по шагам: где живёт блок «Действия», какие есть типы (пресеты), как описать триггер на естественном языке, как настроить маппинг полей и обязательно проверить всё кнопкой «Тест» до публикации. Плюс — безопасность (доступ к полям ответа, хранение ключей) и готовые сценарии.

Что такое Действия ИИ-агента

Обычный ИИ-агент умеет отвечать на вопросы. Действие даёт ему руки: возможность выполнить операцию во внешнем мире по ходу разговора. Технически каждое действие становится отдельным инструментом агента — он «видит» его как action_<название> и вызывает, когда диалог подходит под ваш триггер.

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

Какие типы действий доступны

При добавлении действия вы выбираете один из четырёх типов (пресетов):

  • Лид в Bitrix24 — агент создаёт лид в вашем портале Bitrix24 через «Входящий вебхук».
  • Лид в amoCRM — агент создаёт сделку с контактом в вашем аккаунте amoCRM одним вызовом.
  • HTTP-вебхук (в свою систему/CRM) — агент шлёт запрос на ваш URL с нужным телом и заголовками: для собственной CRM/ERP, тикет-системы, бэкенда бронирования.
  • Заявка в мини-CRM — встроенная база заявок платформы: без единой настройки агент сохраняет контакт и шлёт владельцу письмо о новом лиде.

Помимо этих настраиваемых действий у агента во внешних каналах «из коробки» уже есть submit_lead (сохранить контакт в мини-CRM) и request_human (позвать живого оператора — диалог помечается как передача человеку, владельцу уходит письмо).

Что нужно до старта

  • Тариф Pro и выше — действия доступны с Pro; гейт проверяется и при создании, и при каждом вызове агентом (даунгрейд отключит действия).
  • Сохранённый агент — сначала создайте и сохраните ИИ-агента, иначе блок «Действия» покажет подсказку вместо формы.
  • Доступ к вашей CRM — для Bitrix24 нужен «Входящий вебхук», для amoCRM — адрес портала и долгосрочный токен интеграции. Для мини-CRM не нужно ничего.

Как добавить Действие: пошагово

  1. Откройте агента → шаг «Настройки» → разверните блок «Действия» → «Добавить действие».
  2. Задайте Название латиницей (например send_to_crm) — из него получится имя инструмента action_send_to_crm.
  3. Выберите Тип действия: HTTP-вебхук / Лид в Bitrix24 / Лид в amoCRM / Заявка в мини-CRM.
  4. В поле «Когда агент должен вызывать действие» опишите триггер словами (минимум 8 символов): например «когда клиент назвал имя и телефон и согласен, чтобы с ним связались — отправь заявку».
  5. Настройте параметры под выбранный тип (URL и заголовки для вебхука, вставку вебхука для Bitrix24, портал+токен для amoCRM).
  6. Опишите параметры, которые агент собирает у клиента — обычно name, phone, email, comment (имя / тип / описание каждого поля).
  7. Нажмите «Создать», затем «Протестировать» с тестовыми аргументами — платформа сделает реальный вызов и покажет результат.
  8. Убедитесь, что заявка дошла, и включите тумблер действия — оно начнёт предлагаться агенту как инструмент в чатах и каналах.

Настройка пресета Bitrix24

Для интеграции ИИ-агента с Bitrix24 нужен «Входящий вебхук» из вашего портала:

  1. В Bitrix24 откройте раздел для разработчиков → «Входящий вебхук», выдайте право на CRM и скопируйте адрес вида https://ваш-портал.bitrix24.ru/rest/…/…/.
  2. В форме действия выберите тип «Лид в Bitrix24» и вставьте этот адрес.
  3. Опишите параметры, которые агент собирает: имя, телефон, email, комментарий.
  4. Сохраните и нажмите «Протестировать» — агент создаст лид в вашем портале.

Сам вебхук-токен хранится зашифрованным и наружу не отдаётся; в настройках виден только домен портала. Агент собирает имя/телефон/email/комментарий и заводит лид без участия менеджера.

Настройка пресета amoCRM

Чтобы агент создавал сделку с контактом в amoCRM, укажите адрес портала и долгосрочный токен:

  1. В amoCRM: «Настройки» → «Интеграции» → создайте приватную интеграцию → вкладка «Долгосрочный токен» → скопируйте токен.
  2. В форме действия выберите тип «Лид в amoCRM».
  3. Укажите адрес портала (mycompany.amocrm.ru или …kommo.com) и вставьте долгосрочный токен.
  4. Сохраните и нажмите «Протестировать» — агент создаст сделку с контактом одним вызовом, а комментарий добавит примечанием.

Настройка HTTP-вебхука в свою систему

Универсальный тип для случаев, когда заявки должны падать в собственную CRM/ERP, тикет-систему или любой ваш эндпоинт в нужном формате. Настраивается так:

  1. Укажите URL и метод (GET/POST/PUT/PATCH/DELETE).
  2. Добавьте заголовки — например Authorization со ссылкой на {{secret}}.
  3. Впишите Секрет (API-ключ) — он сохраняется write-only и зашифрованным, наружу не отдаётся.
  4. При желании задайте тело-шаблон в JSON с переменными {{параметр}} — платформа подставит собранные агентом значения с корректным экранированием.
  5. Выберите, что из ответа видит агент — только выбранные поля (по умолчанию) или весь ответ.

Маппинг полей и параметры, которые собирает агент

Параметры действия — это поля, которые агент вытягивает из диалога у клиента. Для каждого вы указываете имя, тип и описание, а платформа превращает это в схему аргументов инструмента. Типовой набор для заявки:

ПараметрТипЧто описывает агенту
nameстрокаИмя клиента
phoneстрокаТелефон для связи
emailстрокаEmail (если оставил)
commentстрокаСуть обращения, потребность, бюджет/сроки
Типовые параметры действия-заявки

В HTTP-вебхуке эти параметры подставляются в тело-шаблон через {{name}}, {{phone}} и т.д. В пресетах Bitrix24 и amoCRM маппинг в поля лида/сделки платформа делает сама.

Кнопка «Протестировать»: проверка до публикации

Всегда тестируйте действие до того, как включите тумблер. Кнопка «Протестировать» делает живой пробный вызов с sample-аргументами прямо из интерфейса — это реальный запрос в вашу CRM или на вебхук. Так вы убедитесь, что токен верный, поля мапятся правильно, а заявка действительно создаётся.

  1. Заполните тестовые аргументы (JSON) — например имя, телефон, email, комментарий.
  2. Нажмите «Протестировать» и посмотрите результат вызова.
  3. Проверьте в самой CRM, что лид/сделка появились.
  4. Если всё верно — нажмите «Готово» и включите тумблер действия.

Безопасность: доступ к полям и защита ключей

Действия спроектированы так, чтобы внешние вызовы не превратились в дыру. Ключевые механизмы:

МеханизмЧто делает
Хранение секретаAPI-ключи и токены хранятся write-only и зашифрованными; наружу отдаётся только флаг «ключ задан»
Доступ к ответу«limited» (по умолчанию) — агент видит только выбранные поля ответа; «full» — весь ответ, обрезанный по лимиту
GuardrailsТаймаут вызова 1–30 с (по умолчанию 15 с) и лимит размера ответа 1–512 КБ (по умолчанию 64 КБ)
Проверка URLАдрес вебхука валидируется при сохранении и при каждом вызове; переменные в домене запрещены, обращения во внутреннюю сеть блокируются
Тариф-гейтДействия работают только на Pro+; проверка при создании и при каждом исполнении
Защита при работе действий

На одного агента можно создать до 20 действий.

Сценарии применения

  • Агент-продавец на сайте или в Telegram квалифицирует клиента и сам заводит лид в Bitrix24 или amoCRM — без менеджера.
  • Заявки в собственную CRM/ERP через HTTP-вебхук в нужном вам формате полей.
  • Старт без интеграций: агент собирает контакт в мини-CRM и мгновенно шлёт владельцу письмо о новой заявке.
  • Эскалация на человека: request_human зовёт живого оператора, когда клиент недоволен или вопрос вне компетенции.
  • Внешний API в диалоге: проверка наличия товара, расчёт стоимости, статус заказа — агент использует ответ прямо в чате.
  • Запись на услугу / регистрация на вебинар: агент собирает данные и постит их в систему бронирования по вебхуку.
  • Двухсистемный сценарий: одновременно лид в amoCRM для продаж и вебхук в аналитику или склад.

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

Как настроить, чтобы ИИ-агент отправлял заявку в CRM?

Откройте агента → шаг «Настройки» → блок «Действия» → «Добавить действие». Выберите тип «Лид в Bitrix24» или «Лид в amoCRM», вставьте вебхук (Bitrix24) либо адрес портала и долгосрочный токен (amoCRM), опишите словами, когда вызывать действие, и укажите параметры (имя, телефон, email, комментарий). Нажмите «Протестировать», проверьте лид в CRM и включите тумблер.

Нужно ли программировать, чтобы подключить CRM к чат-боту?

Нет. Всё настраивается без кода: вы выбираете готовый пресет, вставляете вебхук или токен и описываете триггер на естественном языке. Код нужен только если вы принимаете заявки в собственную систему через HTTP-вебхук — но и там достаточно указать URL и, при желании, JSON-шаблон тела.

Что такое HTTP-вебхук в действиях агента?

Это универсальный тип действия: агент отправляет HTTP-запрос на ваш URL с выбранным методом, заголовками и телом-шаблоном в JSON. В шаблон подставляются собранные у клиента поля через {{параметр}}. Подходит для собственной CRM/ERP, тикет-системы, уведомления внутренней системы о горячем клиенте или вызова внешнего API.

Безопасно ли хранить API-ключ в действии?

Да. Секрет сохраняется write-only и в зашифрованном виде, наружу отдаётся только флаг «ключ задан». В вебхуке {{secret}} подставляется только в заголовки — не в URL и не в тело, чтобы ключ не попал в логи. Адрес вебхука проверяется при каждом вызове, а обращения во внутреннюю сеть блокируются.

Обязательно ли тестировать действие перед публикацией?

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

На каком тарифе работают Действия агента?

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

Чем действие отличается от коннектора к базе данных?

Действие — это отправка заявки или вызов API по триггеру («когда собрал контакт — отправь»). Коннектор к базе или вики (Notion, Airtable) даёт агенту постоянный CRUD-доступ читать и писать данные. Подробнее — в гайде про коннекторы к базам данных и вики.

Что почитать дальше

Заявки, которые агент собирает во внешних каналах, удобно вести во встроенной мини-CRM — как это устроено, разбираем в гайде Мини-CRM ИИ-агента: заявки и аналитика. А если нужен не разовый лид, а постоянный доступ агента к вашим таблицам и базе знаний — смотрите ИИ-агент и Notion, Airtable, базы данных.