GetMyBot 知識庫

網路請求與 Webhook

讓網站事件啟動機器人,或讓反應向其他服務查詢資料;設定傳入與傳出的 HTTP 請求。

本頁內容

網站可以通知機器人有新申請;機器人也可以向網站查詢訂單狀態。這是兩個不同方向:

方向由誰開始例子
傳入 Webhook其他服務通知 GetMyBot 並啟動反應網站收到申請,機器人通知經理
傳出網路請求反應向其他服務查詢並取得回應機器人查詢價格或訂單狀態

Webhook 是服務之間自動傳送的通知。兩種方式都使用 HTTP。若需現成連接,請參閱整合。

傳入 Webhook(觸發條件)

**傳入網路請求(Webhook)**觸發條件會在外部 HTTP 請求到達時啟動反應:

  • 網址:啟用觸發條件並儲存反應後,GetMyBot 才會自動建立並顯示 Webhook URL。可複製,但不能修改。
  • 秘密權杖:防止其他人用該網址擅自啟動反應。
  • 方法:POST、GET、PUT 或 ANY。

收到的欄位會進入反應暫存資料 ctx。例如服務傳來 order_id,動作便可使用 {{ctx.order_id}}。設定後請傳送測試請求,確認反應取得正確欄位。

傳出網路請求(動作)

網路請求動作從反應中發送 HTTP 請求,可設定:

  • 方法:GET、HEAD、OPTIONS、POST、PUT、PATCH 或 DELETE;以及標頭和 JSON/文字內容。
  • 成功狀態碼、逾時與錯誤重試次數。
  • 將回應儲存到使用者參數或暫存 ctx;用 JSONPath 選取所需欄位。
  • 非同步執行:反應不必等候外部回應;之後可按成功/失敗啟動另一條反應。

相關動作還有載入 URL(把頁面文字放入 ctx),以及已儲存連接器的查詢資料來源/寫入資料來源;詳見資料來源與金鑰。

Webhook 整合

經常向同一服務傳送資料時,可設定 Webhook 整合,提供服務 URL 和 HMAC 簽章,讓接收端驗證來源。詳見整合。

安全性

傳入請求須設定秘密權杖。平台不允許傳出請求存取內部網路的私人網址,這項防護稱為 SSRF;回應大小亦受限制。

下一步