پایگاه دانش GetMyBot

درون‌ریزی از sambot

چگونه واکنش‌ها، برچسب‌ها، فایل‌ها و مکاتبات را از sambot منتقل کنیم. بایگانی‌ها چه چیزی دارند و حالت‌های افزودن و جایگزینی چه تفاوتی دارند.

در این صفحه

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

اگر از خط فرمان استفاده نمی‌کنید، افزونه Chrome را انتخاب کنید. برای خروجی‌گیری خودکار، یک صادرکننده Python هم وجود دارد. پس از انتقال، پیش از آنکه مشتریان را به بات بفرستید، فرمان‌ها، دکمه‌ها و فایل‌ها را در گفتگو با بات بررسی کنید.

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

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

درون‌ریزی بایگانی واکنش‌ها

نام بایگانی واکنش‌ها mybot-export.zip است. در بخش واکنش‌ها روی درون‌ریزی بایگانی بزنید، فایل و حالت بارگذاری را انتخاب کنید. در API از POST /api/bots/{id}/reactions/import استفاده می‌شود. در مستندات فنی به این بایگانی بسته (bundle) هم گفته می‌شود. محتویات آن:

  • 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. واکنش‌ها و برچسب‌ها را بررسی کنید. اگر فایل منتقل کرده‌اید، کتابخانه رسانه را هم بررسی کنید.

مرحله بعد