Webhook 紀錄
目錄
一、使用情境
快速連結：貨主系統沒收到出貨通知 ｜ 對方主機恢復後補送通知
情境 1：貨主的訂單系統說沒收到出貨通知
狀況：貨主反映昨天出貨的訂單，他們的訂單系統還顯示未出貨，懷疑倉庫沒有通知。
用這個功能：用事件類型與時間篩出那段時間的訂單出貨推送，看傳送狀態與回應狀態碼，展開看對方實際回了什麼。
結果：分得出是倉庫沒推、推了但對方回錯誤，還是對方回成功卻沒處理——依據明確，不必再來回猜。
情境 2：對方主機維修一晚，恢復後要把漏掉的通知補上
狀況：貨主的接收主機昨晚停機維修，期間的推送都失敗了。主機恢復後，貨主希望不用等系統慢慢自動重試。
用這個功能：篩選傳送狀態為失敗或等待重試的推送，逐筆按「重試」。
結果：通知立即重新送出，列表上的傳送狀態會更新為最新結果。
二、功能介紹
貨主在「串接管理」設定 Webhook、或組織的串接憑證與 App 訂閱了事件後，訂單建立、出貨、取消、庫存變動等事件發生時，系統會主動推送通知到對方設定的網址。這一頁列出每一次推送的內容、對方的回應與重試狀況，是排查「對方沒收到通知」的第一站，也能就地重送失敗的推送。
2.1 搜尋與篩選
列表只會出現您被指派貨主的推送；頁首切換貨主時，列表跟著只看該貨主。搜尋框可輸入事件類型或目標網址的片段。
| 條件 | 用法 |
|---|---|
| 建立時間 | 預設釘選在篩選列 |
| 事件類型 | 只看某類事件，例如訂單出貨 |
| 傳送狀態 | 只看「傳送失敗」或「等待重試」的推送，找出需要處理的項目 |
從「Vanta Connect 串接」或「應用程式」頁按「查看投遞紀錄」進來時，列表只顯示那一條訂閱的推送，頂端會出現「目前只顯示單一訂閱的投遞紀錄。」，按「顯示全部」回到全部。這種單一訂閱的檢視還會列出該訂閱的測試推送：組織層級訂閱在「Vanta Connect 串接」頁按「測試投遞」或在「應用程式」頁按「測試投遞」送出的推送不屬於任何貨主，「貨主」欄顯示「-」，只在這個檢視出現，一般列表不會列出。
2.2 列表欄位
| 欄位 | 說明 |
|---|---|
| 貨主 | 這則事件屬於哪個貨主；組織層級訂閱的推送也標出事件所屬貨主 |
| 目標網址 | 這則事件原本要送往的網址 |
| 傳送狀態 | 「待推送」與「推送中」代表還在送；「傳送成功」代表對方回了 2xx；「等待重試」代表失敗後已排定下一次自動重試；「傳送失敗」代表 5 次自動重試都用完，不會再自動送 |
| 回應狀態碼 | 對方最後一次回的 HTTP 狀態碼 |
| 重試次數 | 已自動重試幾次。失敗後依序在 1 分鐘、5 分鐘、30 分鐘、2 小時、8 小時後重試 |
2.3 展開明細
點每列左側的「+」展開：左邊是送出的通知內容，右邊是對方最後一次的回應；下方「每次嘗試」列出每一次嘗試的時間、結果、當時送往的網址與對方回應，可分辨某次失敗是對方沒回應，還是送到了已作廢的舊網址。還在等待重試的推送會顯示下一次自動重試的時間。
2.4 重送
狀態為「傳送失敗」或「等待重試」的推送，操作欄會有「重試」：
- 前置條件：需要「系統日誌 - 編輯」權限；該 Webhook 必須是啟用中，停用的 Webhook 不會出現這顆按鈕。
- 效果：立即重新送出。「傳送失敗」的推送會重新開始一輪自動重試；「等待重試」的只是提早送出，已重試次數保留。不論手動或自動，都送往 Webhook 目前設定的網址。
- 可逆性：通知送出後無法收回；對方系統若未做重複判斷，可能會處理兩次。
三、常見問題
3.1 FAQ
▪ 為什麼某筆推送沒有「重試」？
已傳送成功、還在送的推送不需重送；所屬 Webhook 已停用（例如連續失敗 10 次被系統自動停用）時也不會出現。請先到該 Webhook 的設定頁重新啟用。若您沒有紀錄編輯權限，按鈕會顯示為鎖定。
▪ 為什麼看不到某個貨主的推送？
列表只顯示您被指派貨主的推送；也請確認頁首目前選的貨主。
▪ 改了 Webhook 網址，舊的失敗推送會送去哪？
送往目前設定的新網址。還在「等待重試」的會在下次自動重試時改送新網址；已經「傳送失敗」的不會再自動送，要手動按「重試」。
▪ 對方回了成功，卻說沒收到資料？
展開該筆看「請求內容」就是實際送出的內容；對方回 2xx 代表他們的系統已接收，請對方檢查自己的處理流程。
▪ 每次嘗試的區塊顯示「此筆推送早於逐次留存上線，沒有逐次嘗試紀錄」？
那是逐次留存功能上線前的舊推送，只保留最後一次的結果，沒有逐次紀錄。
▪ 推送紀錄保留多久？
約 2 個月，更早的紀錄會被清除。
3.2 注意事項
⚠️ 重要提醒
- 重送會把同一則通知再送一次，送出後無法收回；對方系統未防重複時會處理兩次。
- 「傳送失敗」的推送不會再自動重試，未手動重送就不會再送出。
💡 提示：對方主機停機一段時間後，先篩選「傳送失敗」與「等待重試」，確認對方已恢復再逐筆重送，避免重送後又失敗。
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| Vanta Connect 串接 | 設定組織層級串接的 Webhook 訂閱 | 前往 |
| Vanta Connect API 紀錄 | 查看外部系統呼叫 Vanta Connect API 的紀錄 | 前往 |
| 訂單詳情 | 在訂單的「串接紀錄」分頁查看與重送該訂單的推送 | 前往 |