小程序 API 与能力边界
复用消息、附件、知识与记忆 API;区别小程序文件路径和浏览器文件对象。
下载接入包
- 微信小程序
默认 web-view 复用原版渠道页面,需业务域名;另含原生聊天与语音替代组件,按各自能力与权限完成真机验收。
初始化参数
| 参数 | 要求 |
|---|---|
| wx | 宿主微信 API 对象,必填 |
| baseUrl | 固定公网 HTTPS origin,不带路径和查询 |
| key / entryId | 自己的已启用入口参数,不能放 AppSecret / 管理密钥 |
| userScope | 可选;推荐每个业务账号独立,退出清理;不是认证凭据 |
| visitorContext | 可选说明资料,服务端清洗;不得据此宣称会员已认证 |
| pollInterval | 可选轮询间隔,由客户端限幅;后台暂停 |
消息与扩展接口
diagnoseMiniapp 为无网络本机检查;preflight 只读公开入口。connect、refresh、loadEarlier、sendText、handoff、end、restart、retryPending、discardPending、submitContact、rate、searchKnowledge、memory、changeMemory 与 Web 共用状态机。准确签名见包内 index.d.ts 及本指南的消息、附件章节。
文件差异
小程序 upload(filePath) 接收 wx 本地路径;download(mediaId) 返回鉴权下载后的临时文件路径。使用微信图片、视频或文档预览;这里没有 Web 的 releaseDownload()。
AI 实时语音与在线接听
完整 SDK 包包含 yunfu-voice 原生组件。用户同意隐私和麦克风后进 TRTC 房间,进房成功才启动已发布智能体。客服仅能邀请当前前台在线客户,客户可接听或拒绝;不承诺离线微信来电。企业关闭语音后入口隐藏,服务端拒绝续租和回答并回收通话。腾讯媒体单独结算,AI 回答沿用现有模型与接待额度;公开访客不获得私有订单或 CRM 权限。
语音接通前核对
| 条件 | 确认方式 |
|---|---|
| 应用与入口 | 企业语音已开通;入口和已发布智能体均开启语音,服务时间有效 |
| 小程序权限 | 企业 AppID、推拉流标签、隐私指引、麦克风授权及 iOS/Android 真机 |
| 腾讯服务 | 独立 TRTC 应用、高级房间权限、AI bot 入房已实测、音色、回调 HTTPS 主机和安全服务端配置 |
| 费用与验收 | 腾讯 RTC/ASR/TTS 外部结算;AI 接待额度可用。自动控制测试不代替云端和音频验收 |
尚未接入
录音消息、视频通话、离线微信原生来电、微信 openid 认证、跨设备合并历史、模板 / 订阅消息未接入。当前小程序接入包的独立 yunfu-voice 组件支持配置就绪后的原生实时语音与在线邀请,仍需腾讯及真机验收。服务端来源仍为自建 Web 入口,请专门命名便于来源分析。
官方原始接入文档
先按云蝠指南完成入口、智能体和服务配置,再按下列官方原文配置宿主权限或供应商资源。外部文档说明对应平台能力,不代表云蝠已开放其中全部接口;腾讯 SecretKey、签名密钥和管理 API Key 仅放服务端。参数、地域、类目和资费以官方当前页面及账号实际开通结果为准。
- 微信开放文档 · 小程序网络与合法域名 ↗:原生请求需配置 request、uploadFile、downloadFile 合法域名;WebView 另需业务域名,关闭校验不能代替正式配置。
- 微信开放文档 · 隐私授权开发指引 ↗:接入宿主隐私告知和同意流程;隐私同意、系统麦克风授权与实际收音分别验收。
- 微信开放文档 · wx.authorize 授权接口 ↗:核对 scope.record 与拒绝后的处理;进入聊天页或点击普通按钮不等于已完成录音授权。
- 微信开放文档 · live-pusher 原生推流组件 ↗:核对原生推流组件、主体及类目权限;与腾讯 SDK 配置配套,在真机验证音频事件。
- 腾讯云 · 原生小程序快速接入 ↗:先核对企业主体、允许类目、推拉流权限、TRTC 套餐和 SDK 域名,再完成进房、发布音频与退房;开发工具不能代替真机。
- 腾讯云 · 实现 AI 对话 ↗:理解 RTC、识别、LLM、TTS、转录和打断的职责;具体参数与频率以对应接口的当前版本为准。
- 腾讯云 · 开始 AI 对话任务 · StartAIConversation ↗:服务端适配时核对地域、SdkAppId、房间、目标用户与模型配置,保留 TaskId/RequestId;返回成功还需核对手机是否实际出声。
- 腾讯云 · 控制 AI 对话 · ControlAIConversation ↗:核对供应商支持的播报和模型触发命令;仅供服务端适配参考,不可直接当作云蝠公开操作调用。
- 腾讯云 · 停止 AI 对话 · StopAIConversation ↗:结束服务端 AI 对话任务并核对原 TaskId 的回收结果;退出客户端页面不应被当作云端任务已停止的证明。
- 腾讯云 · 高级权限控制 ↗:评估服务端 UserSig、PrivateMapKey 与房间隔离;通用平台表不证明小程序和 AI bot 已兼容,启用前须在实际应用核对入房。
实现依据 · 仓库内路径
sdk/wechat-miniapp/index.d.tssdk/wechat-miniapp/README.md
文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。