الاستيراد من 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) باستخدام رمز وصول شخصي بنطاق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.
ترتيب الانتقال
- صدّر البوت بالمصدِّر أو بالإضافة لتحصل على
mybot-export.zip(وmybot-dialogs.zipعند الحاجة). - استورد أرشيف التفاعلات إلى البوت (وضع "إضافة" أو "استبدال").
- استورد سجل المحادثات عند الحاجة.
- راجع التفاعلات والتسميات. وإذا نقلت ملفات، فراجع مكتبة الوسائط.
الخطوات التالية
- التفاعلات: الأساسيات: استيراد التفاعلات الفردية وتصديرها.
- الأشخاص (CRM): حيث يظهر سجل المحادثات المستورد.
- مكتبة الوسائط: حيث تُحفظ الوسائط المنقولة.
- المشاريع والقنوات: اربط البوت قبل الاستيراد.