「進階集成可見性Webhook」設置
概覽
透過「進階集成可見性webhook」，FedEx能夠將近乎實時的安全查詢事件數據推送至與一個或以上之FedEx帳號相關聯的貨件目的地網址。您可建立webhook項目，以透過FedEx Developer Portal存取此功能。
導覽路徑
您可透過下列其中一種方式，前往webhook建立頁面：
- 透過「我的項目」：左側導覽選單 → 「Webhook」索引標籤 → +建立Webhook項目
透過API目錄：
- 左側導覽選單 → API目錄
- 搜尋或篩選「進階集成可見性」
- 概覽 → 點擊「說明文件」→ 在「沙盒控制台」中，點擊「+建立項目」
- 文件 → 點擊+建立Webhook
Webhook建立步驟
第1步：選擇公司類型
點擊「+建立項目」，然後從下拉清單中選擇您的公司類型：
- 選用 FedEx 託運服務，並需要將FedEx webhook整合至公司系統中。
- 出售或提供使用FedEx數據的軟件解決方案，但公司不是獲認證的FedEx Compatible供應商。
- 是獲認證的FedEx Compatible供應商。
請注意：此選項目前不適用於FedEx「進階集成可見性webhook」解決方案。如果您是FedEx Compatible計劃的成員，並需存取「基礎集成可見性」或其他FedEx整合解決方案，請聯絡您的渠道經理。如果您不知道渠道經理是誰，請聯絡您的公司管理員。
然後選擇「進階集成可見性帳號訂閱」作為您的訂閱類型。
建立「進階集成可見性帳號訂閱」
此流程共有四個主要步驟：
- 設定項目
- 輸入項目詳情
- 選擇託運帳戶
- 確認詳情並接受條款
第1步：配置項目
在配置 Webhook 頁面上：
- 付款帳號
- 檢視預設付款帳戶。
- 如需更改：
- 點擊「新增付款帳戶至您的組織」（如只有一個帳戶），或者
- 點擊「選擇另一個付款帳戶」（如有多個帳戶）。
請注意：必須使用位於美國的付款帳戶。有關價格詳情，請參閱《「進階集成可見性」概覽價格指南》。
功能選擇：
- 選擇您想啟用的功能，然後點擊「下一步」。
功能說明
| 欄位名稱 | 說明 |
|---|---|
| 送達證明 | 確認貨件已成功送達。 送達證明圖像 (PPODA)：提供顯示實際遞送地點的相片。 簽收證明 (SPOD)：提供收件人的簽名圖像、姓名、送達日期、時間和地點。 |
| 預計送達 | 提供以下各項，協助收件人規劃安排： 預計送達日期 (EDD) 預計送達時間範圍 (EDTW) |
| 查詢事件 | 允許選擇一個或以上的事件類別，以接收通知： 託運 運送中 未能送達 事故 自訂遞送選項 |
| 以事件為基礎的篩選 | 篩選webhook回應，以包含： 進口貨件 出口貨件 第三方貨件 |
在「輸入詳情」頁面上，提供下列資訊：
| 欄位名稱 | 說明 |
|---|---|
| Webhook 項目名稱 | 為您的webhook項目輸入唯一且不可為空的名稱。系統會自動填入建議名稱，但您可自行編輯。此名稱不得在任何其他webhook中重複。 |
| 目的地 URL | FedEx將透過此安全HTTPS端點，傳送查詢事件數據。 要求： 必須為有效及可運作 必須遵循標準化語法 不得包含fedex.com或其子網域 可在多個webhook中重複使用 如需更多詳情，請參閱「業務規則和最佳做法」部分。 |
| 安全令牌 | 用於透過HMAC進行身份驗證及驗證webhook回應的共用密碼。 要求： 26至100個字元 必須包含至少1個大寫字母、1個小寫字母和1個數字字元 可在多個webhook中重複使用 |
| 數據語言 (國家／地區) | 從下拉清單選擇查詢數據翻譯的偏好語言。 |
| 查詢類型 | 選擇查詢數據的交付方式： 詳細查詢 — 完整事件記錄 事件特定查詢 — 僅限最近的事件 |
| 電郵地址 | 提供有效的電郵地址，以接收通知。 |
| 電郵語言（國家／地區） | 選擇電郵通知的偏好語言。 請注意：僅支援美國地區（例如en-US、es-US）。 |
第3步：選擇託運帳戶
在「選擇託運帳戶」頁面上：
- 選擇一個或以上的FedEx帳號，以與您的webhook項目相關聯。
重要備註：
- 頁面上僅會顯示尚未與其他webhook相關聯的帳戶。
- 您必須至少關聯一個帳戶，才可繼續。
- 您最多可透過webhook UI新增100個帳戶。
- 如需關聯超過100個帳戶，請使用webhooks API。
請聯絡FedEx顧客服務部或幫助櫃檯，以申請API存取權限。
第4步：確認詳情並建立
在「確認詳情」頁面上：
1. 檢閱您為webhook項目輸入的所有資料。
2. 剔選方格以接受條款及細則。
3. 點擊「建立」以完成webhook設置。
成功提交後，webhook將透過系統生成的訂閱ID來建立，並將設為「啟用中」狀態。
驗證規則
一般要求：
- Webhook名稱必須為唯一。
- 目的地網址必須遵循標準化句法格式（安全的HTTPS，不得使用fedex.com或其子網域）。
- 所有必填欄位均必須填寫 — 不得留空任何必填欄位。
- 至少必須有一個有效的FedEx託運帳號與webhook相關聯。
驗證成功：
成功建立webhook後，顧客將會收到一則確認訊息：
<<Webhook名稱>>已成功建立。變更最長可能需要10分鐘才能生效。
驗證不成功／失敗：
若FedEx從目的地網址收到HTTP 200（確定）或202（已接受）以外的任何回應，webhook驗證將視為失敗。
