Webhook 是一種 HTTPS 回呼函數，可允許傳送和接收的應用程式進行事件導向的簡單通訊，也就是 FedEx 和您的應用程式。使用 Webhook 可讓您以近乎即時的方式接收您想瞭解的事件更新。若要進一步瞭解 Webhook，請參閱「什麼是 Webhook？」。

Advanced Integrated Visibility Webhook 可提供從「標籤建立」到「已送達」等運送中貨件追蹤事件的即時推播，包括圖片送達證明。

客戶可設定 Webhook，選取適合其業務需求的查詢事件類別。例如：如果您打算使用「已送達」事件來觸發「包裹已送達」客戶通知，您可選擇「送達通知」並略過其他類別。如要檢視完整事件清單，請按一下這裡。

1.  建立 FedEx Developer Portal 使用者登入。
2.  在 FedEx Developer Portal 中，建立「組織」設定檔。
3. 在組織設定檔中新增符合條件的美國帳單和託運帳號。
4.  設定可接受 JSON 承載通知的 Webhook 接聽程式 (目的地/回呼 URL 和安全性權杖)。

我們提供兩種層級的協助：顧問諮詢和一般疑難排解說明。如需詳細資訊，請聯絡顧客服務部。

技術支援人員。

撥打：1.877.339.2774

支援時段為星期一至星期五上午 7 點至晚上 9 點，以及星期六上午 7 點至下午 3 點 (美國中部時間)。

請選取適用於 API 和 Webservice 的 option4。

若要使用 FedEx Webhook，您必須在建立 Webhook 時詳閱並接受 FedEx 開發人員授權合約。除了 FDPLA，貴公司還必須為新增至您組織的託運帳戶簽署使用者授權合約以及訂購單。

Webhook 目前僅供美國境內帳單及託運帳戶使用。

FedEx Webhook 會在每次傳送承載通知時，於標頭加上 HMAC 型 base64 加密 fdx 簽章。您可以依據承載和安全性權杖產生 HMAC 簽章，將該簽章與 fdx 簽章比對以驗證收到的承載，藉此承載。

如要測試傳回目的地 (回呼) 網址的追蹤資料類型，請使用「嘗試此 Webhook」功能傳送測試請求，這有助於在建立 Advanced Integrated Visibility Webhook 前，先驗證網址及處理 Webhook 模擬承載通知。

如需詳細資訊，請參閱開始使用指南。

Webhook 僅接受有效的 HTTPS 連線，此類連線可支援由知名憑證授權單位 (CA) 核發的有效 TLS (1.2 版和以上版本) 憑證。請勿在目的地 (回呼) URL 設定中使用 FedEx 網域名稱或 IP 位址。如需詳細資料，請參閱「最佳做法」一節。

如為追蹤號碼型 Webhook，請新增由 FedEx 保管或將於未來 24 小時內保管之貨件的追蹤號碼。

Webhook 重試功能會嘗試傳送失敗的 Webhook 訊息。FedEx 會保留資料，並嘗試每隔 5 分鐘重新傳送一次，共嘗試 3 次。

如果 FedEx 未在定義的時間範圍內收到成功回應，就會停止重新傳送該特定事件。但客戶可透過「Webhook 專案詳細資料」頁面的手動「重試」按鈕，請求過去 7 天遺漏的事件。如需詳細資料，請參閱「重試」一節。

使用者可設定 Webhook 來接收特定類別的查詢事件資料 (例如：託運、運輸中或例外狀況，或是遞送事件)。使用者亦可選擇接收每個事件的完整記錄，或有關最新事件的特定資料。如需詳細資料，請參閱「設定選項」一節。

客戶可將此新增至白名單：「nat.fxconnect.eastus2.heap-prod.fedex.io」

(透過 CIDR「20.65.16.22/31」)

請參閱「Advanced Integrated Visibility 狀態和狀態代碼」參考指南。

附註：FedEx 無法保證事件會按照其產生的順序傳送。

