وارد کردن از SamBot

اگر از sambot.ru مهاجرت می‌کنید، GetMyBot می‌تواند بات شما را به طور کامل بپذیرد: واکنش‌ها، برچسب‌ها، رسانه‌ها و حتی تاریخچه مکاتبه با کاربران. انتقال از دو مرحله تشکیل شده است — صادر کردن داده‌ها از SamBot (با صادرکننده یا افزونه مرورگر) و وارد کردن آرشیو به‌دست‌آمده در GetMyBot.

چه چیزی منتقل می‌شود

  • واکنش‌ها — رفتار کامل بات.
  • برچسب‌ها — برچسب‌های مشترکان با رنگ‌ها.
  • رسانه‌ها — تصاویر و فایل‌هایی که واکنش‌ها به آن‌ها ارجاع می‌دهند.
  • تاریخچه مکالمات — مکاتبه بات با کاربران (در آرشیو جداگانه).

وارد کردن بسته واکنش‌ها

آرشیو واکنش‌ها (mybot-export.zip) در بات آپلود می‌شود: POST /api/bots/{id}/reactions/import. داخل آرشیو:

  • manifest.json — هدر: نسخه فرمت، منبع (sambot)، نام بات، تاریخ صادرسازی، شمارنده‌ها.
  • reactions.json — آرایه واکنش‌ها (اجباری).
  • labels.json — فهرست برچسب‌ها (اختیاری).
  • media/<sha256>.<ext> — فایل‌های رسانه (اختیاری).

دو حالت در دسترس است:

  • افزودن (append) — واکنش‌های آرشیو به واکنش‌های موجود اضافه می‌شوند.
  • جایگزینی (replace) — واکنش‌های فعلی بات حذف و سپس از آرشیو بارگذاری می‌شوند.

حجم کل باز شده بسته واکنش‌ها به ۶۴ مگابایت محدود است.

وارد کردن تاریخچه مکالمات

تاریخچه مکاتبه در آرشیو جداگانه‌ای منتقل می‌شود (mybot-dialogs.zip): POST /api/bots/{id}/dialogs/import. آرشیو شامل پروفایل‌های کاربران و پیام‌هایشان با پیوست‌ها است تا مکاتبه گذشته فوراً در بخش افراد قابل مشاهده باشد.

حجم کل باز شده آرشیو مکالمات به ۲۵۶ مگابایت محدود است.

صادرکننده (Python)

پکیج tools/sambot_export بات را از sambot.ru با کوکی سشن scrape می‌کند، رسانه‌ها را دانلود و همه چیز را در یک بسته zip فشرده می‌کند. اجرا از دایرکتوری tools/sambot_export: python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip.

  • به طور پیش‌فرض واکنش‌ها، برچسب‌ها و رسانه‌ها صادر می‌شوند.
  • حالت --mode dialogs تاریخچه مکالمات را در mybot-dialogs.zip جداگانه صادر می‌کند.
  • احراز هویت — فقط با کوکی سشن لاگین‌شده (فرم ورود با توکن ضد-ربات محافظت می‌شود، رمز عبور کار نمی‌کند). کوکی از مرورگر گرفته می‌شود.

افزونه Chrome

اگر خط فرمان نامناسب است، یک افزونه Chrome (MV3) به نام «GetMyBot — صادرسازی از SamBot» وجود دارد. این افزونه بات را مستقیماً از مرورگر در صفحه sambot.ru صادر می‌کند: درخواست دسترسی به تب فعال و دانلودها می‌کند، با https://sambot.ru/* کار می‌کند، و کوکی سشن از مرورگر خارج نمی‌شود. خروجی همان بسته zip است که در GetMyBot وارد می‌شود.

ترتیب مهاجرت

  1. بات را با صادرکننده یا افزونه صادر کنید — mybot-export.zip (و در صورت نیاز mybot-dialogs.zip) دریافت خواهید کرد.
  2. بسته واکنش‌ها را در بات وارد کنید (حالت «افزودن» یا «جایگزینی»).
  3. در صورت نیاز تاریخچه مکالمات را وارد کنید.
  4. واکنش‌ها و برچسب‌ها را بررسی کنید، در صورت نیاز — کتابخانه رسانه‌ای.

مرحله بعد