摘要
在 Wati 的 聊天機器人建立器 中，網路鉤子 (Webhooks) 允許您透過 GET 或 POST API 要求，在聊天機器人和外部應用程式之間即時發送和接收數據。此功能可啟用動態聊天機器人互動，例如取得使用者詳細資料、驗證數據或與第三方服務整合。注意： 網路鉤子 (Webhook) 功能僅在 專業 & 商業 計畫中可用。如果您正在使用標準計畫，可以建立並儲存包含網路鉤子的聊天機器人，但必須升級才能在 關鍵詞操作 或 預設操作 流程中使用它們。
說明
進階聊天機器人建立器僅提供於 專業 和 商業 計畫中。
如何在聊天機器人建立器中使用網路鉤子
1. 將網路鉤子新增到您的聊天機器人
開啟 Wati 聊天機器人建立器。
將 網路鉤子 (Webhook) 圖示拖放到聊天機器人工作流程中。
將其連結到相關的聊天機器人步驟。
2. 設定網路鉤子節點
URL 與方法
選擇 要求方法：
GET或POST。輸入外部 API 的 URL 端點。
透過使用 變數 按鈕插入變數，使 URL 變動態。範例：
https://webhook-wa-testing.clare.ai/123456789?name=####{{name}}
客製化標頭
標頭提供額外的要求詳細資料，例如內容類型或授權。
標頭是選用的，並且預設為 關閉。
標頭採用 鍵-值 格式。範例：
鍵 =
Content-Type值 =
application/json
客製化主體
要求主體包含傳送至外部 API 的數據。
主體是選用的 並且預設為 關閉。
它必須始終採用 JSON 格式。
設定您的測試變數
手動定義測試變數以模擬設定期間的 API 回應。
3. 測試網路鉤子要求
按一下 測試要求 以驗證 API 呼叫是否正確運作。
4. 將 API 回應儲存為變數
您可以將 API 回應儲存在 變數 或 自訂屬性 中。
如果 API 以 鍵-值 配對返回 JSON 回應，您可以提取和儲存特定值。範例： 從 API 回應儲存
"result": "success"：
json { "result": "success"}
在物件內儲存值
使用格式：
objectKey.keyName。範例：若要從以下回應儲存
QuoteId，請使用Result.QuoteId。
json { "Result": { "QuoteId": "xxxxx", "QuoteNumber": "xxxxxx", "PolicyNumber": null }, "MessageValidation": null, "QuoteReferrals": null}
在物件陣列中儲存值
使用格式：
$.[0].objectKey.keyName[0].value。範例：若要儲存
current_status，請使用$.[0].tracking_data.shipment_track[0].current_status。
json [ { "tracking_data": { "track_status": 1, "shipment_track": [ { "id": 1278937320, "current_status": "Delivered" } ] } }]
5. 使用回應路由
回應路由允許您根據回應狀態代碼 切分聊天機器人操作。
您可以根據 API 回應定義不同的聊天機器人流程。
透過整合 網路鉤子 (Webhooks)，您可以使用外部數據增強聊天機器人功能，自動化工作流程並動態改善使用者互動。
常見問題解答 (FAQs)
一般問題
1. 在 Wati 的聊天機器人建立器中，什麼是網路鉤子？
→ 網路鉤子是一種機制，可讓您的聊天機器人透過 GET 或 POST API 要求，向外部應用程式傳送並接收即時數據。這可啟用動態互動，例如取得使用者詳細資料、驗證數據或與第三方服務整合。
2. 誰可以在聊天機器人建立器中使用網路鉤子？
→ 網路鉤子功能僅適用於 專業&商業計畫。如果您使用標準計畫，可以建立並儲存包含網路鉤子的聊天機器人，但必須在使用 關鍵詞操作 或 預設操作 流程之前升級。
設定與設定
3. 如何將網路鉤子新增到我的聊天機器人？
→ 若要新增網路鉤子：
開啟 Wati 聊天機器人建立器。
將 網路鉤子 (Webhook) 圖示拖放到聊天機器人工作流程中。
將其連結到相關的聊天機器人步驟。
4. 網路鉤子提供哪些要求方法？
→ 您可以在以下項目中進行選擇：
GET：從外部來源擷取數據。
POST：將數據傳送至外部 API。
5. 我可以客製化網路鉤子要求 URL嗎？
→ 是的。您可以使用 變數 按鈕插入 變數 以使要求 URL 動態化。範例：https://webhook-wa-testing.clare.ai/123456789?name=####{{name}}
客製化網路鉤子
6. 如何將標頭新增到我的網路鉤子要求？
標頭是 選用的 且預設為關閉。
它們以 鍵-值 配對設定。範例：
鍵：
Content-Type值：
application/json
7. 如何客製化網路鉤子要求的主體？
主體 是選用的，並且預設為關閉。
它必須始終採用 JSON 格式。
8. 測試變數是什麼？為什麼我應該使用它們？
→ 測試變數可讓您在設定期間手動定義值以模擬 API 回應。這有助於確保在部署前網路鉤子設定正確。
處理 API 回應
9. 如何將 API 回應儲存為變數？
如果 API 回應為帶有鍵-值配對的 JSON 格式，您可以透過參考鍵來儲存值。範例： 若要儲存
"result": "success"，請使用：
json { "result": "success"}
進階功能
10. 什麼是回應路由？
→ 回應路由允許您根據回應狀態代碼切分聊天機器人操作。您可以根據 API 回應定義不同的聊天機器人流程。
11. 我可以根據 API 回應觸發不同的聊天機器人流程嗎？
→ 是的。透過設定回應路由，可以建立多個根據 API 狀態代碼或特定回應值激活的聊天機器人流程。