腾讯云 IM
获取 SDKAppID 与密钥,配置 IM 服务地址、App 管理员账号和允许调用的 REST API。
在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 腾讯云 IM。这组凭证让 ZAI 调用即时通信 IM 的服务端 REST API,例如发送单聊消息、管理群组和账号。
获取与填写凭证
在即时通信 IM 控制台单击 应用管理,在目标应用的操作列单击 查看密钥,再单击 显示密钥 并复制,填入 密钥(SecretKey)。密钥能为该应用的任何账号签发登录凭证,请妥善保管。官方说明:UserSig 鉴权。
SDKAppID
填写目标应用的 SDKAppID,可在 IM 控制台的应用卡片或应用管理列表中找到。密钥必须属于同一个应用。
App 管理员账号
填写该应用的 App 管理员账号(UserID),例如控制台默认创建的 administrator。腾讯云要求调用 REST API 时使用 App 管理员账号;没有时先在 IM 控制台配置。账号只能包含字母、数字、下划线和连字符。
服务地址
按应用所在的数据中心填写主域名;所在网络无法解析主域名时,改用同一数据中心的备用域名。
| 数据中心 | 主域名 | 备用域名 |
|---|---|---|
| 中国 | console.tim.qq.com | adminapi.my-imcloud.com |
| 新加坡 | adminapisgp.im.qcloud.com | adminapisgp.my-imcloud.com |
| 首尔 | adminapikr.im.qcloud.com | adminapikr.my-imcloud.com |
| 东京 | adminapijpn.im.qcloud.com | adminapijpn.my-imcloud.com |
| 法兰克福 | adminapiger.im.qcloud.com | adminapiger.my-imcloud.com |
| 硅谷 | adminapiusa.im.qcloud.com | adminapiusa.my-imcloud.com |
| 雅加达 | adminapiidn.im.qcloud.com | adminapiidn.my-imcloud.com |
| 利雅得 | adminapiksa.im.qcloud.com | adminapiksa.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 管理员账号是否存在,以及服务地址是否对应应用所在的数据中心。其余排查见验证与排错。