GetMyBot 知识库

身份验证与令牌

创建个人令牌,为它选择一个工作区,并仅授予程序所需的操作权限。

本页内容

个人令牌让程序访问 GetMyBot,无须交出账号密码。文档也称它为 PAT(Personal Access Token)。例如,读取机器人列表需要 bots:read,创建反应需要 reactions:write。

创建时要选择一个工作区和所需权限范围(scopes)。令牌仅在所选工作区有效,也不会超过您的账号在其中的权限。首次请求见API 快速入门。

创建令牌

在账号的个人令牌页面创建。令牌只在创建时显示一次,请妥善保存。服务器只保存哈希,无法找回原值;丢失后应创建新令牌并删除旧令牌。个人令牌都以 mbp_ 开头。

传递令牌

每次请求均以 Bearer 方式放入 Authorization HTTP 请求头:

Authorization: Bearer <个人令牌>

把包含尖括号的 <个人令牌> 换成完整令牌,令牌本身已经包含 mbp_。MCP 只接受个人令牌,项目 API 令牌(mb_live_…)不能用于 MCP。网页登录也使用 Authorization 请求头,但那里传的是短期 JWT;集成应使用 mbp_… 令牌。

令牌所属的工作区

一个令牌只属于一个工作区。默认选择您自己的工作区;如果您获邀加入其他工作区,创建令牌时也可选它。API 用 POST /api/tokens 请求体中的 account_id 指定;网页端在有效期上方有工作区下拉框。GET /api/account/cabinets 列出可选工作区。

实际效果如下:

  • GET /api/bots 只返回所选工作区的机器人,不包含您自己或第三个工作区的机器人。
  • 请求其他工作区的机器人会得到 404,无法用令牌探测它是否存在。
  • 令牌不增加权限。可执行的操作取决于您在工作区的角色和对该机器人的权限。
  • 为其他工作区创建的令牌仍使用您在该工作区的权限。读取账单(/api/billing/*)需要工作区权限 billing.read,创建项目需要 bots.create。即使 scope 为 *,也不会得到这些工作区权限。
  • 工作区访问权被撤销后,令牌从下一次请求起立即失效,无需另行撤销。

只能通过单个机器人看到的工作区

GET /api/account/cabinets 中的 source 表示您如何取得访问权:

  • self:您自己的工作区;
  • account:您是该工作区成员,权限取决于角色;
  • bot:您仅获邀使用其中的某个机器人,没有整个工作区的权限。

对于 source: "bot",可在该机器人的授权范围内操作,但连接机器人、账单等工作区级操作会被拒绝。REST 返回 403 和 {"error":"missing cabinet right"};如果是成员但缺少特定权限,错误为 missing cabinet right: <权限>。MCP 返回 permission denied: missing cabinet right;例如 connect_bot 需要 bots.create,账单工具需要 billing.read 或 billing.write。

要取得工作区权限,请由所有者在工作区访问设置邀请您并授予相应权限。接受邀请后,已有令牌从下一次请求起即可使用,不必重新签发。此功能推出前创建的令牌始终绑定您自己的工作区;若要访问其他工作区内共享的机器人,请为那个工作区创建新令牌。

权限范围(scopes)

权限范围采用 资源:操作 格式,读取通常用 :read,修改用 :write:

权限范围允许的操作
bots:read, bots:write机器人、设置、同步与机器人令牌
reactions:read, reactions:write反应、导入、公式测试、关联与排序
labels:read, labels:write订阅者标签
collections:read, collections:write集合与记录
flows:read, flows:write对话流程
integrations:read, integrations:write集成、连接与凭据
media:write上传媒体库
templates:read, templates:write机器人模板
settings:read, settings:write设置
subscribers:read读取订阅者及对话历史
broadcasts:write群发及管理
stats:read统计与分析
billing:read读取余额与套餐

* 表示可访问公开接口中的全部操作,但仍须具备相应的工作区与机器人权限。

个人令牌能做什么

PAT 仅适用于机器人编辑器的公开接口。登录与注册、移动端接口、支付和充值、通知、审计日志、客服向聊天发消息、入站 Webhook、支付回调和 WebSocket 仅允许网页会话等对应的访问方式,不能凭 PAT 使用。向这些路径提交 mbp_ 令牌会得到 401 或 403。权限范围不足时也会得到 403,见API 错误。

AI 智能体功能的权限

  • managed_ai:invoke 和 managed_ai:usage:read:调用 Managed AI 并查看用量。
  • copilot:use:使用 Copilot 提案。诊断需 journey:read,修改流程图还需 journey:edit。
  • journey:read 和 journey:edit:分析流程与执行解释、Flow Intelligence、Explainable Replay。
  • Meta 连接管理使用集成和机器人权限,还会检查工作区及目标机器人的具体权限。

MCP 执行相同的权限检查;接入 MCP 不会让令牌获得其他工作区或机器人的权限。

接下来