公众号/模板消息配置

微信公众号/模板消息配置

TDuckX 支持接入微信公众号，实现 消息通知、OpenID 获取、微信内填写表单等能力。 配置前请确保账号条件满足，否则后面步骤都会失败。

一、前置条件（必须满足）

⚠️ 强制要求

  • 必须是 企业认证的服务号
  • 必须完成 微信认证（年审）
  • 必须具备 开发者权限

❗不满足以上条件会导致：

  • 无法获取 OpenID
  • 消息推送失败
  • JS-SDK 无法使用
  • 接口调用受限

二、配置流程总览（建议按顺序）

  1. TDuckX 后台配置基础参数
  2. 获取公众号 AppId / AppSecret
  3. 配置开发者接口（服务器配置）
  4. 配置业务域名 & JS 安全域名（建议）
  5. （可选）模板消息 / 订阅通知配置

三、后台参数配置

路径： 系统管理 → 系统配置 → 微信公众号 图片

需要填写：

  • AppId
  • AppSecret
  • Token（自定义）
  • EncodingAESKey（43位随机字符串）

⚠️ 注意：

  • 不要有空格
  • Token / AESKey 必须与微信后台一致
  • 修改后一定要点击“保存”

四、获取 AppId / AppSecret

进入微信公众号后台获取： 图片

📌 入口变更说明 微信已逐步迁移开发入口至开发者平台： https://developers.weixin.qq.com/platform/

五、开发者配置（核心步骤）

进入：

设置与开发 → 开发接口管理 图片 图片 图片

六、服务器配置（消息推送关键）

开启服务器配置，并填写：

URL 格式：

你的域名 + /tduck-api/wx/mp/portal/ + AppId

示例：

https://pro.tduckapp.com/tduck-api/wx/mp/portal/wx0d6a2a9fd1a0edab

图片

同时填写：

  • Token（与TDuckX一致）
  • EncodingAESKey（与TDuckX一致）

⚠️ 常见错误：

  • URL 访问不到（必须公网可访问 + HTTPS）
  • Token/AESKey 不一致 → 校验失败
  • 服务器未启动 → 配置失败

七、域名配置（强烈建议配置）

1. 业务域名

用于网页授权、接口调用

2. JS接口安全域名

用于微信分享、JSSDK能力 图片 图片

⚠️ 不配置的后果：

  • 分享样式异常
  • 微信内页面功能异常（如定位、分享）

八、模板消息配置（可选）

步骤：

  1. 在公众号后台申请模板
  2. 模板字段类型必须匹配
  3. 回到 TDuckX 点击「同步公众号模板」 图片

⚠️ 关键注意

  • 字段类型不一致 → 报错 47003
  • 模板必须已审核通过
  • 同步后才能使用

订阅通知特殊要求

必须：

  1. 创建一个默认模板
  2. 同步到系统
  3. 修改 Code 为：
WxNewWriteNotify

否则无法正常推送 image.png

九、常见问题排查（很重要）

1. 收不到消息

优先检查：

  • 是否已关注公众号
  • 是否授权订阅
  • 是否点击“保存设置”
  • 模板是否正确同步
  • 用户是否有 OpenID

👉 解决办法：

  • 取消关注 → 重新扫码关注
  • 重新触发订阅

2. redirect_uri / 域名报错

原因：

  • 域名未配置
  • www 和非 www 不一致

解决：

  • 统一使用一个域名
  • 同时配置业务域名

3. 接口校验失败

检查：

  • URL 是否能访问
  • Token / AESKey 是否一致
  • HTTPS 是否有效证书

4. OpenID 获取失败

原因：

  • 非服务号
  • 未认证
  • 未走微信授权流程

十、一句话总结

公众号接入最核心就三件事：

  1. 参数一致（AppId / Token / AESKey）
  2. URL 可访问（公网 + HTTPS）
  3. 域名正确（业务域名 + JS域名）

这三点对了，80%问题直接消失。