АС Проект АС ПроектПлатиновый партнёр Битрикс24
+7 (495) 414-48-49
Искусственный интеллект

RAG-ассистент по звонкам на Битрикс24 Вайбкод

Опубликовано: ·10 мин чтения

Вайбкод открыл три API, которые позволяют собрать полноценного ИИ-ассистента по звонкам целиком внутри российского контура Битрикс24 - без сторонних сервисов и без передачи данных за рубеж: готовые расшифровки, векторные эмбеддинги и База знаний 2.0.

Зачем это нужно и в чём идея

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

Вайбкод решает всё это одной связкой трёх API, которые появились в платформе к июлю 2026 года (платформа находится в активной бете):

  1. Расшифровки звонков - готовый текст прямо из Битрикс24, без повторной транскрибации.
  2. Эмбеддинги bitrix/embeddings - векторизация расшифровок для семантического поиска.
  3. База знаний 2.0 - хранение векторизованных фрагментов и поиск по ним.

Результат - ассистент, который отвечает на вопросы строго по реальным звонкам, а не генерирует вымышленные ответы. Это и есть RAG (поиск с дополнением генерации): модель получает только найденные куски расшифровок и строит ответ по ним.

Все три API работают внутри контура Битрикс24. Данные не покидают инфраструктуру портала - критично для компаний, работающих в рамках 152-ФЗ. Подробнее о хранении данных читайте в статье где ИИ Битрикс24 обрабатывает данные.


Три API: что за что отвечает

Как данные проходят путь от записи звонка до ответа ассистента. Телефония создаёт активность в CRM, Вайбкод забирает готовую расшифровку, векторизует её и кладёт в Базу знаний; при запросе пользователя ассистент ищет релевантные фрагменты и формирует ответ через BitrixGPT.

flowchart TD
    PHONE[Телефония / CRM] -->|активность| TRANSCRIPT["GET /v1/activities/:id/transcript"]
    TRANSCRIPT -->|текст| EMBED["POST /v1/embeddings\n(bitrix/embeddings)"]
    EMBED -->|вектор + текст| KB["База знаний 2.0\n(POST /v1/note)"]
    KB -->|поиск| SEARCH["GET /v1/note/documents/search"]
    SEARCH -->|релевантные куски| LLM["BitrixGPT\n(bitrix/bitrixgpt-5.5)"]
    LLM -->|ответ| USER[Менеджер / РОП]

Таблица трёх API

Эндпоинт Роль в ассистенте Право доступа Примечание
GET /v1/activities/:activityId/transcript Получить готовую расшифровку звонка из CRM crm Требует включённого BitrixGPT для звонков в настройках портала
POST /v1/embeddings Векторизовать текст (модель bitrix/embeddings) vibe:ai Бесплатная модель; формат запроса совместим с OpenAI
GET /v1/note/documents/search и POST /v1/note Хранить фрагменты расшифровок и искать по смыслу note База знаний 2.0; поиск полнотекстовый + API

Актуальные квоты и лимиты модели проверяйте в документации: vibecode.bitrix24.tech/docs


Шаг 1. Получение расшифровки звонка

Битрикс24 умеет расшифровывать звонки силами встроенного BitrixGPT - текст сохраняется как часть активности в CRM. Вайбкод даёт доступ к этому тексту напрямую через API:

GET /v1/activities/:activityId/transcript

Что нужно:

  • Право доступа crm в ключе приложения.
  • Включённая функция BitrixGPT для звонков на уровне настроек портала.
  • Идентификатор (activityId) активности-звонка - берётся из списка активностей CRM.

Что возвращает: готовый текст разговора, разбитый по ролям («Оператор» / «Клиент»). Повторно транскрибировать аудио не нужно - платформа уже сделала это за вас.

Если вам интересно, как AI Битрикс24 обрабатывает звонки штатными средствами BitrixGPT, - смотрите статью AI-анализ звонков в Битрикс24.


Шаг 2. Векторизация расшифровки

