使用 Windows 版 WPS Webhook 觸發時,常見問題通常涉及回調 URL、驗證設定及請求格式;本常見問題頁面收錄了 3 個常見問題及術語表。
常見問題
我可以自訂回調 URL 嗎?
- 不可以。回調 URL 無法手動自訂。
- 回調 URL 由系統自動產生。
- 你可以按一下複製圖示取得完整 URL,並提供給外部系統。
我可以設定哪些請求內容?
- 你可以設定請求參數。
- 你可以設定請求標頭。
- 你可以設定請求主體類型及其內容。
- 建議使用 JSON 格式,讓外部系統可以按一致且可預期的結構傳送請求。
驗證方式和 IP 允許清單有甚麼作用?
- 驗證方式用於控制如何驗證傳入請求。
- IP 允許清單會限制哪些公網 IP 位址可以呼叫 webhook。
- 如果工作流程只供固定來源系統使用,請確認驗證設定及允許清單與預期的呼叫來源一致。
術語表
| 術語 | 定義 |
|---|---|
| Webhook | 一種透過 HTTP 回調接收外部事件的方式,讓自動化工作流程可在收到請求時啟動。 |
| 回調 URL | 由系統自動產生、供外部系統傳送 webhook 請求的 URL。 |
| 驗證方式 | 用於驗證傳入請求身分或存取方式的設定。 |
| IP 允許清單 | 獲准存取 webhook 的公網 IP 位址清單。 |
| 請求主體 | 請求中傳送的主要內容,會根據所選的主體類型而定。 |