База знаний GetMyBot

Импорт из sambot

Как перенести реакции, метки, файлы и переписку из sambot. Что содержат архивы и чем отличаются режимы добавления и замены.

На этой странице

Для переноса из sambot.ru сначала скачайте данные бота в архив, затем загрузите его в GetMyBot. Можно перенести реакции, метки, изображения и файлы. История переписки загружается отдельным архивом.

Если не пользуетесь командной строкой, выберите расширение для Chrome. Для автоматической выгрузки есть Python-экспортёр. После переноса проверьте команды, кнопки и файлы в чате с ботом, прежде чем направлять к нему клиентов.

Что переносится

  • Реакции: полное поведение бота.
  • Метки: теги подписчиков с цветами.
  • Медиа: картинки и файлы, на которые ссылаются реакции.
  • История диалогов: переписка бота с пользователями (отдельным архивом).

Импорт архива реакций

Архив реакций называется mybot-export.zip. В разделе Реакции нажмите Импорт архива, выберите файл и режим загрузки. Для API используется POST /api/bots/{id}/reactions/import. В технической документации такой архив также называется бандлом. Внутри находятся:

  • manifest.json: заголовок: версия формата, источник (sambot), название бота, дата выгрузки, счётчики.
  • reactions.json: массив реакций (обязателен).
  • labels.json: список меток (необязателен).
  • media/<sha256>.<ext>: файлы медиа (необязательно).

Доступны два режима:

  • Добавить (append): реакции из архива добавляются к текущим.
  • Заменить (replace): текущие реакции бота удаляются, затем загружаются из архива.

Суммарный размер файлов после распаковки архива реакций ограничен 64 МиБ.

Импорт истории диалогов

История переписки переносится отдельным архивом mybot-dialogs.zip. В нём профили пользователей и их сообщения с вложениями, поэтому после импорта прошлая переписка сразу видна в разделе Люди.

Загрузить архив можно тремя способами:

  • кнопкой «Импорт истории» в разделе Люди, если у вас есть право на диалоги;
  • через API: POST /api/bots/{id}/dialogs/import (multipart, поле file) с персональным токеном со scope subscribers:write. Ход импорта показывает GET /api/bots/{id}/dialogs/import/{import_id};
  • через MCP: инструмент import_dialogs принимает архив в base64 размером до 48 МБ, статус возвращает get_dialog_import.

Импорт идёт в фоне и никому ничего не отправляет. Сообщения с уже загруженным tg_message_id пропускаются, так что архив можно загрузить повторно или по частям. История диалогов хранится бессрочно.

Суммарный размер файлов после распаковки архива диалогов ограничен 256 МиБ.

Экспортёр (Python)

Пакет tools/sambot_export читает страницы вашего бота на sambot.ru, скачивает файлы и собирает ZIP-архив. Для доступа нужен cookie-файл с данными уже открытой сессии браузера. Команда для разработчика, запускаемая из каталога tools/sambot_export: python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip.

  • По умолчанию выгружаются реакции, метки и медиа.
  • Режим --mode dialogs выгружает историю диалогов в отдельный mybot-dialogs.zip.
  • Авторизация: только по cookie уже открытой сессии браузера. Пароль не подойдёт, потому что форма входа защищена от автоматических запросов.

Расширение для Chrome

Если не хотите запускать команду, используйте расширение Chrome «GetMyBot: экспорт из sambot». Оно выгружает бота прямо со страницы sambot.ru: запрашивает доступ к активной вкладке и загрузкам, работает с https://sambot.ru/*, а cookie сессии не покидает браузер. Расширение создаёт такой же ZIP-архив для импорта в GetMyBot.

Порядок миграции

  1. Выгрузите бота экспортёром или расширением: получите mybot-export.zip (и при необходимости mybot-dialogs.zip).
  2. Импортируйте архив реакций в бота (режим «Добавить» или «Заменить»).
  3. При необходимости импортируйте историю диалогов.
  4. Проверьте реакции и метки. Если переносили файлы, проверьте медиабиблиотеку.

Что дальше