Чтобы искать по смыслу (а не просто по ключевому слову), расшифровку нужно превратить в вектор. Для этого используется модель bitrix/embeddings:

POST /v1/embeddings

Формат запроса - OpenAI-совместимый:

{
  "model": "bitrix/embeddings",
  "input": [
    "Оператор: Добрый день, как я могу помочь?",
    "Клиент: Меня интересует доставка в регионы..."
  ]
}

Массив строк в input → массив векторов в ответе за один запрос. Длинные расшифровки лучше разбивать на смысловые фрагменты (по 300-500 слов) перед отправкой - так семантический поиск будет точнее.

Ключевые параметры:

  • Нужно право доступа vibe:ai.
  • Модель бесплатная (входит в AI-квоту по тарифу; на момент публикации - в пределах квоты без списания с кошелька).
  • Подключается через тот же AI Router, что и остальные модели Вайбкод.

Шаг 3. Хранение и поиск в Базе знаний 2.0

База знаний 2.0 открыта для API с июля 2026 года. Через неё можно создавать документы, наполнять их содержимым и искать - прямо из кода приложения.

Создание документа с фрагментом расшифровки:

POST /v1/note

В тело документа кладём: идентификатор звонка, дату, менеджера, текст фрагмента и его вектор (или метаданные для связки с вектором).

Поиск по содержимому:

GET /v1/note/documents/search

При запросе пользователя - сначала векторизуем вопрос той же моделью bitrix/embeddings, затем ищем ближайшие по смыслу фрагменты в Базе знаний. Найденные куски передаём в контекст языковой модели.

Подробнее о возможностях Базы знаний 2.0 через API читайте в статье База знаний 2.0 через API в Битрикс24 Вайбкод, а об эмбеддингах и векторном поиске в целом - в RAG и векторный поиск на Битрикс24 Вайбкод.


Шаг 4. Генерация ответа через BitrixGPT

Когда релевантные фрагменты найдены, их передают в языковую модель вместе с вопросом пользователя. Рекомендуемая модель для ассистента - bitrix/bitrixgpt-5.5 или bitrix/bitrixgpt-5.5-agent (доступны по умолчанию в тарифах Коворк/Код).

Системный промпт для ассистента:

Ты - ассистент по анализу звонков. Отвечай ТОЛЬКО на основе предоставленных фрагментов расшифровок.
Если ответа в фрагментах нет - сообщи об этом прямо. Не выдумывай.
Фрагменты:
{{retrieved_chunks}}
Вопрос: {{user_question}}

Модель bitrix/agent/auto (авто-роутер) лучше не использовать для этого сценария - она может выбрать недоступную модель и вернуть ошибку 402. Зафиксируйте конкретную модель явно.


Три сценария использования ассистента

Авто-резюме разговора

После каждого звонка приложение автоматически:

  1. Забирает расшифровку через GET /v1/activities/:activityId/transcript.
  2. Передаёт текст в BitrixGPT с промптом: «Выдели ключевые договорённости, возражения клиента и следующий шаг».
  3. Сохраняет резюме в карточку сделки или задачу.

Менеджер видит краткое резюме сразу после звонка - без необходимости прослушивать запись.

Проверка по чек-листу качества

Ассистент проверяет каждый звонок по заданному набору критериев:

Критерий Что проверяем
Приветствие Назвал ли менеджер своё имя и компанию
Выявление потребности Задавались ли открытые вопросы
Презентация Было ли предложение под запрос клиента
Работа с возражением Фиксировались ли возражения и давались ли ответы
Следующий шаг Договорились ли о конкретном действии
Прощание Корректное завершение разговора

Результат проверки сохраняется в Базе знаний или карточке CRM; руководитель отдела продаж получает уведомление по звонкам ниже порогового балла.

RAG-поиск по истории звонков

Пользователь задаёт вопрос: «Что клиент говорил о сроках доставки в последних звонках?»

