ฐานความรู้ GetMyBot

นำเข้าจาก sambot

วิธีย้ายรีแอคชัน ป้ายกำกับ ไฟล์ และการสนทนาจาก sambot สิ่งที่อยู่ในไฟล์เก็บถาวร และความต่างระหว่างโหมดเพิ่มกับโหมดแทนที่

บนหน้านี้

หากต้องการย้ายจาก sambot.ru ให้ดาวน์โหลดข้อมูลของบอทเป็นไฟล์เก็บถาวรก่อน แล้วอัปโหลดไฟล์นั้นเข้า GetMyBot คุณย้ายรีแอคชัน ป้ายกำกับ รูปภาพ และไฟล์ได้ ส่วนประวัติการสนทนาต้องอัปโหลดด้วยไฟล์เก็บถาวรแยกต่างหาก

หากไม่ได้ใช้ command line ให้เลือก extension สำหรับ Chrome ถ้าต้องการส่งออกแบบอัตโนมัติ มีตัวส่งออกที่เขียนด้วย Python หลังย้ายเสร็จ ให้ทดสอบคำสั่ง ปุ่ม และไฟล์ในแชตกับบอทก่อนส่งลูกค้าไปใช้งาน

สิ่งที่ย้ายได้

  • รีแอคชัน: พฤติกรรมทั้งหมดของบอท
  • ป้ายกำกับ: tag ของผู้ติดตามพร้อมสี
  • สื่อ: รูปภาพและไฟล์ที่รีแอคชันอ้างถึง
  • ประวัติไดอะล็อก: การสนทนาระหว่างบอทกับผู้ใช้ (ไฟล์เก็บถาวรแยกต่างหาก)

การนำเข้าไฟล์เก็บถาวรรีแอคชัน

ไฟล์เก็บถาวรรีแอคชันชื่อ mybot-export.zip ในส่วน รีแอคชัน ให้กด นำเข้าไฟล์เก็บถาวร แล้วเลือกไฟล์และโหมดการอัปโหลด หากใช้ API ให้เรียก POST /api/bots/{id}/reactions/import ในเอกสารทางเทคนิคจะเรียกไฟล์เก็บถาวรนี้ว่า บันเดิล (bundle) ด้วย ข้างในมี:

  • manifest.json: ส่วนหัว ได้แก่ เวอร์ชันของรูปแบบ แหล่งที่มา (sambot) ชื่อบอท วันที่ส่งออก และตัวนับ
  • reactions.json: array ของรีแอคชัน (บังคับ)
  • labels.json: รายการป้ายกำกับ (ไม่บังคับ)
  • media/<sha256>.<ext>: ไฟล์สื่อ (ไม่บังคับ)

มีสองโหมดให้เลือก:

  • เพิ่ม (append): รีแอคชันจากไฟล์เก็บถาวรจะถูกเพิ่มต่อจากรีแอคชันที่มีอยู่
  • แทนที่ (replace): รีแอคชันปัจจุบันของบอทจะถูกลบ จากนั้นจึงโหลดรีแอคชันจากไฟล์เก็บถาวร

ขนาดรวมของไฟล์หลังแตกไฟล์เก็บถาวรรีแอคชันจำกัดไว้ที่ 64 MiB

การนำเข้าประวัติไดอะล็อก

ประวัติการสนทนาย้ายด้วยไฟล์เก็บถาวรแยกชื่อ mybot-dialogs.zip ข้างในมีโปรไฟล์ผู้ใช้และข้อความพร้อมไฟล์แนบ ดังนั้นหลังนำเข้า การสนทนาเก่าจะแสดงในส่วน ผู้ใช้ ทันที

อัปโหลดไฟล์เก็บถาวรได้ 3 วิธี:

  • ใช้ปุ่ม "นำเข้าประวัติ" ในส่วน ผู้ใช้ หากคุณมีสิทธิ์เข้าถึงไดอะล็อก
  • ผ่าน 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 ที่มีข้อมูลของ session เบราว์เซอร์ที่เปิดอยู่แล้ว คำสั่งสำหรับนักพัฒนา ให้รันจากไดเรกทอรี tools/sambot_export: python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip

  • ค่าเริ่มต้นจะส่งออก รีแอคชัน ป้ายกำกับ และสื่อ
  • โหมด --mode dialogs ส่งออก ประวัติไดอะล็อก ไปยังไฟล์ mybot-dialogs.zip แยกต่างหาก
  • การยืนยันตัวตน: ใช้ได้ เฉพาะ cookie ของ session เบราว์เซอร์ที่เปิดอยู่แล้ว รหัสผ่านใช้ไม่ได้ เพราะฟอร์มเข้าสู่ระบบมีการป้องกันคำขออัตโนมัติ

Extension สำหรับ Chrome

หากไม่อยากรันคำสั่ง ให้ใช้ extension ของ Chrome "GetMyBot: ส่งออกจาก sambot" ซึ่งส่งออกบอทได้โดยตรงจากหน้า sambot.ru โดยจะขอสิทธิ์เข้าถึงแท็บที่ใช้งานอยู่และการดาวน์โหลด ทำงานกับ https://sambot.ru/* และ cookie ของ session จะไม่ออกนอกเบราว์เซอร์ extension จะสร้างไฟล์เก็บถาวร ZIP แบบเดียวกันสำหรับนำเข้า GetMyBot

ขั้นตอนการย้าย

  1. ส่งออกบอทด้วยตัวส่งออกหรือ extension คุณจะได้ mybot-export.zip (และ mybot-dialogs.zip หากต้องการ)
  2. นำเข้าไฟล์เก็บถาวรรีแอคชันเข้าบอท (โหมด "เพิ่ม" หรือ "แทนที่")
  3. นำเข้าประวัติไดอะล็อกหากต้องการ
  4. ตรวจสอบรีแอคชันและป้ายกำกับ หากย้ายไฟล์มาด้วย ให้ตรวจสอบคลังสื่อด้วย

ขั้นตอนถัดไป