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 MiB तक सीमित है।

डायलॉग इतिहास इम्पोर्ट

बातचीत का इतिहास अलग आर्काइव 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 MB तक के आकार में लेता है, और get_dialog_import स्टेटस लौटाता है।

इम्पोर्ट बैकग्राउंड में चलता है और किसी को कुछ नहीं भेजता। जिन संदेशों का tg_message_id पहले से लोड है, वे छोड़ दिए जाते हैं, इसलिए आर्काइव दोबारा या हिस्सों में अपलोड किया जा सकता है। डायलॉग इतिहास बिना समय-सीमा के रखा जाता है।

डायलॉग आर्काइव खोलने के बाद फ़ाइलों का कुल आकार 256 MiB तक सीमित है।

एक्सपोर्टर (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 ब्राउज़र से बाहर नहीं जाती। एक्सटेंशन GetMyBot में इम्पोर्ट के लिए वैसा ही ZIP आर्काइव बनाता है।

माइग्रेशन का क्रम

  1. बॉट को एक्सपोर्टर या एक्सटेंशन से एक्सपोर्ट करें: आपको mybot-export.zip (और ज़रूरत हो तो mybot-dialogs.zip) मिलेगा।
  2. रिएक्शन आर्काइव को बॉट में इम्पोर्ट करें ("जोड़ें" या "बदलें" मोड)।
  3. ज़रूरत हो तो डायलॉग इतिहास इम्पोर्ट करें।
  4. रिएक्शन और लेबल जाँचें। अगर फ़ाइलें लाई हैं, तो मीडिया लाइब्रेरी भी जाँचें।

आगे क्या