/api/capabilities 返回值为准。
部署与登录
在 Deployment 分类开通服务并选择实例时长套餐。部署后打开管理页，使用账号本人的企业微信扫码；如需手机确认或其他登录步骤，打开远程桌面并输入该实例的桌面密码。API 凭据与桌面密码独立。登录资料保存在实例磁盘中，重建容器保留磁盘；删除磁盘会删除本地会话。 每个实例独立收费，按已购买的时长运行。REST / MCP 调用不按消息另行收费，实际价格以套餐页面为准。当前默认参考微信机器人的时长套餐，最终开放前需结合运行资源完成定价确认。API 与 MCP
使用管理页中的实例 API 地址，所有账号接口携带Authorization: Bearer <实例 API token>。这些路径属于专属实例，不是共享 API 网关。MCP 地址为实例地址加 /mcp/，使用相同 Bearer token。
发送体包含
target、type: "text" 和 text。target 接受会话 ID、联系人 ID、企业用户 ID 或唯一的完整名称；优先使用 ID；显示名称仍不能唯一定位时，实例会拒绝操作，不会猜测对象。没有本地会话的联系人会先通过客户端打开会话，并核对实际会话 ID 后发送。请求头 Idempotency-Key 是 8–128 位字母、数字或 _.:-。同一操作重复请求必须复用相同键和相同请求体。
将 target 换为 targets 数组可串行发送给 1–50 个明确指定的目标。两者不能同时提供。全部目标先完成身份解析，指向同一对象的不同别名会被拒绝。某一目标失败后停止后续发送，任务结果逐项记录 succeeded、failed、unknown 或 not_attempted；不要把部分成功当成全部成功。此流程还需在部署环境完成指定联系人的真实验收。
任务可能处于 queued、running、submitting、succeeded、failed、unknown 或 cancelled。succeeded 表示提交后在对应会话记录中找到了准确文本及服务器消息 ID，delivered 仍为 null，不代表对方已收到。unknown 表示结果不明确，请检查历史记录，不要用新键重复发送。实例不会自动重发中断的任务。
历史仅包含客户端已经同步的内容，不能保证全部历史。非文本消息可能返回 unknown 类型，附件下载尚未开放。事件保留最近 10,000 条，gap 表示游标已超出保留窗口。首次连接不会把旧历史当作新消息重播。
消息历史中的 server_accepted 和 server_id 可用于核对服务器是否已接受本地消息；仅出现本地记录而没有服务器 ID 时，不能认定发送成功。这些字段不代表接收方已收到或阅读。事件记录保留生成时的状态，查询当前确认状态应使用消息历史接口。