HTTP 請求節點
概述
HTTP 請求節點用於在 IVR 流程中調用外部 API 或 WebService，實現與後端系統的實時數據交互。支援 GET、POST、PUT、DELETE 等多種 HTTP 方法，可自定義請求頭和參數，並對回應進行處理。
功能說明
支援與外部系統的多種集成方式，包括查詢業務數據、創建記錄、更新信息、刪除數據等操作。支援自定義請求頭、請求參數、回應參數解析和條件判斷。
設定參數
| 參數 | 說明 |
|---|---|
| 節點名稱（Node Name） | HTTP 請求節點的識別名稱 |
| 請求地址（Request Address） | API 的完整 URL，如 http://api.example.com/order |
| 請求頭（Request Header） | 自定義 HTTP 頭，如 Content-Type: application/json |
| 請求方法（Request Method） | 選擇 GET、POST、PUT、DELETE |
| 請求參數（Request Parameters） | JSON 格式的參數，如 |
| 回應參數（Response Parameters） | 指定從回應中提取的字段，存儲為流程變數 |
操作步驟
- 拖拉「HTTP 請求節點」到編輯區
- 雙擊打開配置面板
- 輸入 節點名稱，如「查詢訂單狀態」
- 輸入 請求地址，如
http://api.example.com/orders/getStatus - 選擇 請求方法，如「GET」
- 設定 請求頭：
- Name: Content-Type
- Value: application/json
- 設定 請求參數，如
{orderId: ${orderId}} - 設定 回應參數 以提取結果：
- returnCode、returnMessage、orderStatus 等
- 點擊 確認 保存
使用範例
查詢訂單狀態 API 調用：
- 節點名稱：「查詢訂單」
- 請求地址：http://87.crm.com.tw:9876/demo/getSpecialProcessFlag
- 請求方法：POST
- 請求頭：Content-Type: application/json
- 請求參數：
{orderId: ${inputOrderId}, customerId: ${customerId}} - 回應參數：
- orderStatus：訂單狀態
- estimatedDate：預計交期
創建客戶工單：
- 請求地址：http://ticket-system.company.com/api/v1/tickets
- 請求方法：POST
- 請求參數：
{customerName: ${customerName}, issue: ${issueDescription}} - 回應參數：ticketNumber（工單編號）
注意事項
重要提醒
- 確保 API 地址正確且網絡可達，建議在測試環境驗證
- 敏感參數（如密碼、Token）應使用加密傳輸或環境變數
- 設定合理的超時時間，避免 IVR 無限等待
- 確保回應 JSON 格式正確，否則參數解析會失敗
最佳實踐
- 在生產環境前充分測試 API 集成
- 為 API 調用配置重試機制和超時控制
- 使用有意義的變數名稱便於流程維護
- 定期監控 API 調用的成功率和性能
操作畫面參考
