从 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:writescope 的个人令牌调用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。
迁移步骤
- 用导出工具或扩展导出机器人,得到
mybot-export.zip(需要时还有mybot-dialogs.zip)。 - 将反应压缩包导入机器人(选择「追加」或「替换」模式)。
- 需要时导入对话历史。
- 检查反应和标签。如果迁移了文件,再检查媒体库。