自建渠道接入指南
选择自己的客户端,下载接入包,按准备、安装、功能接入和上线检查完成接待。
下载接入包
- Web / H5
含原版渠道 iframe 示例及无 UI 客户端。复用完整渠道外观请选择 web/voice-example.html 或渠道嵌入代码;无 UI 客户端需自行绘制界面。
- iOS
WKWebView Swift 容器示例,加入现有 Xcode 工程编译;不含预编译 framework。
- Android
WebView Kotlin 容器和 Manifest 合并片段,需宿主工程编译;不含 AAR。
- Harmony 鸿蒙
ArkWeb API 12+ 页面和权限片段,需 DevEco 宿主工程编译;不含 HAR。
- Uniapp
App-vue 容器与 Vue2 / Vue3 的 H5、微信示例默认加载当前原版渠道。原生文本为替代方案,按目标配置并完成真机验收。
- 微信小程序
默认 web-view 复用原版渠道页面,需业务域名;另含原生聊天与语音替代组件,按各自能力与权限完成真机验收。
接入流程一览
- 选择方案
按网站、小程序或 App,选择对应教程与接入包。
- 准备入口
发布智能体,配置接待组,取得专用入口参数。
- 接入客户端
配置域名与页面,用户点击后才打开客服。
- 验证收发
验证 AI 回复、人工接管、账号切换,再发布。
选择接入平台
网站可直接嵌入现有聊天界面,也可使用同源消息 SDK。小程序提供原生聊天源码组件;App 提供网页容器源码示例。下载文件的交付形式与支持范围在各教程中说明。
1. 接入准备
- 准备已部署的公网 HTTPS 主机;确认企业账号、模型资源、接待权限和可用余额。
- 配置并发布智能体,在「渠道 → 自建渠道」创建专用渠道和服务入口,绑定智能体或工作流、人工组及服务时段。
- 从入口复制公开 key 与 entryId,记录自己的 baseUrl。公开入口标识用于访客接入;管理 API Key 和 AppSecret 只放服务端。
2. 安装与初始化
- 下载本页或具体教程提供的接入包,按对应目录集成到现有工程;保留宿主自己的签名、路由与权限配置。
- 按平台配置 HTTPS 来源或合法域名,替换示例中的占位值。小程序需要配置 request、uploadFile、downloadFile 域名。
- 用户点击“聊一聊”后再打开界面、建立会话;退出登录或切换账号前清理旧会话与回调。
3. 按需接入功能
先完成文字收发与人工接管,再按实际交付范围启用附件、客户资料、评价和业务操作。消息 SDK、网页容器和平台原生客服入口分别使用各自的协议。
4. 联调与上线
- 在测试入口实际发送业务问题,核对 AI 回复、人工接管和人工回复在客户界面与接待台一致。
- 检查手机键盘、展开收起、断网恢复、重复消息、账号切换及已启用的附件功能;App 和小程序需要真机测试。
- 逐项记录环境、入口、包摘要和结果。保存配置或 HTTP 成功不等于业务完成,订单、退款和工单以实际业务回执与确认结果为准。
相关文档
实现依据 · 仓库内路径
lib/channels/channel-products.tssdk/client-kit/README.mdsdk/wechat-miniapp/README.md
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。