Разработка бота для автоматического ответа на FAQ Битрикс24

Разработка бота для автоматического ответа на FAQ Битрикс24

Половина входящих обращений в чат поддержки — это одни и те же вопросы: «Как вернуть товар?», «Где мой заказ?», «Какие условия доставки?». Оператор тратит время на рутину, а бизнес теряет деньги на необработанных сложных запросах. Интернет-магазин с 500 заказами в день получал 200 обращений, из которых 80% были типовыми. После внедрения бота время ответа сократилось с 5 минут до мгновенного, а операторы сосредоточились на сложных кейсах. Экономия на поддержке составила 40% в первый месяц — без потери качества.

Мы разрабатываем бота, который автоматически отвечает на типовые вопросы и передаёт нестандартные живому оператору. Решение работает прямо в открытых линиях Битрикс24 — без сторонних сервисов. В основе — либо быстрый ключевой поиск, либо семантический RAG на эмбеддингах.

Как бот подключается к открытым линиям?

Открытые линии Битрикс24 — основная точка входа. Бот регистрируется как первый оператор линии. Когда клиент пишет в онлайн-чат, Telegram или VK, обращение попадает боту. Если бот отвечает — оператор не беспокоится. Если нет — передаёт человеку.

Регистрация бота в открытых линиях выполняется через REST API Битрикс24:

POST /rest/imopenlines.bot.register
{
  "CODE": "faq_bot",
  "EVENT_HANDLER": "https://your-server.com/openline/event",
  "OPENLINE": "Y"
}

— источник: документация REST API

Как бот определяет, что ответить? Два подхода к сопоставлению вопросов

Подход 1: Поиск по ключевым словам

Вопросы и ключевые слова хранятся в базе, бот ищет совпадения в тексте сообщения. Просто в реализации, понятно в обслуживании. Идеально для 50–200 типовых вопросов.

CREATE TABLE custom_faq_entries (
    id          SERIAL PRIMARY KEY,
    question    TEXT NOT NULL,
    answer      TEXT NOT NULL,
    keywords    TEXT NOT NULL,
    category    VARCHAR(100),
    hits        INT DEFAULT 0,
    is_active   TINYINT DEFAULT 1
);

function findFaqAnswer(string $userMessage): ?array {
    $words = array_filter(explode(' ', mb_strtolower($userMessage)));
    $results = [];

    $faqs = getFaqEntries();
    foreach ($faqs as $faq) {
        $keywords = explode(',', mb_strtolower($faq['keywords']));
        $score = 0;
        foreach ($keywords as $kw) {
            $kw = trim($kw);
            if ($kw && (mb_stripos($userMessage, $kw) !== false)) {
                $score += mb_strlen($kw);
            }
        }
        if ($score > 0) {
            $results[] = ['faq' => $faq, 'score' => $score];
        }
    }

    if (empty($results)) return null;
    usort($results, fn($a, $b) => $b['score'] <=> $a['score']);
    return $results[0]['faq'];
}

Подход 2: Векторный поиск (RAG)

Вопросы индексируются как эмбеддинги (OpenAI text-embedding-3-small, Yandex GPT Embeddings). При новом вопросе — поиск ближайших соседей в векторной БД (pgvector, Qdrant). Работает на семантически похожих формулировках без точного совпадения слов.

Выбор: для 50–200 FAQ хватает ключевых слов. Для большой базы знаний с вариативными формулировками — RAG. RAG лучше справляется с синонимами и опечатками, но требует настройки модели.

Примеры типовых вопросов и ответов бота

Реальные сценарии из практики интернет-магазина:

Бот успешно закрывает 60–70% обращений без участия оператора.

Требования к интеграции и предварительная настройка

Для успешного запуска FAQ-бота нужны:

• Доступ к REST API Битрикс24 — требуется Admin-аккаунт и генерация OAuth-токена.
• HTTPS-сервер для приёма вебхуков от открытых линий (очень важно, Б24 работает только по защищённому протоколу).
• Хранилище FAQ — SQL-база (PostgreSQL, MySQL) или CMS-специфичное (например, модуль в 1С-Битрикс).
• В случае RAG — подписка на OpenAI API, Yandex GPT Embeddings или локальная модель (например, nomic-embed-text).
• Система мониторинга — логирование ошибок обработки сообщений, отслеживание упущенных вопросов.

Обработка события в открытой линии

$event = json_decode(file_get_contents('php://input'), true);

