微信小程序申请与配置

本文说明在微信公众平台完成小程序创建、硬件设备与微信VoIP通话相关能力开通， 以及与业务服务器的消息通道配置。 以下内容以微信平台界面为准，若有变更请以 微信官方文档 为准。

前置条件：

• 已完成微信小程序注册（个体 / 企业主体均可，需通过实名认证）
• 具备小程序开发基础环境（微信开发者工具）
• 服务器已部署 HTTPS 服务（支持 443 端口）

1. 小程序与硬件设备能力申请

完成小程序创建及「硬件设备」能力开通，为微信VoIP通话功能申请所需的设备权限。

1.1 操作步骤

步骤 1：进入微信开发者后台

1. 访问官方地址：微信公众平台（小程序登录入口）。
2. 使用已注册并实名认证的小程序账号登录（需具备「开发管理」或超级管理员等相关权限）。

步骤 2：开通「硬件设备」能力

1. 登录后，左侧导航选择 「行业能力」→「硬件设备」→「开通」。
2. 按微信官方指引完成信息与资质配置，可参考：硬件设备能力接入指南（以官方最新页面为准）。
3. 开通申请提交后，微信平台通常在 1–3 个工作日内审核；可在 「硬件设备 - 审核记录」 中查看进度。

步骤 3：添加设备并申请微信VoIP通话相关能力

1. 审核通过后，进入 「硬件设备 - 设备管理」→「添加设备」。

2. 按实际情况填写设备信息（需与真实产品一致，否则能力可能被驳回）：

   • 设备类型：按产品类目选择（例如「家居安防 - 摄像头」等）。
   • 设备型号：与产品铭牌或对外型号一致（如 AI-IPC-60、TG-IPC-60 等）。
   • model_id：由微信平台生成或分配，务必保存，开发与小程序呼叫时会用到。

3. 勾选需申请的能力（以微信后台可选项为准），通常包括：小程序音视频能力（微信VoIP通话核心依赖）、**校验能力（设备合法性）**等。

4. 提交申请；在 「设备管理 - 审核记录」 中跟进审核状态。

2. 配置微信小程序消息推送

配置微信后台与业务服务器的消息通道，使微信VoIP通话相关事件（如呼叫、通话状态等）可推送到服务器。

2.1 操作步骤

步骤 1：进入消息推送配置页

1. 登录微信公众平台 → 「开发」→「开发管理」 → 打开 「开发设置」 标签页。
2. 找到 「消息推送」，点击 「修改配置」（若从未开启，需先 「启用」）。

步骤 2：填写配置参数

配置项	说明与填写要求
URL（服务器地址）	业务回调地址,
令牌（Token）	由业务方自定义（建议高强度随机字符串，如 32 位），用于校验签名。
消息加解密密钥（EncodingAESKey）	安全模式下必填；可点击「随机生成」，并保存到安全配置中。
消息加密方式	建议选择 「安全模式」。
数据格式	选择 「XML」。

提交 / 验证。

步骤 3：完成微信验证

1. 参数填写完成后点击 「提交」，微信会向上述 URL 发起 GET 验证请求（含 signature、timestamp、nonce、echostr 等）。
2. 提交前请确认你的业务服务已经配置了对应的 appId、appSecret、token、EncodingAESKey。
3. 若服务器按微信规则正确返回 echostr，页面会提示配置成功；若失败，请检查 URL 公网可达、HTTPS 证书、Token 及 EncodingAESKey 是否一致。

2.2 注意事项

1. URL 须为 HTTPS；小程序 request 合法域名 中需包含业务实际访问的域名。

2. 若你的机房或 WAF 使用 IP 白名单，需将 微信服务器 IP 列表 中公布的推送来源加入放行，避免验证与后续事件推送被拦截。
3. 消息推送配置 修改并提交后，旧配置即失效；建议先在测试环境或沙箱验证，再切生产。

3. 设备送审（腾讯官方要求）

硬件设备与微信VoIP通话能力上线前，须按 腾讯官方 要求完成送审与合规流程，例如：

• 微信小程序硬件设备送审等相关指引（微信开放社区）

请以微信当前发布的送审文档、类目要求与审核结果为准，并预留审核周期。