• 客戶可啟動新的 Webhook 建立程序，並將輸入的詳細資料儲存 90 天。
• 如果客戶無法在 90 天內將儲存的 Webhook 建立程序完成，則 Webhook 會遭到刪除，且在入口網站上也找不到任何中繼資料。
• 如果觸發 Webhook 建立程序，但 Webhook 建立失敗，則 Webhook 的狀態會變成失敗 (客戶可重新嘗試再次建立)。如果未採取任何動作，則任何失敗的 Webhook 會在 30 天後遭到刪除。
• 如果客戶成功完成 Webhook 建立程序：
  • Webhook 將會處於啟用狀態 (此時會進行貨件比對，並將資料傳送給客戶)
  • 您仍可在 90 天內於 FDP 中使用取消的 Webhook 中繼資料，但無法重新啟用。
  • 任何取消的 Webhook 會在 90 天後自動刪除。

若要取消 Webhook，請前往「我的專案」>「Webhook」，選取 Webhook，然後在選單或「編輯」畫面中選擇「取消」。取消後便無法復原，且在系統自動刪除前會保留 90 天供查看。按一下這裡以查看您 Webhook 專案的條款。

• 在每個組織設定檔中，您僅可建立最多 100 個 Webhook。
• 在每個帳號型 Webhook 中，您可新增最多 1000 個帳號。
• 如為查詢號碼型 Webhook，您可在每個請求中新增最多 1000 個查詢號碼。

您會收到 PII 資訊，例如寄件人姓名、寄件人地址、寄件人聯絡資訊、收件人姓名、收件人地址、收件人聯絡資訊、簽收證明 (SPOD) 圖片、GPS 座標，以及便利遞送選項 (CDO)。

請參閱我們的開始使用指南，以建立可透過追蹤號碼訂閱的 Webhook 專案。建立專案後，系統會自動將「Advanced Integrated Visibility Tracking Number Subscription」新增至專案。此 API 有 3 個端點：

1. 追蹤號碼關聯：使用此端點可觸發非同步工作，將一或多筆追蹤號碼與特定 Webhook 專案建立關聯。
2. 追蹤號碼工作狀態：使用此端點可取得非同步工作的狀態，或是所有已提交工作的狀態。
3. 追蹤號碼工作詳細資料：使用此端點可下載處於 COMPLETED 狀態之非同步工作的 JSON 報告。

如需詳細資料，請參閱我們的文件。

好的，現在您已充分瞭解 Webhook，請在入口網站中註冊 (即建立組織設定檔)，並參閱「開始使用指南」以開始使用 Webhook。

不是，FedEx Webhook 是一套結合文件記錄與範例的技術策略概要，您的 IT 支援人員可從中將眾多 FedEx 功能整合到內部系統。如需立即可用的解決方案，請參閱 FedEx 電商兼容解決方案。

以下為訂閱 Advanced Integrated Visibility Webhook 的兩種方式：

1. 使用者可透過訂閱 9 位數 FedEx 帳號，來訂閱查詢事件。使用者可主動監控所有進口和出口貨件，以及由該帳號付款的第三方貨件。
2. 追蹤號碼型 Webhook (使用者可透過 FedEx 追蹤號碼訂閱此 Webhook，並接收可在 FedEx.com 取得的相同資訊)。系統不會透過追蹤號碼 Webhook 傳送 PII (個人識別碼資訊)。

FedEx Ground、FedEx Ground Economy、FedEx Express 和 FedEx Freight (僅限 9 位數帳號) 貨件追蹤更新由 FedEx Advanced Integrated Visibility Webhook 提供技術支援。

請注意：

• FedEx Advanced Integrated Visibility Webhook 僅支援企業的 9 位數貨運帳戶。
• Webhook 僅支援 9 位數企業帳戶/可使用包裹的帳戶。企業帳戶可建立與所有 FedEx 營運公司 (包括 FedEx Express 和 FedEx Ground) 相關聯的貨件。
• 不支援僅建立用於零擔貨運 (LTL) 的 9 位數帳戶，您必須聯絡 FedEx 顧客支援，將僅限零擔貨運 (LTL) 帳戶連結至企業帳戶。