SuperAPI AI 工具集

zoom-cobrowse-sdk

编程与开发

查看项目

更新于 10-15 16:51

技能介绍

用途:为网站实现协同浏览支持,坐席可实时查看客户浏览器操作、进行标注,并在客户同意下远程滚动页面。SDK 为纯 JavaScript,无需浏览器插件。

主要能力:基于 6 位 PIN 的客户与坐席连接;标注工具(画笔、消失笔、矩形、取色、橡皮、撤销/重做);按 CSS 选择器或 HTML 属性对敏感字段做隐私遮蔽;远程协助(目前仅支持滚动页面,需客户同意);多标签页会话保持;页面刷新后自动重连(窗口 2 分钟);实时会话事件。

使用方式:需 Zoom Workplace 账号及 SDK Universal Credit,并在 Marketplace 创建 Video SDK 应用、从 Cobrowse 标签页获取凭据。客户与坐席为两种角色,role_type 分别为 1 和 2,均需 JWT。典型流程为:客户先开启会话(role_type=1),由后端签发客户 JWT,SDK 启动后经 pincode_updated 事件获得 PIN;坐席后加入(role_type=2),输入该 PIN 后由后端签发坐席 JWT,再打开 Zoom 坐席 iframe(BYOP 模式下用 npm 自建坐席 UI)。官方提供 token 服务示例:git clone https://github.com/zoom/cobrowsesdk-auth-endpoint-sample.git,随后 npm install、配置 .env、npm start。CDN 引入地址为 https://us01-zcb.zoom.us/static/resource/sdk/${ZOOM_SDK_KEY}/js/2.13.2。文档见 https://developers.zoom.us/docs/cobrowse-sdk/,API 见 https://marketplacefront.zoom.us/sdk/cobrowse/,快速示例见 https://github.com/zoom/CobrowseSDK-Quickstart。

限制与注意:必须使用 HTTPS(HTTP 仅限本机回环开发);需允许跨域请求至 *.zoom.us 并配置 CSP;刷新重连依赖第三方 Cookie。SDK Key 可公开(嵌入 CDN URL 与 JWT 的 app_key),SDK Secret 必须留在服务端用于签发 JWT,API Key/Secret 仅用于可选的 REST 调用。会话上限:每会话 1 个客户、5 个坐席、每浏览器 1 个活动会话,PIN 最长 10 字符;坐席等待客户 3 分钟、刷新重连 2 分钟、重连最多 2 次后会话结束。不支持 IE;HTML5 Canvas、WebGL、音视频不同步。跨域 iframe 需注入 SDK 片段,同源 iframe 无需额外处理。演示时用户可见 PIN 应仅取客户 SDK 的 pincode_updated 事件值,否则坐席可能报 code 30308。其余平台或价格信息暂未提供。