База знань 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. Перевірте реакції та мітки. Якщо переносили файли, перевірте медіабібліотеку.

Що далі