开发者文档中心

OpenAPI进入控制台

微信小程序 SDK · 2026-10-31

小程序 API 与能力边界

复用消息、附件、知识与记忆 API;区别小程序文件路径和浏览器文件对象。

下载接入包

初始化参数

参数要求
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 仅放服务端。参数、地域、类目和资费以官方当前页面及账号实际开通结果为准。

实现依据 · 仓库内路径
  • sdk/wechat-miniapp/index.d.ts
  • sdk/wechat-miniapp/README.md

文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。