Чем собственная интеграция отличается от AI-агента Битрикс24

В Битрикс24 есть встроенный AI-агент для открытых линий. Он отвечает клиентам по базе знаний и может передать диалог оператору вместе с историей переписки.

В этом кейсе речь идёт не о настройке встроенного AI-агента, а о собственной интеграции. Она связывает Wazzup, собственный AI-шлюз, несколько порталов и линий, отдельные базы знаний и расписания, а также собственную логику остановки AI после ответа оператора.

Что умеет AI-консультант в открытых линиях Битрикс24

Открытые линии собирают обращения из подключённых каналов в одном интерфейсе. Менеджер видит переписку в Битрикс24 и продолжает разговор там же, где уже работает с клиентами.

В моём проекте нужно было сохранить этот привычный процесс и добавить AI как первую линию ответа. Клиент пишет в WhatsApp или Telegram. Сообщение попадает в Битрикс24 через Wazzup. AI получает вопрос, использует назначенную базу знаний и возвращает ответ в тот же диалог.

Перед системой стояли шесть задач:

1. Принимать только нужные сообщения из открытых линий.
2. Возвращать ответ AI в исходный чат.
3. Сохранять всю переписку для менеджера в Битрикс24.
4. Сразу останавливать AI после ответа оператора.
5. Учитывать график, часовой пояс и отдельную базу знаний каждой линии.
6. Управлять подключениями через веб-панель без ручного редактирования конфигурации.

Как работает AI-консультант в открытых линиях Битрикс24

Как сообщение проходит из WhatsApp и Telegram в Битрикс24

Рабочая цепочка выглядит так:

WhatsApp или Telegram → Wazzup → открытая линия Битрикс24 → `bitrix_bridge` → AI-шлюз → база знаний → ответ в тот же диалог.

Для подключения портала я настроил OAuth, регистрацию локального приложения, обработчики событий и работу с REST API открытых линий Битрикс24. При получении события сервис проверяет портал, открытую линию, канал и тип сообщения. Только после этих проверок текст передаётся в AI-шлюз.

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

База знаний для AI-консультанта в открытых линиях

После проверки входящего события bitrix_bridge отправляет сообщение в единый AI-шлюз вместе с контекстом диалога и настройками линии. AI получает подходящие материалы из назначенной базы знаний и формирует ответ.

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

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

Как передать диалог от AI-консультанта оператору в Битрикс24

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

Как отличить ответ оператора от сообщения клиента

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

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

Как отключить AI-консультанта после ответа оператора

После обнаружения ответа оператора сервис включает human_lock для конкретного диалога. Состояние хранится в Redis. Пока блокировка активна, новые сообщения клиента остаются оператору и не передаются в AI.

Блокировка снимается после завершения сессии или начала нового диалога. На случай незавершённого события у неё есть аварийный срок действия.

Главное правило обработки получилось коротким:

человек важнее графика, график важнее AI.

Сервис сначала проверяет участие оператора. Затем смотрит расписание. Только после этого решает, можно ли отправлять сообщение AI.

Настройка AI-консультанта: базы знаний и расписание линий

Я вынес подключение и основные настройки в отдельную веб-панель. Через неё можно добавить несколько порталов, сохранить параметры локального приложения и получить ссылку для установки OAuth.

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

• включение или отключение AI;
• база знаний;
• рабочие часы;
• часовой пояс;
• режимы по дням недели;
• праздничные и разовые даты.

Настройки можно синхронизировать с Битрикс24 из той же панели. Поэтому для изменения графика или базы знаний не нужно открывать конфигурационные файлы на сервере.

Как избежать повторных ответов AI-бота в Битрикс24

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

В bitrix_bridge я добавил несколько уровней проверки:

• фильтрацию собственных сообщений AI;
• исключение системных событий;
• защиту от повторной обработки одного события;
• повторные попытки только при временных ошибках API;
• разделение настроек порталов, линий, диалогов и баз знаний.

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

Как проверить передачу диалога от AI-консультанта оператору

Рабочий сценарий я проверил отдельно для WhatsApp и Telegram:

1. Клиент пишет в мессенджере.
2. AI отвечает в открытой линии Битрикс24.
3. Оператор отправляет сообщение из Битрикс24 или с подключённого аккаунта.
4. Для диалога включается human_lock.
5. Клиент пишет снова, но AI уже молчит.
6. После завершения сессии блокировка снимается.

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

Результат интеграции AI-консультанта с Битрикс24

В результате собран рабочий контур со следующей логикой:

• сообщения WhatsApp и Telegram обрабатываются в интерфейсе Битрикс24;
• AI отвечает по назначенной базе знаний;
• после ответа оператора AI не вмешивается в текущую сессию;
• собственные, системные и повторные сообщения не запускают лишний ответ;
• для каждой линии отдельно задаются база знаний и расписание;
• порталы и линии настраиваются через одну веб-панель.

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

Что проверить перед внедрением AI-консультанта в CRM

До разработки я бы зафиксировал пять вещей:

1. Какие открытые линии и мессенджеры нужно подключить.
2. На какие вопросы AI имеет право отвечать.
3. Какая база знаний относится к каждой линии.
4. Когда диалог должен перейти оператору.
5. Как проверить сообщения клиента, ответы бота, действия сотрудника и завершение сессии.

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

Почему AI-консультант должен передавать диалог оператору

В этом проекте AI не заменяет менеджера. Он отвечает по базе знаний в разрешённое время и остаётся первой линией, пока человек не подключился к разговору.

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

Если вы хотите подключить AI-консультанта к открытым линиям, посмотрите, что входит в CRM-интеграцию RM Systems.