בסיס הידע של 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 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 של הסשן לא יוצא מהדפדפן. ההרחבה יוצרת את אותו ארכיון ZIP לייבוא ב-GetMyBot.

סדר ההעברה

  1. ייצאו את הבוט במייצא או בהרחבה, ותקבלו mybot-export.zip (ובמקרה הצורך גם mybot-dialogs.zip).
  2. ייבאו את ארכיון התגובות לבוט (מצב "הוסף" או "החלף").
  3. במקרה הצורך ייבאו את היסטוריית הדיאלוגים.
  4. בדקו את התגובות והתגיות. אם העברתם קבצים, בדקו גם את ספריית המדיה.

המשך