Мигратор Базы знаний 2.0

Мигратор Базы знаний (KB Migrator) — это приложение для Битрикс24, которое автоматически переносит контент из внешних баз знаний в Базу знаний 2.0 Битрикс24. Дерево разделов, страницы и вложения переносятся в фоновом режиме, не требуя вашего постоянного присутствия.

• Сохранение структуры: Пространства, коллекции и папки источника становятся разделами, а документы — страницами, полностью сохраняя исходную иерархию.

• Фоновая миграция: После запуска процесса окно мастера можно закрыть — перенос продолжится на сервере и не прервется.

• Нативная поддержка Markdown: Текст загружается в формате Markdown, который База знаний 2.0 понимает нативно.

• Умная обработка контента: Изображения и файлы размером до 25 МБ переносятся как вложения. Страницы с текстом более 1 МиБ автоматически дробятся на подстраницы.

• Идемпотентность: При повторном запуске на ту же цель уже перенесенные страницы по умолчанию не дублируются. Также доступна опция перезаписи и обновления существующих страниц.

• Безопасность данных: Токены доступа хранятся только на сервере приложения в зашифрованном виде и никогда не передаются в браузер. Загружаемые архивы разбираются «на лету» и не сохраняются в сыром виде.

• Яндекс Вики: Перенос страниц и вложений через OAuth.

• Notion: Перенос страниц, подстраниц и баз данных через OAuth или токен интеграции.

• GitBook: Перенос организаций, пространств и страниц с вложениями через Personal Access Token.

• Yonote: Перенос коллекций и документов (поддерживается как облачная, так и self-hosted версии) через API-ключ.

• Архив (Markdown-zip): Универсальная загрузка экспортированной базы знаний из zip-архива без необходимости авторизации.

• Как подключить Яндекс Вики?
  

При подключении через OAuth обязательно укажите идентификатор вашей организации. Заполните поле X-Org-Id (для Яндекс 360) или X-Cloud-Org-Id (для Yandex Cloud) — без этого подключение будет отклонено сервисом.

• Может ли приложение обрабатывать большие вложения?
  

Да, изображения и поддерживаемые файлы размером до 25 МБ переносятся как вложения. Файлы большего размера или неподдерживаемых форматов по умолчанию пропускаются и отмечаются в итоговом отчете.

• Что делать, если миграция прервалась из-за истечения токена?
  

Если токен доступа к источнику истек или был отозван во время долгого переноса, процесс остановится. Вам достаточно авторизоваться в источнике заново и нажать кнопку «Повторить упавшие» — миграция возобновится с места остановки, не затрагивая уже перенесенный контент.

• Как перенести данные из сервиса, которого пока нет в списке?
  

Для этого отлично подойдет источник «Архив». Экспортируйте вашу базу знаний в формат Markdown, упакуйте файлы в zip-архив (размером до 100 МБ) и загрузите его в приложение.