​
概述

本教學將指導您如何在 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. 找到您的公眾號：
    • 使用微信手機應用程式掃描您公眾號的 QR 碼
    • 或在微信中搜尋您的公眾號名稱
  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 中已啟用且憑證有效
  • 使用者已關注您的公眾號

​
相關資源