云蝠接入概览
从接入方式、凭据和服务能力开始,选择适合自己产品的路径。
下载接入包
- 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 复用原版渠道页面,需业务域名;另含原生聊天与语音替代组件,按各自能力与权限完成真机验收。
服务如何连接
用户点击入口 → 创建访客会话 → 入口绑定的已发布智能体接待 → 按规则或请求转人工 → 在接待台跟进,独立确认业务结果。各端统一连接云蝠接待服务。
接入方式对照
| 场景 | 使用方式 | 交付边界 |
|---|---|---|
| 网站 / H5 | 渠道生成的 widget.js 或 iframe | 现有网页接待界面;异域网站优先此方式 |
| 自定义 Web UI | 同源 HTTPS 无 UI SDK | 文字、人工、分页、附件等;自行实现界面 |
| 微信小程序 | 原生聊天源码组件 / 客户端 API / 可选 RTC 语音组件 | 非微信市场插件;实时语音需腾讯配置、微信准入和真机验收,录音消息未提供 |
| iOS / Android / Harmony / Uniapp | 源码 WebView 容器 | 需宿主编译和真机验收,非发行版原生 SDK |
| 业务系统 | /v1/operations/{operationId} | 仅服务端持有 API Key,按操作授权 |
| 第三方客服渠道 | 对应平台连接器 | 每个平台独立授权、回调和真实收发验收 |
如何判断接通
下载、初始化、保存配置、加载页面或收到 HTTP 200 都不等于服务接通。分别记录 AI 实际回答、人工接管与回复、渠道接受、业务执行回执和客户确认。本文示例占位值必须替换;不会自动创建账号或发布配置。
实现依据 · 仓库内路径
lib/developer-docs/integration-playbooks.tssdk/client-kit/README.md
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。