Ассистент:

  1. Векторизует вопрос.
  2. Ищет ближайшие по смыслу фрагменты в Базе знаний.
  3. Возвращает ответ со ссылками на конкретные звонки.

Ответ строго ограничен найденными расшифровками - модель не может «додумать» то, чего не было в разговорах.


Чек-лист сборки ассистента

Используйте этот список как план разработки перед стартом. Подробнее о том, как правильно оформить задачу на доработку, читайте в статье структура ТЗ на доработку Битрикс24.

  • Ключи API - создан ключ с правами доступа crm + vibe:ai + note
  • BitrixGPT для звонков - включён в настройках телефонии портала
  • Тест расшифровки - GET /v1/activities/:activityId/transcript возвращает текст
  • Тест эмбеддингов - POST /v1/embeddings с моделью bitrix/embeddings работает
  • База знаний создана - через POST /v1/note создан хотя бы один документ
  • Поиск работает - GET /v1/note/documents/search возвращает релевантные результаты
  • Промпт для резюме написан и протестирован на 5+ реальных расшифровках
  • Промпт для чек-листа написан, критерии согласованы с руководителем отдела продаж
  • Промпт для RAG - модель получает только найденные куски, не выдумывает
  • Модель зафиксирована - используется bitrix/bitrixgpt-5.5 или bitrix/bitrixgpt-5.5-agent, не auto
  • Обработка ошибок - если расшифровка не готова, приложение ждёт и повторяет запрос
  • Размер фрагментов - расшифровки разбиты на куски по 300-500 слов перед векторизацией
  • Деплой - приложение задеплоено в галактику (рекомендуемый способ деплоя на платформе)
  • Логирование - включены логи через GET /v1/infra/servers/:id/logs

Технические ограничения и нюансы

AI-квоты. Модели бесплатны в пределах квоты портала. Квота даётся на компанию и зависит от тарифа Битрикс24 и подписки, а у Коворк/Кода своя, отдельная шкала персональных подписок. Сверх квоты - списание с кошелька. Массовую переиндексацию архива выгоднее ставить на ночь или выходные: в выгодные часы квота расходуется вдвое медленнее. Точные значения квот и стоимость сверхлимитного использования - на момент публикации уточняйте в документации: vibecode.bitrix24.tech/docs/ai/embeddings.

Расшифровка только новых звонков. BitrixGPT для звонков обрабатывает записи, появившиеся после включения функции. Ретроспективная расшифровка старых записей через этот API недоступна.

Таймаут exec. При выполнении тяжёлых операций (массовая индексация расшифровок) учитывайте таймаут 500 секунд на операцию сервера. Для больших объёмов делайте пакетную обработку.

bitrix/bitrixgpt-5.5-thinking - «думающая» модель, которая могла бы улучшить качество проверки по чек-листу, - по умолчанию не включена для тарифов Коворк/Код. Требует отдельного включения на уровне аккаунта.

Командная разработка. Если над ассистентом работают несколько разработчиков - используйте git + worktree, иначе деплои будут перезаписывать друг друга.


Сравнение с внешними сервисами речевой аналитики

Параметр Вайбкод RAG-ассистент Внешние сервисы (Dialext, aiokk, WhisperAI и др.)
Хранение данных Внутри контура Битрикс24 На серверах стороннего сервиса
Стоимость транскрибации Входит в AI-квоту BitrixGPT Поминутная или по подписке
Гибкость логики Полная - любой промпт, любой чек-лист Ограничена настройками сервиса
Время внедрения Разработка: от нескольких дней Установка приложения: часы
RAG по истории Да - через Базу знаний 2.0 Зависит от сервиса
Интеграция с CRM Нативная через API Через коннектор/вебхук

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


Вывод

Связка трёх API Вайбкод - transcript + embeddings + note - закрывает основные задачи контроля качества и аналитики звонков без вывода данных за периметр Битрикс24. Это актуально для компаний, которым важно соответствие 152-ФЗ, а также для тех, кто хочет гибко настраивать логику оценки под свои скрипты продаж.

