С июля 2026 года База знаний Битрикс24 открыта для программного доступа: через право доступа note и эндпоинт GET /v1/note/documents/search можно искать, создавать и наполнять статьи прямо из кода. Это открывает путь к ботам поддержки, которые отвечают цитатами из ваших регламентов, и к приложениям адаптации, которые сами наполняют базу отдела.
Что стало возможным:
Всё это делается через единое право доступа note платформы Вайбкод. Документация доступна по адресу https://vibecode.bitrix24.tech/docs/note - актуальные квоты и точный формат запросов сверяйте там, так как платформа находится в активной бете и параметры меняются.
Важно. Все числовые лимиты (размеры квот, допустимые объёмы документов) в этой статье не приводятся намеренно: платформа в активной бете, цифры калибруются. Сверяйтесь с https://vibecode.bitrix24.tech/docs на момент внедрения.
notenote - право доступа ключа Вайбкод (в документации платформы оно называется scope), которое открывает доступ к объектам Базы знаний портала. Без него запросы к /v1/note/* вернут ошибку авторизации.
При создании ключа в настройках Вайбкод необходимо явно включить note в список разрешённых прав. Проверить текущие права ключа можно запросом:
GET /v1/me
X-Api-Key: <ваш_ключ>
Ответ содержит перечень доступных прав и методов API.
Основной эндпоинт для работы с содержимым:
GET /v1/note/documents/search
X-Api-Key: <ваш_ключ>
Запрос возвращает документы базы знаний, соответствующие поисковому критерию. Бот поддержки использует именно этот эндпоинт: принимает вопрос пользователя, передаёт его как поисковый запрос, получает релевантные фрагменты регламентов и формирует ответ.
Стандартная авторизация Вайбкод - заголовок X-Api-Key: <ключ> (альтернатива: Authorization: Bearer <ключ>). Те же правила, что и для остальных Vibe API эндпоинтов. Подробнее о модели ключей - в документации по адресу https://vibecode.bitrix24.tech/docs/keys-auth.
Основные потоки данных для четырёх сценариев использования API Базы знаний. Внешние системы и боты взаимодействуют с Vibe API, который по праву доступа note читает и записывает документы в Базу знаний Битрикс24; параллельно эмбеддинги позволяют организовать семантический поиск.
flowchart TD
USER[Пользователь] -->|вопрос| BOT[Бот поддержки]
BOT -->|поиск документов| VIBE[Vibe API]
ONBOARD[Приложение онбординга] -->|создать документ| VIBE
WIKI[Внешняя вики] -->|синхронизация| VIBE
VIBE -->|право note| KB[База знаний Б24]
VIBE -->|выгрузка Markdown| BACKUP[Бэкап]
VIBE -->|эмбеддинги| EMB["bitrix/embeddings"]
EMB -->|семантический поиск| BOT
| № | Сценарий | Что делает приложение | Направление операции |
|---|---|---|---|
| 1 | Бот поддержки по регламентам | Принимает вопрос → ищет в базе знаний → отвечает цитатой | Чтение (search) |
| 2 | Приложение адаптации новых сотрудников | При найме сотрудника само наполняет его отдел нужными документами | Запись (create/update) |
| 3 | Синхронизация с внешней вики | Периодически сверяет содержимое внешнего источника с базой знаний Б24 | Чтение + запись |
| 4 | Резервное копирование в Markdown | Экспортирует все документы базы знаний в файлы для архива | Чтение + выгрузка |
Это наиболее востребованный сценарий для команд технической поддержки и хелпдеска. Логика работы:
GET /v1/note/documents/search.bitrix/bitrixgpt-5.5) вместе с вопросом и получает сформулированный ответ.Такая архитектура относится к паттерну RAG (retrieval-augmented generation): модель не выдумывает ответ, а опирается на найденные куски реальных документов. Для повышения точности поиска можно дополнительно использовать векторные эмбеддинги - модель bitrix/embeddings через POST /v1/embeddings (право доступа vibe:ai, бесплатная, OpenAI-совместимая).
Пример минимального запроса поиска:
GET /v1/note/documents/search?query=порядок+возврата+товара
X-Api-Key: <ваш_ключ>
Полный список параметров (фильтры по базе, типу документа, дате) - в документации https://vibecode.bitrix24.tech/docs/note.
При адаптации новых сотрудников типичная задача - собрать нужные регламенты для конкретной роли и отдела. Без автоматизации это ручная работа HR или тимлида.
Приложение на Вайбкоде может:
Такое приложение хорошо сочетается с ботом Битрикс24 - бот приветствует нового сотрудника и сразу отвечает на первые вопросы, опираясь на автоматически созданный раздел базы.
Если в компании уже есть внешняя база знаний (Confluence, Notion, собственная система), а команда работает в Битрикс24, API позволяет организовать одностороннюю или двустороннюю синхронизацию:
Эту логику удобно реализовать как фоновый сервис на сервере Вайбкод (в Галактике - подробнее о деплое), запускаемый по расписанию.
Экспорт документов через API даёт возможность хранить актуальную версию базы знаний вне портала: в git-репозитории, на S3 или локальном хранилище.
Скрипт обхода:
GET /v1/note/documents/search (с пагинацией)..md-файл.В результате история изменений регламентов хранится в системе контроля версий - это удобно для аудита и восстановления после ошибочного удаления.
Полнотекстовый поиск хорошо работает для точных фраз, но плохо справляется с семантически близкими, но лексически разными вопросами. Решение - векторный поиск через bitrix/embeddings.
Архитектура RAG-ассистента:
POST /v1/embeddings и сохранить вектор в хранилище приложения (Вайбкод Storage /v1/storage/*).Модель bitrix/embeddings бесплатная, OpenAI-совместимая, требует право доступа vibe:ai. Документация: https://vibecode.bitrix24.tech/docs/ai/embeddings.
Работа через API не снимает ограничений самого портала Битрикс24 на количество баз знаний (на момент публикации):
| Тариф | Базы знаний компании | Настройка прав доступа |
|---|---|---|
| Бесплатный | 1 | Нет |
| Базовый | 3 | Нет |
| Стандартный | 5 | Да |
| Профессиональный | Без ограничений | Да |
| Энтерпрайз | Без ограничений | Да |
Базы знаний групп и проектов доступны начиная с тарифа Стандартный. Перед проектированием архитектуры приложения уточните тариф портала клиента - это влияет на количество доступных баз и возможность разграничения прав доступа.
Следующий порядок действий подходит для минимально жизнеспособного прототипа за одну сессию вайбкодинга:
note (и vibe:ai - если нужен RAG)GET /v1/me - убедиться, что note есть в списке правGET /v1/note/documents/search → вернуть фрагментыbitrix/bitrixgpt-5.5 или bitrix/bitrixgpt-5.5-agent) для формулировки ответа на основе найденных фрагментовPOST /v1/feedback и сообщи номер тикета»Пустой результат поиска. Если GET /v1/note/documents/search возвращает пустой массив при наличии документов - проверьте: (1) право доступа note активно для ключа; (2) документы опубликованы, а не в черновиках; (3) у пользователя/приложения есть права на чтение этой базы знаний (на тарифах Стандартный и выше права настраиваются).
Качество поиска. Полнотекстовый поиск чувствителен к морфологии. Если ответы нерелевантны - рассмотрите комбинацию с векторными эмбеддингами (см. выше).
Объём документов. При выгрузке большого числа документов используйте пагинацию и batch-подход, а не наивный цикл по всем записям - это рекомендованная практика для Vibe API в целом.
Актуальность данных. Бот отвечает по тому, что есть в базе знаний на момент запроса. Если регламенты обновляются редко - это приемлемо. Если часто - настройте уведомление боту или триггер на обновление эмбеддингов при изменении документов.
Командная разработка. При работе нескольких разработчиков над одним приложением - используйте git + worktree, иначе деплои будут перетирать друг друга.
API Базы знаний хорошо работает в связке с другими инструментами платформы:
API Базы знаний 2.0 - одно из прикладных обновлений Вайбкод, которое превращает статичный справочник в активный компонент автоматизации. Бот поддержки по регламентам, автонаполнение при адаптации, синхронизация с внешней вики, резервные копии в git - всё это реализуется в рамках одного права доступа и нескольких эндпоинтов.
Платформа находится в активной бете, поэтому перед стартом проекта сверяйтесь с актуальной документацией: https://vibecode.bitrix24.tech/docs/note.
Команда АС Проект - Платиновый партнёр Битрикс24 - помогает проектировать и запускать подобные решения: от выбора архитектуры до деплоя и поддержки.
/v1/off-peak.discover отдаёт 66 сущностей Битрикс24, всего в API более 1 600 методов. Отдельно работает бот-платформа.Данные на 29 августа 2026 - платформа Вайбкод в активной бете, цифры (квоты, цены, версии) меняются. Сверяйтесь с документацией Вайбкода.
Оставьте заявку - мы свяжемся с вами и проконсультируем.
Эксперт АС Проект свяжется в течение 60 минут.