Skip to main content

提交企微连接器配置

千问办公企业旗舰版开发者文档:提交企微连接器配置。

认证方式见APP开发者文档 → 认证接入。
  • 模块:技能中心
  • 权限:按当前用户的资源范围校验,不要求管理员权限。
  • 接口:POST/api/openapi/app/v1/ai-assets/builtin-connectors/{key}/configuration

请求

key 仅允许 wecom。请求 JSON:{"bot_id":"your-bot-id","bot_secret":"your-secret"}。bot_id 长度 1–255,bot_secret 长度 1–4096;均必填,拒绝未知字段、重复字段、换行与空值。密钥只写 Nango,不写 SQL 回执或响应。configured 只证明保存,不验证第三方可达性。
请求头必填说明
If-Match是最近读取的 auth_revision,原样携带,不能为星号。
Idempotency-Key是8–128 字符稳定键;响应丢失时保持键与原请求重试。

行为与权限

服务端确定 org/user/qwenwork_web,固定内置身份不可由浏览器伪造。添加、配置、授权和启用检查 connector_publish / DISCOVER、INVOKE 与 connector_use / USE 当前权限。本人可清理已撤权登记,不能操作其他用户。OAuth 登录不授予资源权限。 登记使用 Web 独立状态,source_channel=builtin,不伪造市场条目,不产生市场下载统计。重复添加保留选择;首次添加默认关闭;完整卸载重装默认关闭。卸载撤销当前授权代际,异步清理 Nango;断开同时停用。授权/配置成功仍需启用;can_use 固定 false,沙箱执行另行接入。

响应

200 返回安全连接状态 ConnectionResponse,不含 Bot Secret 或第三方凭据。并发按当前状态版本与授权代际串行化;同键异请求返回 409,旧授权回调不能覆盖新尝试。

WebassetsConnectionResponse

字段类型必填说明
attempt_idstring否当前授权尝试 UUID,用于关联本次授权流程。
auth_revisionstring是授权状态版本;授权写操作按接口要求原样作为 If-Match 传入。
auth_typestring否连接器使用的授权方式,按实际响应返回。
can_authorizeboolean是当前用户是否可以发起授权。
can_useboolean是当前状态是否允许使用;不能仅凭 connected 判断可执行。
cleanup_pendingboolean是是否仍有后台凭据清理待完成。
connectedboolean是是否已建立连接/完成必要配置。
connection_idstring否授权连接标识,可能省略;不是用户身份。
operation_idstring否后台操作标识,用于后续查询操作结果。
operation_pendingboolean是是否仍有操作待完成,不能将 true 当作已完成。
operation_statusstring否查询到的操作状态,按实际响应返回。
state_availableboolean是服务端是否能够提供当前授权状态。
state_etagstring否安装/启停状态版本;与 auth_revision 不可互换。
unavailable_reasonstring否当前不可用原因;省略不代表所有执行条件均满足。
user_enabledboolean是用户是否选择启用该连接器;授权成功不自动等于启用。

错误

状态码说明
400参数、请求体或幂等键无效。
401 / 403身份或业务准入失败。
404内置项不支持 Web、无权限或本人安装不存在。
409操作冲突、托管项不能卸载或授权未完成。
412版本过期,重新查询后提交。
422JSON、请求体或查询参数校验失败。
428缺少 If-Match。
503IAM、数据库或 Nango 不可用;不降级放行。