Платформа Вайбкод находится в активной бете (данные актуальны на июль 2026). API и квоты могут меняться - следите за обновлениями в документации: vibecode.bitrix24.tech/docs.

Команда АС Проект - Платиновый партнёр Битрикс24 - помогает спроектировать архитектуру ассистента, собрать приложение на Вайбкоде и встроить его в существующие процессы контроля качества и продаж.

Нужна помощь по вайбкод-приложению? АС Проект - платиновый партнёр Битрикс24: собираем приложения на Вайбкоде, проверяем чужие перед боевым запуском и берём на сопровождение. Состав работ и цены - на странице приложения на вайбкодинге.

Актуально на конец августа 2026

  • BitrixGPT 5.6 Agent 1M. Контекст вырос до 1 млн токенов (порядка тысячи страниц за один запрос), новые агенты создаются на этой модели по умолчанию, а долгие ответы почти исчезли.
  • Выгодные часы. Квота расходуется вдвое медленнее в будни с 23:00 до 04:00 и в выходные с 17:00 до 07:00 по Москве; полная цена остаётся только в будни с 09:00 до 17:00. Текущий множитель и время ближайшего дешёвого окна отдаёт метод /v1/off-peak.
  • Тарифы Коворк/Кода. Подписка персональная, на сотрудника: Free (5% от объёма Pro), Pro - 2 000 Ꝟ в месяц, Max - 10 000 Ꝟ (впятеро больше Pro), Ultra - 20 000 Ꝟ (вдесятеро больше Pro). AI-квота портала при этом даётся на компанию и зависит от тарифа Битрикс24.

Данные на 29 августа 2026 - платформа Вайбкод в активной бете, цифры (квоты, цены, версии) меняются. Сверяйтесь с документацией Вайбкода.

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

Нет. Эндпоинт GET /v1/activities/:activityId/transcript возвращает уже готовую расшифровку, которую Битрикс24 создал силами BitrixGPT. Важно, чтобы функция BitrixGPT для звонков была включена в настройках портала до записи звонка.

На момент публикации модель bitrix/embeddings бесплатна в пределах AI-квоты по тарифу Коворк/Код. Точные лимиты и стоимость сверхлимитного использования уточняйте в документации Вайбкода: vibecode.bitrix24.tech/docs/ai/embeddings - платформа находится в активной бете и параметры могут меняться.

Нет. Все три API (расшифровки, эмбеддинги, База знаний 2.0) работают внутри инфраструктуры Битрикс24. Данные не передаются сторонним сервисам, что важно для соответствия требованиям 152-ФЗ.

Рекомендуется bitrix/bitrixgpt-5.5 или bitrix/bitrixgpt-5.5-agent - они доступны по умолчанию в тарифах Коворк/Код. Избегайте bitrix/agent/auto: авто-роутер может выбрать недоступную модель и вернуть ошибку 402.

Через эндпоинт GET /v1/activities/:activityId/transcript доступны только звонки, расшифрованные после включения BitrixGPT для звонков на портале. Для старых записей потребуется отдельная транскрибация сторонними инструментами с последующей загрузкой текста в Базу знаний 2.0.

По опыту работы с RAG-системами оптимальный размер фрагмента - 300-500 слов с небольшим перекрытием (overlap) между соседними кусками. Это обеспечивает точность семантического поиска и не превышает ограничения на длину входных данных модели эмбеддингов.

У вас остались вопросы?

Оставьте заявку - мы свяжемся с вами и проконсультируем.

Читайте также

Искусственный интеллект
RAG простыми словами: как ИИ отвечает по вашим документам
Искусственный интеллект
RAG и векторный поиск на Битрикс24 Вайбкод: embeddings
Искусственный интеллект
Разбор звонков на Битрикс24 Вайбкод: как собрать своё приложение
Искусственный интеллект
Разработка ИИ-агента: этапы работы и что нужно от вас
×

Оставьте заявку

Эксперт АС Проект свяжется в течение 60 минут.