if ($event['event'] === 'ONIMBOTMESSAGEADD') {
    $sessionId = $event['data']['PARAMS']['SESSION_ID'];
    $dialogId  = $event['data']['PARAMS']['DIALOG_ID'];
    $text      = $event['data']['PARAMS']['MESSAGE'];
    $chatId    = $event['data']['PARAMS']['CHAT_ID'];

    $faq = findFaqAnswer($text);

    if ($faq) {
        $b24->callMethod('imopenlines.session.message.send', [
            'SESSION_ID' => $sessionId,
            'MESSAGE'    => $faq['answer'],
        ]);
        incrementFaqHits($faq['id']);
        $b24->callMethod('imopenlines.session.close', ['SESSION_ID' => $sessionId]);
    } else {
        $b24->callMethod('imopenlines.session.transfer', [
            'SESSION_ID' => $sessionId,
            'QUEUE_ID'   => 1,
        ]);
        $b24->callMethod('imopenlines.session.message.send', [
            'SESSION_ID' => $sessionId,
            'MESSAGE'    => 'Соединяю с менеджером, пожалуйста, подождите...',
        ]);
    }
}

Логика эскалации и передачи оператору

Бот передаёт обращение оператору по нескольким критериям:

• Низкая уверенность — оценка совпадения < порога (например, <0.7 для RAG или <5 для ключевых слов).
• Явный запрос жалобы — если клиент использует слова "жалоба", "претензия", "не сработало".
• Комплексный вопрос — обращение содержит несколько тем одновременно.
• Личные данные — запрос о пароле, реквизитах банка (бот должен отказать и передать оператору).
• Timeout — если конверсация с клиентом длится > 3 оборотов, бот предлагает менеджера.

Уточняющие вопросы

Если совпадений несколько — бот показывает варианты:

if (count($topResults) > 1 && $topResults[0]['score'] < 10) {
    $options = array_slice($topResults, 0, 3);
    $message = "Уточните, пожалуйста, что вас интересует:\n";
    foreach ($options as $i => $r) {
        $message .= ($i + 1) . ". {$r['faq']['question']}\n";
    }
    $message .= "0. Другое (подключить менеджера)";
    $redis->set("faq_choice:{$sessionId}", json_encode($options), 300);
}

Административный интерфейс для управления базой FAQ

Контент-менеджер должен управлять FAQ без правки кода. Разрабатываем административный раздел в /bitrix/admin/ или как приложение в Б24:

• CRUD для вопросов и ответов.
• Категории (Доставка, Оплата, Возврат, Технические вопросы).
• Статистика: сколько раз вопрос был закрыт ботом (hits), сколько передано операторам.
• Просмотр сессий, где бот не нашёл ответ — это приоритет для пополнения базы.

Хотите сократить нагрузку на поддержку? Получите консультацию по вашему проекту — оценим архитектуру и предложим оптимальный подход.

Почему важна аналитика эффективности?

Аналитика показывает реальную отдачу от бота. Без неё невозможно понять, какие вопросы бот обрабатывает хорошо, а какие нужно дорабатывать.

Для оценки эффективности мы считаем процент автоматически закрытых сессий. Целевой показатель автозакрытия для зрелой базы FAQ — 60–70%. Наши клиенты достигают этого за 2–3 недели после запуска.

Мониторинг и постоянное улучшение бота

После запуска бот требует регулярного обслуживания:

• Еженедельный анализ пропущенных вопросов — просмотр сессий, которые были передачи оператору, выявление гэпов в базе FAQ.
• Обновление ключевых слов (при ключевом поиске) или переобучение эмбеддингов (при RAG) на основе новых вопросов.
• A/B-тестирование ответов — какие формулировки приводят к меньшему числу повторных вопросов от клиентов.
• Мониторинг времени отклика — анализ задержек при передаче сообщений и выявление bottleneck'ов.

Инструмент автоматически предлагает контент-менеджеру варианты для добавления в FAQ, если одно и то же нераспознанное слово повторяется более 10 раз в неделю.

Что входит в работу

• Регистрация и настройка бота в открытых линиях Битрикс24.
• Проектирование структуры базы FAQ (ключевые слова или эмбеддинги).
• Разработка логики: поиск ответа, передача оператору, уточняющие вопросы.
• Создание административного интерфейса для управления базой.
• Реализация аналитики и отчётов (автозакрытие, популярные вопросы).
• Наполнение базы типовыми вопросами (до 100 записей) и тестирование.
• Документация по эксплуатации и обучение контент-менеджера.

Сроки и опыт

Мы на рынке уже более 5 лет, разработали 50+ проектов на Битрикс24. Работаем с 1С-Битрикс и Битрикс24 с момента основания.

Итого: 1.5–2.5 недели без учёта наполнения базы. Наполнение — отдельная работа, зависит от объёма документации.

Закажите разработку сейчас

Оценим ваш проект за 1 день. Расскажите о ваших типовых вопросах — подберём оптимальный подход. Свяжитесь с нами через форму на сайте или напишите в Telegram. Получите консультацию прямо сейчас.