集成效果
PC 效果

H5 效果






软件要求
客服端建议 Chrome/Edge 88+、Firefox 78+、Safari 14.1+。下载地址如下:
微软 Edge
Firefox
Safari
集成步骤
您可以按照以下步骤进行开发集成:
1. 参考 快速入门 开通并配置好在线客服。
2. 使用 Demo 跑通。
使用 Demo 跑通
Demo 接入流程
原理
智能客服提供 JavaScript SDK。Web 前端通过业务服务端获取 SDK URL,并使用该 URL 初始化 AI Desk Core。AI Desk Core 负责加载和初始化原生 SDK、建立连接,同时作为 UI 数据层向 Web 前端提供数据与交互能力。整体集成流程如下:

关键概念
SdkAppId:您开通的智能客服应用 appid,称之为 SdkAppId,通常为160开头。
UserID :客服或管理员在智能客服内配置的账号,通常为邮箱格式,管理员参考 成员管理 添加客服账号。
SecretId 和 SecretKey:开发者调用云 API 所需凭证,通过 腾讯云控制台 创建。
SDKURL:初始化 Web SDK 时的 JS URL,通过云 API 创建,该 URL 有效时长为10分钟,请确保只使用一次,在需要初始化 SDK 时请求创建,SDK 初始化成功后无需重复创建。
步骤1:获取必备参数
1. 获取腾讯云账号的
SecretId 和 SecretKey,可参见 获取密钥。2. 获取智能客服应用的 SdkAppId,在 控制台 > 智能客服 页面,单击前往管理端。


3. 在跳转过去的页面 URL 上,可以找到160开头的数字,这串数字就是智能客服应用的 SdkAppId。


4. 在管理端的团队管理 > 成员中可以获取客服的 UserID 用于 Demo 登录。


步骤2:通过 Demo 登录工作台
说明:
为了数据安全性,获取 SDK URL 的步骤需要接入方后台开发实现,Demo 中为了方便集成,所以内置了一个获取 SDK URL 的 node 服务。
1. 打开 Demo 安装依赖并运行。
//安装依赖npm i//运行项目npm run serve
2. 根据 Demo 登录页的输入提示输入获取 SDK URL 所需要的数据。


注意:
如果使用国际站应用,需要设置站点为国际站。


3. 执行初始化 AI Desk Core 的流程并登录。


联系我们
如果您在接入过程中有任何疑问,请用微信或企业微信扫码加入智能客服交流群进行咨询。
