〇、先搞懂几个词（小白必读）
-
工作流：你在画布里搭的那套自动流程。
-
服务器配置（URL/Token/EncodingAESKey）：公众号后台里告诉微信「用户消息往哪推、怎么验真伪、怎么加密」的一组设置。URL 就是我们的 Webhook 地址，Token 你自定义、用于验签，EncodingAESKey 用于加密。
-
客服消息：公众号「主动给用户发消息」的接口。因为工作流耗时长（几十秒），没法在微信要求的 5 秒内同步回复，所以结果靠客服消息异步推回。这个接口只有认证服务号有——这就是为什么订阅号用不了。
-
access_token：调用微信接口的临时凭证，由 AppID + AppSecret 换取，我们后端自动管理（缓存、刷新），你不用操心。
一、前提：必须是「认证服务号」
微信公众号分订阅号 / 服务号，认证 / 未认证。只有认证服务号能用——因为：
-
工作流跑几十秒，远超微信「5 秒内必须回复」的限制，所以结果不能同步回，必须用客服消息接口异步推回。
-
客服消息接口是认证服务号专属。订阅号 / 未认证号没有这个能力，工作流结果发不回去。
如果你是订阅号或未认证，这套用不了，请改用企业微信。
二、你将得到什么
- 用户给你的公众号发文字 / 图片 → 触发工作流 → 几秒到几十秒后，工作流结果（文字 / 图片）以客服消息发回用户。
三、第一步：拿公众号凭据
登录 微信公众平台 →「设置与开发 - 基本配置」：
| 凭据 | 在哪 |
|---|---|
| AppID | 基本配置页 |
| AppSecret | 基本配置页（点「重置」生成，妥善保存） |
下一步配服务器时还会用到 Token 和 EncodingAESKey（自定义 / 生成）。
四、第二步：在画布填凭据 + 拿 Webhook 地址
-
打开工作流画布，点中「Webhook 开始」节点。
-
触发平台选「微信公众号」，填：
-
公众号 AppID / AppSecret：第一步拿到的。
-
服务器配置 Token：自己定一串（字母数字，3-32 位），下一步要填进微信后台同一个值。
-
EncodingAESKey：用安全模式才填（43 位）；明文模式留空。
- 保存工作流，得到 Webhook 地址：
https://api.openai.run/v1/workflow/webhook/wechat_mp/你的工作流ID
五、第三步：配微信服务器配置
微信公众平台 →「设置与开发 - 基本配置 - 服务器配置」，点「修改配置」：
-
URL：填第二步的 Webhook 地址。
-
Token：填和画布里完全一样的 Token。
-
EncodingAESKey：点随机生成，把它也填回画布的 EncodingAESKey（安全模式）；或选「明文模式」则画布留空。
-
消息加解密方式：建议「安全模式」。
点「提交」——微信会立刻请求你的 URL 做验证，显示「配置成功」即通过（我们后端已实现验证回包）。
提交成功后记得点「启用」。
界面位置：微信公众平台「设置与开发 → 基本配置」页往下有「服务器配置」板块，点「修改配置」进入。里面从上到下依次是 URL、Token、EncodingAESKey 三个输入框，最下方是「消息加解密方式」单选（明文 / 兼容 / 安全模式，建议选安全模式）。EncodingAESKey 右侧有「随机生成」按钮。填完点最下方「提交」触发验证，验证通过后回到上级页面点「启用」。
六、第四步：画布启用工作流
回画布 → 触发方式设为 webhook → 启用。
七、测试
关注你的公众号，发一句话。几秒后工作流结果会以客服消息发回。
注意：客服消息要求用户 48 小时内有互动——用户主动发消息天然满足，所以正常使用没问题。
八、常见问题
Q：服务器配置提交失败 / Token 验证不通过？
-
检查画布的 Token 和微信后台填的是否完全一致。
-
安全模式下，EncodingAESKey 两边也必须一致。
-
确认工作流已保存、Webhook 地址末尾 ID 正确。
Q：发消息没收到回复？
-
确认是认证服务号（订阅号没有客服消息能力，结果发不回）。
-
确认工作流已「启用 + webhook 触发」。
-
确认 AppSecret 填对（换 access_token 用）。
Q：能发图片给它吗？
- 能，但取决于你的工作流有没有处理图片的节点。纯文字工作流收到纯图片可能因无文字输入失败。
九、速查表
凭据：AppID、AppSecret（基本配置）+ 自定义 Token + EncodingAESKey（安全模式）
要求：认证服务号（客服消息接口专属）
URL： https://api.openai.run/v1/workflow/webhook/wechat_mp/<工作流ID>
配置：微信公众平台 → 基本配置 → 服务器配置（填 URL/Token/AESKey，建议安全模式）→ 提交 → 启用
画布：平台选「微信公众号」填凭据 → 保存 → webhook 触发并启用