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:使用具有 subscribers:write scope 的個人權杖呼叫 POST /api/bots/{id}/dialogs/import(multipart,欄位 file)。匯入進度由 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,也就是瀏覽器中已開啟工作階段的 cookie。密碼無法使用,因為登入表單會阻擋自動化請求。

Chrome 擴充功能

如果不想執行指令,可以使用 Chrome 擴充功能 「GetMyBot:sambot 匯出工具」。它直接在 sambot.ru 頁面上匯出機器人:要求存取目前分頁和下載的權限,作用於 https://sambot.ru/*,而且工作階段 cookie 不會離開瀏覽器。擴充功能產生的 ZIP 封存檔與匯出工具相同,可匯入 GetMyBot。

移轉步驟

  1. 使用匯出工具或擴充功能匯出機器人,取得 mybot-export.zip(需要時還有 mybot-dialogs.zip)。
  2. 將反應封存檔匯入機器人(選擇「新增」或「取代」模式)。
  3. 需要時匯入對話歷史。
  4. 檢查反應和標籤。如果移轉了檔案,再檢查媒體庫。

後續步驟