Интеграция ИИ-агента с Битрикс24: установка и настройка

Пошаговая инструкция по подключению ИИ-агента Agent Rails к вашему порталу Битрикс24. После настройки каждый новый диалог автоматически создаёт лид или сделку в нужной воронке, переписка зеркалируется в Открытые линии, а ответ менеджера из CRM уходит клиенту и останавливает ИИ.

Что делает интеграция

Создаёт лиды и сделки. Новый диалог из Telegram, ВКонтакте, Avito, Max или с сайта создаёт лид или сделку в выбранной воронке на стартовой стадии.

Зеркалирует переписку. Все сообщения клиента и ИИ отражаются в Открытых линиях Битрикс24 в привязанной карточке.

Заполняет поля. Данные, которые ИИ собирает в диалоге (имя, телефон, параметры заказа), записываются в стандартные и пользовательские поля карточки.

Двигает сделку по воронке. Выполнение заданной функции ИИ переводит сделку на соответствующую стадию.

Передаёт диалог менеджеру. Ответ менеджера из Битрикс24 или из кабинета Agent Rails уходит клиенту в его канал и переводит диалог в режим «ИИ остановлен».

Что нужно перед началом

Активный аккаунт Agent Rails — регистрация на agent-rails.ru. Приложение расширяет платформу Agent Rails и не работает автономно.

Портал Битрикс24 с доступными CRM и Открытыми линиями. Права администратора CRM для настройки.

Тариф Agent Rails с интеграцией Битрикс24 (тариф PRO). Работа ИИ тарифицируется по модели оплаты за сообщения.

Хотя бы один настроенный ИИ-агент с инструкцией (промптом); при необходимости — база знаний.

Установка и подключение

Установите приложение

Найдите Agent Rails в Маркете Битрикс24 и установите на свой портал. После установки откроется окно приложения с кодом подключения вида AR-XXXX-XXXX-XXXX.

Войдите в Agent Rails

Откройте личный кабинет на agent-rails.ru или зарегистрируйтесь, если аккаунта ещё нет.

Вставьте код подключения

В кабинете перейдите в раздел Интеграции → Битрикс24 и вставьте код из окна приложения. Портал Битрикс24 привяжется к вашему аккаунту — статус изменится на «Подключено».

Настройка интеграции

Все настройки выполняются в кабинете Agent Rails в разделе «Интеграции → Битрикс24». В самом Битрикс24 отдельная настройка не требуется.

Агент и сущность

Выберите ИИ-агента и тип сущности при новом диалоге — лид или сделка. Для сделки укажите воронку и стартовую стадию, для лида — начальный статус.

Каналы

Отметьте каналы, которые участвуют в интеграции (из подключённых у агента): Telegram, ВКонтакте, Avito, Max, сайт.

Стадии для ИИ

При необходимости ограничьте стадии воронки, на которых ИИ может работать. Пусто — ИИ работает на всех стадиях.

Функции → стадии

Задайте соответствия «функция ИИ → стадия сделки». Когда ИИ выполняет функцию, сделка автоматически переходит на указанную стадию.

Данные → поля

Настройте соответствия «собранные данные → поля Битрикс24» для стандартных и пользовательских полей карточки.

Включите интеграцию

Активируйте интеграцию. С этого момента новые диалоги создают лиды/сделки, зеркалируют переписку и заполняют поля.

Как это работает после запуска

Новый диалог. Клиент пишет в подключённый канал → создаётся лид или сделка в выбранной воронке и на стартовой стадии, открывается чат Открытой линии, сохраняется связка «диалог ↔ чат ↔ карточка».

Переписка. Сообщения клиента и ответы ИИ отражаются в карточке в Битрикс24.

Функции и поля. Выполнение функции двигает сделку по стадиям; собранные данные заполняют поля карточки.

Ответ менеджера. Менеджер отвечает из Битрикс24 (Открытая линия) — сообщение уходит клиенту в его канал, диалог переходит в режим «ИИ остановлен». Сообщения клиента продолжают зеркалироваться, пока ИИ на паузе.

Возобновление ИИ. Вернуть ИИ в работу можно в любой момент кнопкой «Возобновить ИИ» в кабинете Agent Rails.

Интеграция работает асинхронно и не влияет на стабильность ответов агента: при недоступности Битрикс24 задачи ставятся в очередь и досылаются позже.