Z Tag
管理组织服务与凭证配置

腾讯云 IM

获取 SDKAppID 与密钥,配置 IM 服务地址、App 管理员账号和允许调用的 REST API。

适用于组织 Owner / Admin;成员的个人连接器同样适用

在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 腾讯云 IM。这组凭证让 ZAI 调用即时通信 IM 的服务端 REST API,例如发送单聊消息、管理群组和账号。

获取与填写凭证

在即时通信 IM 控制台单击 应用管理,在目标应用的操作列单击 查看密钥,再单击 显示密钥 并复制,填入 密钥(SecretKey)。密钥能为该应用的任何账号签发登录凭证,请妥善保管。官方说明:UserSig 鉴权。

SDKAppID

填写目标应用的 SDKAppID,可在 IM 控制台的应用卡片或应用管理列表中找到。密钥必须属于同一个应用。

App 管理员账号

填写该应用的 App 管理员账号(UserID),例如控制台默认创建的 administrator。腾讯云要求调用 REST API 时使用 App 管理员账号;没有时先在 IM 控制台配置。账号只能包含字母、数字、下划线和连字符。

服务地址

按应用所在的数据中心填写主域名;所在网络无法解析主域名时,改用同一数据中心的备用域名。

数据中心主域名备用域名
中国console.tim.qq.comadminapi.my-imcloud.com
新加坡adminapisgp.im.qcloud.comadminapisgp.my-imcloud.com
首尔adminapikr.im.qcloud.comadminapikr.my-imcloud.com
东京adminapijpn.im.qcloud.comadminapijpn.my-imcloud.com
法兰克福adminapiger.im.qcloud.comadminapiger.my-imcloud.com
硅谷adminapiusa.im.qcloud.comadminapiusa.my-imcloud.com
雅加达adminapiidn.im.qcloud.comadminapiidn.my-imcloud.com
利雅得adminapiksa.im.qcloud.comadminapiksa.my-imcloud.com

例如 https://console.tim.qq.com。只能填写表中的域名;推荐配置限定路径 /v4,只允许 POST。官方说明:REST API 简介。

允许的 API

每行填写一个 REST API,写成 servicename/command,例如 openim/sendmsg、group_open_http_svc/get_group_info;带上 v4/ 前缀也可以。大小写按官方 API 列表照抄,例如 ConfigSvc/GetIPList。ZAI 只能调用列表中的 API。

ZAI 调用时只需发送 POST https://<服务地址>/v4/<servicename>/<command> 和 JSON 正文,正文为空时也要发送 {}。平台在每次请求里填写 sdkappid、identifier 和 usersig,请求里自带的这三项不会生效。

SDKAppID、App 管理员账号和允许的 API 在创建时确定,之后不能修改;需要调整时,另添加一份凭证。

验证

保存后请 ZAI 调用一项已授权的只读 API,例如获取服务器 IP 地址的 ConfigSvc/GetIPList(需先把它加入 允许的 API)。返回的 ActionStatus 为 OK 才表示成功。返回签名或账号相关的错误时,先核对 SDKAppID 与密钥是否属于同一个应用、App 管理员账号是否存在,以及服务地址是否对应应用所在的数据中心。其余排查见验证与排错。

本页目录