Baza wiedzy GetMyBot

Import z sambot

Jak przenieść reakcje, etykiety, pliki i korespondencję z sambot. Co zawierają archiwa i czym różnią się tryby dodawania i zastępowania.

Na tej stronie

Aby przenieść bota z sambot.ru, najpierw pobierz jego dane do archiwum, a potem wgraj je do GetMyBot. Możesz przenieść reakcje, etykiety, obrazy i pliki. Historię korespondencji wgrywa się osobnym archiwum.

Jeśli nie korzystasz z wiersza poleceń, wybierz rozszerzenie do Chrome. Do automatycznego eksportu służy eksporter w Pythonie. Po przeniesieniu sprawdź polecenia, przyciski i pliki w czacie z botem, zanim skierujesz do niego klientów.

Co jest przenoszone

  • Reakcje: pełne zachowanie bota.
  • Etykiety: tagi subskrybentów wraz z kolorami.
  • Media: obrazy i pliki, do których odwołują się reakcje.
  • Historia dialogów: korespondencja bota z użytkownikami (w osobnym archiwum).

Import archiwum reakcji

Archiwum reakcji nazywa się mybot-export.zip. W sekcji Reakcje kliknij Importuj archiwum, wybierz plik i tryb wgrywania. W API służy do tego POST /api/bots/{id}/reactions/import. W dokumentacji technicznej takie archiwum nazywa się także bundle. W środku znajdują się:

  • manifest.json: nagłówek z wersją formatu, źródłem (sambot), nazwą bota, datą eksportu i licznikami.
  • reactions.json: tablica reakcji (wymagana).
  • labels.json: lista etykiet (opcjonalna).
  • media/<sha256>.<ext>: pliki mediów (opcjonalne).

Dostępne są dwa tryby:

  • Dodaj (append): reakcje z archiwum są dodawane do bieżących.
  • Zastąp (replace): bieżące reakcje bota są usuwane, a potem wczytywane są reakcje z archiwum.

Łączny rozmiar plików po rozpakowaniu archiwum reakcji jest ograniczony do 64 MiB.

Import historii dialogów

Historię korespondencji przenosi się osobnym archiwum mybot-dialogs.zip. Zawiera ono profile użytkowników i ich wiadomości z załącznikami, więc po imporcie wcześniejsza korespondencja od razu jest widoczna w sekcji Ludzie.

Archiwum można wgrać na trzy sposoby:

  • przyciskiem „Import historii” w sekcji Ludzie, jeśli masz uprawnienie do dialogów;
  • przez API: POST /api/bots/{id}/dialogs/import (multipart, pole file) z osobistym tokenem o zakresie subscribers:write. Postęp importu pokazuje GET /api/bots/{id}/dialogs/import/{import_id};
  • przez MCP: narzędzie import_dialogs przyjmuje archiwum w base64 o rozmiarze do 48 MB, a status zwraca get_dialog_import.

Import działa w tle i nikomu niczego nie wysyła. Wiadomości z już wgranym tg_message_id są pomijane, więc archiwum można wgrać ponownie albo w częściach. Historia dialogów jest przechowywana bezterminowo.

Łączny rozmiar plików po rozpakowaniu archiwum dialogów jest ograniczony do 256 MiB.

Eksporter (Python)

Pakiet tools/sambot_export odczytuje strony Twojego bota w sambot.ru, pobiera pliki i tworzy archiwum ZIP. Do dostępu potrzebny jest plik cookie z danymi już otwartej sesji przeglądarki. Polecenie dla programisty, uruchamiane z katalogu tools/sambot_export: python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip.

  • Domyślnie eksportowane są reakcje, etykiety i media.
  • Tryb --mode dialogs eksportuje historię dialogów do osobnego pliku mybot-dialogs.zip.
  • Uwierzytelnianie: wyłącznie przez cookie już otwartej sesji przeglądarki. Hasło nie zadziała, ponieważ formularz logowania jest chroniony przed automatycznymi żądaniami.

Rozszerzenie do Chrome

Jeśli nie chcesz uruchamiać polecenia, użyj rozszerzenia Chrome „GetMyBot: eksport z sambot”. Eksportuje ono bota bezpośrednio ze strony sambot.ru: prosi o dostęp do aktywnej karty i pobranych plików, działa na https://sambot.ru/*, a cookie sesji nie opuszcza przeglądarki. Rozszerzenie tworzy takie samo archiwum ZIP do importu w GetMyBot.

Kolejność migracji

  1. Wyeksportuj bota eksporterem lub rozszerzeniem: otrzymasz mybot-export.zip (i w razie potrzeby mybot-dialogs.zip).
  2. Zaimportuj archiwum reakcji do bota (tryb „Dodaj” lub „Zastąp”).
  3. W razie potrzeby zaimportuj historię dialogów.
  4. Sprawdź reakcje i etykiety. Jeśli przenosiłeś pliki, sprawdź też bibliotekę mediów.

Co dalej