腾讯会议企业用户账号验证

原创

千星织梦

发布于 2026-10-23 14:47:43

460

文章被收录于专栏：腾讯会议腾讯会议

适用范围：腾讯会议企业自建应用的服务端 REST API，使用 AK/SK 鉴权并具备相应的“管理企业用户”权限。

腾讯会议的企业用户通过创建用户接口（POST /v1/users）创建，phone 为必填项。账号创建后处于“未激活”状态。

用户激活的过程，本质是用该手机号完成一次身份确认：平台向手机号发送激活短信或激活链接，用户确认后账号变为正常状态，同时该手机号被标记为已验证。

因此实际需要处理的需求只有两类：未激活账号如何激活、已激活账号如何换绑手机号。

无论哪种场景，都应先调用获取用户详情接口（GET /v1/users/{userid}，operator_id 与 operator_id_type 放在 query 中）确定账号状态：

字段	需要关注的值	用来回答什么问题
`status`	`1` 正常、`3` 未激活；另有 `2` 注销、`4` 禁用、`5` 预注册	账号本身是否已经激活？
`phone` + `phone_status`	`phone_status`：`0` 未知、`1` 已验证、`2` 未验证	是否有已绑定的手机号？该手机号是否已验证？

调用发送用户激活邀请接口（PUT /v1/users/{userid}/invite-activate），由平台向该账号的手机号发送激活短信，用户确认后账号变为激活态。

当短信内容或渠道需要由企业自己控制时，调用获取账号激活链接接口（POST /v1/users/invite-activate；注意与 3.1 的 PUT 同名不同接口）：

换绑是独立于激活的需求：用户已激活（status=1），需要把绑定手机号换成新号码。换绑除验证新号码外，还要先取得旧手机号验证通过的 token。最终调用校验绑定手机号验证码接口时使用 type=2，并携带该 token。

步骤	处理方式
发起原号码验证	调用向目标换绑手机号发送验证码接口（`POST /v1/users/phone/rebind-send-code`），发送换绑验证所需验证码。
获取换绑凭证	调用获取换绑手机号 token接口（`POST /v1/users/phone/get-token`），使用原手机号及其验证码取得 token。token 的有效期为 5 分钟。
验证新号码	调用向目标手机号发送验证码接口（`POST /v1/users/phone/bind-send-code`），向新手机号发送验证码。
完成换绑	调用校验绑定手机号验证码接口（`POST /v1/users/phone/bind`），提交新手机号、新号验证码、`type=2` 和第 2 步取得的 token。

接口调用失败时，可从响应的 error_info.error_code 获取错误码。下表摘录自腾讯会议错误码及本节涉及的各接口文档；同一错误码在不同接口中的描述可能略有区别，处理时应以所调用接口的错误码说明为准。

错误码	常见场景	错误描述
`190004`	各类接口	参数非法（如 `operator_id不能为空`、`userid_list 长度为0`）。
`20001`	激活邀请、验证短信	用户不存在。
`15101`	发送激活邀请	今天已经向该用户发送过邀请提醒。
`190446`	发送验证短信	用户未激活。
`500124`	发送验证短信	用户无需验证。
`500119`	发送验证短信	今天已经向该用户发送过验证信息。
`500091`	验证短信	无权限进行该操作，建议检查操作者身份或资源归属。
`500121`	验证短信	用户未绑定手机号。
`500190`	手机号验证码发送	接口调用频率达到上限。
`500191`	验证码发送或校验	验证码通用错误（手机号发送超限、校验超限、验证码不正确）。
`500192`	校验绑定手机号验证码	绑定手机号业务失败通用错误码。
`550000`	手机号绑定、换绑	请求超时，请稍后再试。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。