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. 检查反应和标签。如果迁移了文件,再检查媒体库。

下一步