腾讯云智能数智人 高级版接入指引

一、一、角色说明

整个业务模式涉及四种角色，关系如下：

三、2.1 服务购买开通

·商务流程（集成商向腾讯商务发起）：联系腾讯商务签署合约或通过腾讯云下单 iPaaS 服务。

·服务开通（腾讯交付人员操作）：腾讯交付人员通过管理员身份，在腾讯数字人 SaaS 后台管理系统 > 租户管理模块，录入集成商的 iPaaS 服务资产及服务有效期，开通日即视为服务开始日。服务开通后，会获得后台管理系统的租户工作台管理账号。

六、对接服务，集成页面

提前阅读下方架构和接口文档，做好集成环境准备。

七、2.3 用户会员套餐 SKU 设计

在接入服务前，集成商可先参考以下权益项，自主设计租户层面的会员套餐 SKU 定价及包含的权益项范围。

注意：说明：

用户会员套餐 SKU 权益控制元数据项

十三、接口说明

表述数字人 iPaaS 可被集成的页面，以及页面集成相关协议参数及接口约定。

十四、可集成页面

iPaaS 首页。

十五、页面集成方法

1. 做一个 iframe 页面，引入 iPaaS 的 js、添加一个 iframe 元素，并使用 init 函数初始化 iPaaS 设置。

<html><head> <title>集成商iframe页面示例</title> <script src="https://static-avatarch.ivh.qq.com/avataripaassdk.js"/> <script> AVATARIPAAS.init({ tenant_code: "apple", //租户唯一代码 auth: "nldaso0n1nc01n13MABc==", //用户登录态加密串，拼接到iframe的query时会进行urlencode iframeid: "main", // 框架页iframe元素的id access_path: "https://www.mywebsite.com/hello", // iframe页面的url路径。 on_goback: function() { // 当用户首次使用时，在弹窗页面选择了拒绝使用时回调 // do something, 比如使用浏览器 go history -1 }, on_authexpired: function() { // 当腾讯检测到用户登录态失效时回调 // do something, 比如跳转到登录页 }, }); </script></head><body> <!– 当引入avataripaassdk.js并init之后，会自动设置iframe的src嵌套ipaas页面 –> <iframe id="main"/> </body></html>

2. 在 nginx 中，对 iframe 页面进行代理设置。

·将 iframe 访问 URL 统一代理给自身（实现 iframe 内切换页面后，再刷新 iframe 页时实现当前页刷新）。

·假设你的网站"/hello"是 iframe 页面的路径，进行如下设置。

server { listen 80; server_name https://www.mywebsite.com; // 代理的网站域名 location /hello/ { // 将hello下的子路经全部代理回hello，此处末尾一定要加/，否则会导致代理死循环 rewrite ^(.*)$ /hello break; // 此处路径w末尾不加/ proxy_pass https://www.mywebsite.com; }}

附加说明：

十六、auth 参数加密方法

1. 构建明文字符串

user_token=${user_token}&ts=${timestamp}，其中 user_token 是用户登录态，能够唯一标识一个用户的登录态，可直接传入集成商登录态或者再临时生成一个和登录态一一对应的临时 Token 都可以，由集成商来决定，因是 URL query 带参，不建议直接将 jwt token 写入，会导致 query 过长；timestamp 是生成的当前系统时间戳（Unix 时间戳精确到秒），腾讯侧会对时间戳做校验，有效性一分钟。

2. 将明文字符串进行加密

·使用 AES 加密算法，采用 GCM 模式，将租户级 Token 作为密钥对明文字符串进行加密，加密后转 Base64 字符串。

·租户级 Token 获取方法如下：

3. 将步骤2得到的结果字符串作为 auth 的值。

4. 可使用后台管理控制台的调试工具，进行加解密测试。

十八、接口说明

该接口用于打通数字人 iPaaS 和集成商系统的登录态以及完成两侧用户资料的映射。

注意：集成商需按照本接口协议实现此接口，并在管理系统将此接口地址注册到系统中。

十九、调用协议

·协议：HTTPS

·方法：POST

·Header Content-Type: application/json;charset=utf-8

20、请求 Header

21、请求参数

{ "user_token": "jnnuqneqwbunqoncv121nnqonca1561a", "request_id": "hbkoqnzlobnqbdsao1bn231ncdo1oqa",}

22、返回参数

{ "code": 0, "message": "paas", "request_id": "hbkoqnzlobnqbdsao1bn231ncdo1oqa", "data": { "user_info": { "token_expire_at": 1747368027, "user_id": "5612910", "nickname": "魔礼青", "mobile": "139****4452", "email": "liut****@163.com", } }}