​
概述

本教学将指导你如何在 Pathors 中集成微信公众号，包含创建公众号应用、获取 AppID 和 AppSecret、在 Pathors 中配置集成以及设置 Webhook URL。

​
前提条件

开始之前，你需要：
  • 一个微信公众号（服务号或订阅号）
  • 微信公众平台的访问权限
  • 公众号的开发者权限

​
步骤 1：获取微信公众号凭证

在 Pathors 中配置集成之前，你需要从微信公众平台获取 AppID 和 AppSecret。

​
获取 AppID 和 AppSecret：

  1. 访问微信公众平台：访问 微信公众平台 并使用你的公众号凭证登录
  2. 导航到基本配置：
    • 在左侧侧边栏中，找到并点击”开发”
    • 选择”基本配置”
  3. 找到 AppID：
    • 你的 AppID 会显著显示在页面顶部
    • 格式：wx 后跟 16 位十六进制字符（例如：wx1234567890abcdef）
    • 复制此 AppID 以在 Pathors 中使用
  4. 生成 AppSecret：
    • 寻找”AppSecret”部分
    • 如果你之前没有生成过，点击”生成”按钮
    • 如果你已有一个但需要重置，点击”重置”按钮
    • ⚠️ 重要：AppSecret 只会显示一次 - 立即复制并保存
    • 格式：32 位十六进制字符（例如：1234567890abcdef1234567890abcdef）

重要提示： 请妥善保管你的凭证！不要公开分享你的 AppSecret 或将其提交到版本控制系统。

​
步骤 2：在 Pathors 中配置微信集成

现在你有了微信凭证，让我们在 Pathors 中设置集成。

​
启用集成

  1. 访问集成页面：
    • 登录你的 Pathors 项目
    • 导航到”集成”页面
    • 找到微信集成卡片（带有微信徽标）
  2. 启用集成：
    • 点击右上角的开关按钮启用微信集成
    • 卡片将变为活动状态，表单字段将被启用
在 Pathors 中启用微信集成

​
配置你的凭证

  1. 输入 AppID：
    • 粘贴你从微信公众平台复制的 AppID
    • 格式应该是：wx + 16 位十六进制字符
  2. 输入 AppSecret：
    • 粘贴你从微信公众平台复制的 AppSecret
    • 格式应该是：32 位十六进制字符
    • 此字段出于安全考虑是密码保护的
  3. 测试你的凭证：
    • 点击”测试凭证”按钮
    • 这将验证你的 AppID 和 AppSecret 是否有效
    • 如果成功，你会看到绿色确认消息
配置微信凭证

​
可选：生成安全令牌

  1. 生成令牌（推荐）：
    • 点击令牌字段旁边的洗牌图标（🔀）自动生成安全令牌
    • 或输入你自己的自定义令牌（3-32 个字母数字字符）
    • 此令牌为 Webhook 验证增加额外安全性
  2. 保存配置：
    • 点击”保存”按钮存储你的设置
    • 所有字段都将被保存，集成将准备就绪
保存微信配置

​
步骤 3：设置 Webhook URL

最后一步是配置 Webhook URL，以便微信可以向你的 Pathors 助手发送消息。

​
从 Pathors 复制 Webhook URL

  1. 找到 Webhook 部分：
    • 在 Pathors 中向下滚动到”Webhook 设置”部分
    • 你会看到一个自动生成的 Webhook URL
    • 点击复制按钮复制此 URL
从 Pathors 复制 Webhook URL

​
在微信平台中配置服务器设置

  1. 返回微信平台：
  2. 找到服务器配置部分：
    • 寻找”服务器配置”部分
    • 如需要，点击”修改配置”
  3. 输入服务器详情：
    • 服务器地址(URL)：粘贴你从 Pathors 复制的 Webhook URL
    • 令牌(Token)：输入你在 Pathors 中配置的相同令牌（如果你设置了的话）
    • 消息加解密密钥(EncodingAESKey)：你可以生成一个或留空以使用明文模式
    • 消息加解密方式：为简单起见选择”明文模式”
  4. 提交并启用：
    • 点击”提交”保存服务器配置
    • 微信将通过发送测试请求来验证 Webhook URL
    • 如果验证成功，点击”启用”激活服务器配置

验证过程： 微信会向你的 Webhook URL 发送 GET 请求以验证其正常工作。Pathors 会自动处理此验证。

​
步骤 4：测试你的微信集成

一旦一切都配置完成，就是测试你的微信机器人的时候了！
  1. 找到你的公众号：
    • 使用微信手机应用扫描你公众号的二维码
    • 或在微信中搜索你的公众号名称
  2. 关注并测试：
    • 关注/订阅你的公众号
    • 发送消息开始与你的 Pathors AI 助手聊天
    • 助手应根据你配置的工作流程做出响应
  3. 验证集成：
    • 检查消息是否出现在你的 Pathors 会话历史中
    • 确认响应正在发送回微信
    • 测试不同类型的消息（文本、图像如果支持的话）

​
重要提示

  • AppID 格式：AppID 应以”wx”开头，后跟 16 位十六进制字符（例如：wx1234567890abcdef）
  • AppSecret 格式：AppSecret 应为 32 位十六进制字符（例如：1234567890abcdef1234567890abcdef）
  • 安全性：请妥善保管你的 AppSecret，不要公开分享
  • 启用顺序：必须先启用集成开关，然后才能输入和保存凭证
  • 令牌要求：令牌是可选的，但建议用于 Webhook 安全验证
  • 自动菜单：Pathors 会自动管理你公众号的微信菜单

​
微信平台配置步骤

在微信公众平台中配置 Webhook URL 涉及以下步骤：
  1. 登录微信公众平台
  2. 前往开发 → 基本配置
  3. 在服务器配置部分，输入来自 Pathors 的 Webhook URL
  4. 输入与 Pathors 中使用的相同令牌（如果已配置）
  5. 选择适当的消息加密设置
  6. 提交并启用服务器配置

​
常见问题

​
问：为什么我无法保存 AppID 和 AppSecret？

答：请确保你已启用微信集成开关（右上角的开关按钮）。

​
问：凭证测试失败，应该怎么办？

答：请检查：
  • AppID 格式是否正确（以”wx”开头，后跟 16 位十六进制字符）
  • AppSecret 格式是否正确（32 位十六进制字符）
  • 凭证是否从微信公众平台正确复制
  • 你的公众号是否启用了开发者权限

​
问：微信平台中 Webhook URL 验证失败？

答：请确保：
  • 来自 Pathors 的 Webhook URL 在微信平台中正确输入
  • Pathors 和微信平台之间的令牌匹配（如果使用令牌验证）
  • 你的 Pathors 集成已启用且凭证已保存
  • 网络连接允许微信访问 Webhook URL

​
问：没有收到消息？

答：请验证：
  • 服务器配置在微信公众平台中已启用
  • Webhook URL 已正确配置和验证
  • 集成在 Pathors 中已启用且凭证有效
  • 用户已关注你的公众号

​
相关资源