Webhook是一個HTTPS回調函數，允許寄件人與收件人應用程式之間進行少量由事件主導的通訊。在此個案中，兩者即為FedEx和您的應用程式。使用Webhook能讓您近乎實時地接收有關您關注之事件的更新。如欲深入了解Webhook，敬請瀏覽「甚麼是Webhook？」

Advanced Integrated Visibility Webhook能實時推送運送中貨件查詢事件，範圍從「標籤建立」到「已送達」都有，並包括相片送達證明。

顧客可以配置 Webhook，以選擇符合其業務需求的查詢事件類別。例子：如您希望使用「已送達」事件來觸發「包裹已送達」顧客通知，則您可以選擇「送達通知」但略過其他類別。點擊此處以檢視所有事件清單。

1.  建立 FedEx Developer Portal 用戶登入資料。
2.  在 FedEx Developer Portal 上建立「組織」設定檔。
3.  新增符合資格的美國付款及託運帳號至組織設定檔。
4.  配置用於接受 JSON 數據通知的 Webhook 接聽程式 (目的地／回調網址及安全令牌)。

我們提供兩種不同程度的協助：諮詢及一般疑難排解。請聯絡顧客服務部以了解更多詳情。

技術支援部。

致電：1.877.339.2774

支援服務時間為星期一至五上午7時至晚上9時，以及星期六上午7時至下午3時(美國標準時間)。

為API和網絡服務選擇選項4。

如要使用FedEx webhook，在建立Webhook時，您必須閱讀並接受我們的《FedEx Developer Portal授權合約》。除FDPLA之外，貴公司亦必須為新增至組織的託運帳戶簽署《最終使用者授權合約》和《訂單表格》。

Webhook目前僅供位於美國的付款及託運帳戶使用。

FedEx Webhook會在每項數據通知的標題中，傳送基於HMAC的base64加密fdx-簽署。您可生成基於數據和安全令牌的HMAC簽署以驗證數據，將其與fdx-簽署進行比較，從而驗證所接收到的數據。

如要測試傳回至您的目的地(回調)網址的查詢數據類型，請使用「嘗試此Webhook」功能來傳送測試請求。這有助在建立Advanced Integrated Visibility Webhook前，先驗證您的網址和流程Webhook模擬數據通知。

詳情請參閱《入門指南》。

Webhook僅接受有效的HTTPS連接，該等連接支援由知名認證機構(CA)發出的有效TLS(版本1.2及以上版本)認證。請勿在目的地(回調)網址設置中使用FedEx域名或IP位址。詳情請參閱最佳做法部分。

如果Webhook是基於查詢號碼，請新增目前或未來24小時內由FedEx持有之貨件的查詢號碼。

Webhook重試是指嘗試傳送已失敗的Webhook訊息。FedEx將會保留資料，並嘗試在5分鐘內重新傳送3次。

如果FedEx在已定義的時間範圍內未收到成功回應，便會停止為該特定事件重新遞送。不過，顧客可透過Webhook項目的「詳細資訊」頁面上的手動「RETRY」(重試)按鈕，請求處理過去7天內錯過的事件。詳情請參閱「重試部分」。

用戶可以配置Webhook以接收指定類別的查詢事件數據(例如託運、運輸中、未能送達事故或遞送事件)。用戶亦可以選擇接收每個事件的完整歷史記錄，或者最新事件的指定數據。詳情請參閱配置選項部分。

客戶可將以下項目列入白名單：「nat.fxconnect.eastus2.heap-prod.fedex.io」

使用CIDR「20.65.16.22/31」

請參閱《Advanced Integrated Visibility狀態及狀態代碼》參考指南。

備註：恕不保證事件按照產生順序進行遞送。

• 顧客可以發起建立新的 Webhook ，並儲存所輸入的詳細資訊，有效期為 90 天。
• 如顧客未能在 90 天內完成建立已儲存的 Webhook，則該 Webhook 會被刪除 (平台不會提供任何後設資料)。
• 如觸發了 Webhook 建立流程，但 Webhook 建立失敗，則該 Webhook 將處於失敗狀態 (顧客可嘗試再次建立)。如未進行任何操作，任何失敗的 Webhook 會在 30 天後刪除。
• 如顧客順利完成建立 Webhook：
  • 該Webhook將處於活躍狀態(即可以配對貨件，並將數據傳送給顧客)
  • 已取消 Webhook 的後設資料仍可於 FDP 上查閱，有效期為 90 天，但該等 Webhook 無法重新啟用。
  • 任何已取消的 Webhook 會在 90 天後自動刪除。

如要取消Webhook，請前往「我的項目 > Webhook」，選擇「Webhook」，然後從「編輯」畫面的功能表中選擇「取消」。一經取消即無法復原，便可在自動刪除前維持90天可見。點擊此處以查看Webhook項目期限。

• 在每個組織設定檔中，僅可建立最多 100 個 Webhook。
• 每個基於帳號的 Webhook 可新增最多 1000 個帳號。
• 對於基於查詢號碼的 Webhook，每次請求可新增最多 1000 個查詢號碼。

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

請參閱我們的入門指南，以建立可透過查詢號碼訂閱的Webhook項目。項目一經建立，系統便會將「Advanced Integrated Visibility查詢號碼訂閱」自動新增至項目中。此API有3個端點：

1. 查詢號碼關聯 - 使用此端點來觸發非同步作業，將一個或多個查詢號碼關聯至特定的Webhook項目。
2. 查詢號碼作業狀態 - 使用此端點來取得非同步作業的狀態，或所有已提交作業的狀態。
3. 查詢號碼作業詳情 - 使用此端點來下載處於「COMPLETED」(已完成)狀態之非同步作業的JSON報告。

詳情請參閱我們的說明文件。

好了，現在您應已頗為了解Webhook，請在我們的平台上註冊(我們稱之為建立組織設定檔)，並參閱我們的入門指南以開始使用Webhook。

不是，FedEx Webhook是包含說明文件及示例的一組技術概要，讓您的IT支援人員可以將多種FedEx功能整合至內部系統中。如欲了解現貨方案，敬請瀏覽FedEx Compatible解決方案。

訂閱Advanced Integrated Visibility Webhook的方法有兩種：

1. 用戶可以訂閱 9 位數字的 FedEx 帳號，以訂閱查詢事件。用戶可以主動監察所有寄入和寄出貨件，以及由該帳號付款的第三方貨件。
2. 基於查詢號碼的Webhook，用戶可透過FedEx查詢號碼來訂閱，並接收與FedEx.com上所提供之資料相同的資料。PII(個人識別資料)不會透過查詢號碼Webhook傳送。

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。
• 不支援僅為託運拼箱裝運貨件託運而建立的9位數字帳戶，您必須聯絡FedEx顧客服務部，以向企業帳戶提供僅LTL的帳戶。