概述
本教學將指導您如何在 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：測試您的微信整合
一旦一切都設定完成，就是測試您的微信機器人的時候了！-
找到您的公眾號：
- 使用微信手機應用程式掃描您公眾號的 QR 碼
- 或在微信中搜尋您的公眾號名稱
-
關注並測試：
- 關注/訂閱您的公眾號
- 傳送訊息開始與您的 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 中已啟用且憑證有效
- 使用者已關注您的公眾號