Webhook 是一种 HTTPS 回调函数，能够在寄件人应用程序和收件人应用程序之间实现轻量级的事件驱动通信。在这里指的是 FedEx 和您的应用程序。使用 webhook，关于您想要了解的事件，您可以收到近乎实时的更新情况。要了解更多关于 webhook 的内容，请浏览什么是 webhook？

Advanced Integrated Visibility Webhook 可以实时推送在途货件查询事件，从“标签创建”到“已送达”都包含在内，其中也包括递送证明图片。

客户可以配置 Webhook 以选择适用于业务需求的查询事件类别。示例：如果您打算使用“已送达”事件来触发“包裹已送达”客户通知，可以选择“递送通知”但跳过其他类别。单击此处可查看所有事件的列表。

1.  创建 FedEx Developer Portal 用户登录。
2.  在 FedEx Developer Portal 上创建组织档案。
3.  将符合条件的美国账单账号和托运账号添加到组织档案中。
4.  配置 webhook 监听器（目的地/回调 URL 和安全令牌），用于接受 JSON 负载通知。

我们提供两种级别的协助：咨询和一般疑难解答帮助。请联系客户服务了解更多信息。

技术支持。

电话：1.877.339.2774

支持时间为星期一至星期五上午 7 点至晚上 9 点，星期六上午 7 点至下午 3 点（美国中部时间）。

对 API 和 Webservice 选择选项 4。

为了使用 FedEx webhook，在创建 webhook 时您必须阅读并接受我们的 FedEx Developer 许可协议。除了 FDPLA 外，贵公司还必须为添加到您组织中的托运账号履行最终用户许可协议和订购单。

Webhook 目前仅适用于美国的账单和托运账号。

FedEx Webhook 将在每个载重量通知的标题中发送基于 HMAC 的 base64 编码的 fdx 签名。您可以根据载重量和安全令牌生成 HMAC 签名，并将其与 fdx 签名进行比较，对收到的载重量进行验证。

如需测试返回到您的目的地（回调）URL 的查询数据类型，请通过“尝试此 webhook”功能发送测试请求。这有助于在创建 Advanced Integrated Visibility Webhook 之前验证您的 URL 并处理 webhook 模拟载重量通知 。

请参阅入门指南了解更多详情。

Webhook 只接受有效的 HTTPS 连接，此类连接可支持由知名认证机构 (CA) 签发的有效 TLS（1.2 及以上版本）证书。请勿在目的地（回调）URL 设置中使用 FedEx 域名或 IP 地址。请参阅最佳实践部分，了解更多详情。

有关基于查询号码的 webhook，请添加 FedEx 现已揽收或未来 24 小时内揽收的货件的查询号码。

Webhook 重试是指尝试发送已经失败的 webhook 消息。FedEx 将保留数据并尝试在 3 次重试（每隔 5 分钟一次）时段内重新发送数据。

如果 FedEx 在指定时间范围内没有收到成功的响应，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 将处于已启用状态（在此状态下进行货件匹配并将数据发送给客户）
  • 已取消 webhook 元数据在 FDP 上仍然可以使用 90 天，且不能重新激活。
  • 任何已取消 webhook 都将在 90 天后被自动删除。

要取消 Webhook，请转到我的项目 > Webhook，选择 Webhook，然后从菜单或编辑屏幕中选择取消。一旦取消，将无法恢复，并在自动删除前 90 天内可见。单击此处，查看 webhook 项目的条款。 

• 在每个组织档案中，您最多只能创建 100 个 webhook。
• 在每个基于账号的 webhook 中，您最多可以添加 1,000 个账号。
• 对于基于查询号码的 webhook，您最多可以在每个请求中添加 1,000 个查询号码。

您收到的 PII 信息包括寄件人名称、寄件人地址、寄件人联系信息、收件人名称、收件人地址、收件人联系信息、签名图像 (SPOD)、GPS 坐标和方便递送选项 (CDO)。

请参阅我们的开始使用指南，创建可通过查询号码订阅的 webhook 项目。创建项目后，“Advanced Integrated Visibility 查询号码订阅”将自动添加到项目中。该 API 有 3 个端点：

1. Tracking Number Association - 使用此端点可触发异步工作，将一个或多个查询号码与特定 webhook 项目关联。
2. Tracking Number Job Status - 使用此端点可获取异步工作的状态或所有已提交工作的状态。
3. Tracking Number Job Details - 使用此端点可下载处于已完成状态的异步工作的 JSON 报告。

有关详细信息，请参阅我们的文档。

很好，现在您已经详细了解了 webhook，请注册我们的门户（我们称之为创建组织档案）并参阅我们的入门指南，即可开始使用 webhook。

不是，FedEx webhook 是系统提供的一整套结合文档和示例的技术示意图，您的 IT 支持人员可选择将其中的众多 FedEx 功能合并到内部系统。有关现成解决方案的信息，请浏览 FedEx 兼容解决方案。

订阅 Advanced Integrated Visibility Webhook 有两种方法：

1. 要想订阅“查询事件”，用户可以订阅 9 位数 FedEx 账号。用户可以主动监控所有进口和出口货件以及向账号收费的第三方货件。
2. 基于查询号码的 webhook，用户可通过 FedEx 查询号码订阅该 webhook 并接收与 FedEx.com 所用信息相同的信息。个人识别码信息 (PII) 不是通过查询号码 webhook 发送的。

FedEx Advanced Integrated Visibility Webhook 支持查询以下货件的更新情况：FedEx Ground、FedEx Ground Economy、FedEx Express 和 FedEx Freight（仅限 9 位数的账号）货件。

注意：

• FedEx Advanced Integrated Visibility Webhook 仅支持 9 位数重货企业账号。
• Webhook 仅支持 9 位数的企业/包裹账号。企业账号允许创建与所有 FedEx 运营公司（包括 FedEx Express 和 FedEx Ground）关联的货件。
• 不支持仅为托运零担重货创建的 9 位数账号，您必须联系 FedEx 客户服务，将仅零担货运账号移植到企业账号。