概述
本教学将指导你如何在 Pathors 中集成微信公众号，包含创建公众号应用、获取 AppID 和 AppSecret、在 Pathors 中配置集成以及设置 Webhook URL。前提条件
开始之前，你需要：- 一个微信公众号（服务号或订阅号）
- 微信公众平台的访问权限
- 公众号的开发者权限
步骤 1：获取微信公众号凭证
在 Pathors 中配置集成之前，你需要从微信公众平台获取 AppID 和 AppSecret。获取 AppID 和 AppSecret：
- 访问微信公众平台：访问 微信公众平台 并使用你的公众号凭证登录
-
导航到基本配置：
- 在左侧侧边栏中，找到并点击”开发”
- 选择”基本配置”
-
找到 AppID：
- 你的 AppID 会显著显示在页面顶部
- 格式：
wx后跟 16 位十六进制字符（例如：wx1234567890abcdef） - 复制此 AppID 以在 Pathors 中使用
-
生成 AppSecret：
- 寻找”AppSecret”部分
- 如果你之前没有生成过，点击”生成”按钮
- 如果你已有一个但需要重置，点击”重置”按钮
- ⚠️ 重要：AppSecret 只会显示一次 - 立即复制并保存
- 格式：32 位十六进制字符（例如：
1234567890abcdef1234567890abcdef）
重要提示： 请妥善保管你的凭证！不要公开分享你的 AppSecret 或将其提交到版本控制系统。
步骤 2：在 Pathors 中配置微信集成
现在你有了微信凭证，让我们在 Pathors 中设置集成。启用集成
-
访问集成页面：
- 登录你的 Pathors 项目
- 导航到”集成”页面
- 找到微信集成卡片（带有微信徽标）
-
启用集成：
- 点击右上角的开关按钮启用微信集成
- 卡片将变为活动状态，表单字段将被启用
配置你的凭证
-
输入 AppID：
- 粘贴你从微信公众平台复制的 AppID
- 格式应该是：
wx+ 16 位十六进制字符
-
输入 AppSecret：
- 粘贴你从微信公众平台复制的 AppSecret
- 格式应该是：32 位十六进制字符
- 此字段出于安全考虑是密码保护的
-
测试你的凭证：
- 点击”测试凭证”按钮
- 这将验证你的 AppID 和 AppSecret 是否有效
- 如果成功，你会看到绿色确认消息
可选：生成安全令牌
-
生成令牌（推荐）：
- 点击令牌字段旁边的洗牌图标（🔀）自动生成安全令牌
- 或输入你自己的自定义令牌（3-32 个字母数字字符）
- 此令牌为 Webhook 验证增加额外安全性
-
保存配置：
- 点击”保存”按钮存储你的设置
- 所有字段都将被保存，集成将准备就绪
步骤 3：设置 Webhook URL
最后一步是配置 Webhook URL，以便微信可以向你的 Pathors 助手发送消息。从 Pathors 复制 Webhook URL
- 找到 Webhook 部分：
- 在 Pathors 中向下滚动到”Webhook 设置”部分
- 你会看到一个自动生成的 Webhook URL
- 点击复制按钮复制此 URL
在微信平台中配置服务器设置
-
返回微信平台：
- 回到 微信公众平台
- 导航到”开发” → “基本配置”
-
找到服务器配置部分：
- 寻找”服务器配置”部分
- 如需要，点击”修改配置”
-
输入服务器详情：
- 服务器地址(URL)：粘贴你从 Pathors 复制的 Webhook URL
- 令牌(Token)：输入你在 Pathors 中配置的相同令牌（如果你设置了的话）
- 消息加解密密钥(EncodingAESKey)：你可以生成一个或留空以使用明文模式
- 消息加解密方式：为简单起见选择”明文模式”
-
提交并启用：
- 点击”提交”保存服务器配置
- 微信将通过发送测试请求来验证 Webhook URL
- 如果验证成功，点击”启用”激活服务器配置
验证过程： 微信会向你的 Webhook URL 发送 GET 请求以验证其正常工作。Pathors 会自动处理此验证。
步骤 4：测试你的微信集成
一旦一切都配置完成，就是测试你的微信机器人的时候了！-
找到你的公众号：
- 使用微信手机应用扫描你公众号的二维码
- 或在微信中搜索你的公众号名称
-
关注并测试：
- 关注/订阅你的公众号
- 发送消息开始与你的 Pathors AI 助手聊天
- 助手应根据你配置的工作流程做出响应
-
验证集成：
- 检查消息是否出现在你的 Pathors 会话历史中
- 确认响应正在发送回微信
- 测试不同类型的消息（文本、图像如果支持的话）
重要提示
- AppID 格式：AppID 应以”wx”开头，后跟 16 位十六进制字符（例如：
wx1234567890abcdef） - AppSecret 格式：AppSecret 应为 32 位十六进制字符（例如：
1234567890abcdef1234567890abcdef） - 安全性：请妥善保管你的 AppSecret，不要公开分享
- 启用顺序：必须先启用集成开关，然后才能输入和保存凭证
- 令牌要求：令牌是可选的，但建议用于 Webhook 安全验证
- 自动菜单：Pathors 会自动管理你公众号的微信菜单
微信平台配置步骤
在微信公众平台中配置 Webhook URL 涉及以下步骤：- 登录微信公众平台
- 前往开发 → 基本配置
- 在服务器配置部分，输入来自 Pathors 的 Webhook URL
- 输入与 Pathors 中使用的相同令牌（如果已配置）
- 选择适当的消息加密设置
- 提交并启用服务器配置
常见问题
问：为什么我无法保存 AppID 和 AppSecret？
答：请确保你已启用微信集成开关（右上角的开关按钮）。问：凭证测试失败，应该怎么办？
答：请检查：- AppID 格式是否正确（以”wx”开头，后跟 16 位十六进制字符）
- AppSecret 格式是否正确（32 位十六进制字符）
- 凭证是否从微信公众平台正确复制
- 你的公众号是否启用了开发者权限
问：微信平台中 Webhook URL 验证失败？
答：请确保：- 来自 Pathors 的 Webhook URL 在微信平台中正确输入
- Pathors 和微信平台之间的令牌匹配（如果使用令牌验证）
- 你的 Pathors 集成已启用且凭证已保存
- 网络连接允许微信访问 Webhook URL
问：没有收到消息？
答：请验证：- 服务器配置在微信公众平台中已启用
- Webhook URL 已正确配置和验证
- 集成在 Pathors 中已启用且凭证有效
- 用户已关注你的公众号