如何使用 Webhooks 检查已发送或已接收 fax 的状态？

通过 Webhooks，您可以直接从 Fax.Plus 实时接收关于您已发送和已接收 fax 的更新。通过配置 Webhooks，您可以自动监控 fax 传输状态，并将状态更新集成到您现有的系统中。

Webhooks 配置

1. 打开 Webhooks 面板：
   • 登录您的 Fax.Plus 账户。
   • 前往设置下的集成部分。
   • 找到 Webhooks，并点击管理。
2. 添加终结点：
   • 点击添加终结点，然后输入您服务器上用于接收事件的绝对 URL。
   • 选择要接收的事件。您可以订阅所有事件，或从
     事件目录中仅选择您需要的事件。
   • 可选：按 fax 号码进行筛选。关联一个或多个 fax 号码，即可仅接收
     这些号码的相关事件。

3. 接收状态更新

   • 配置完成后，只要 fax 状态发生变化，Fax.Plus 就会向您指定的 URL
     发送 Webhook。
   • Webhook 负载中将包含重要信息，例如 fax ID、状态、时间戳以及
     收件人信息。

   注意：如果 hook.id 与 data.id 不相等，则表示该 fax 正在被重新发送。如果 hook.id 与 data.id 相等，则表示该 fax 是首次发送。

4. 验证签名
   • 系统会为您创建的每个终结点自动生成一个签名密钥，您可以使用它来验证每个传入请求。了解更多关于验证 Webhook 签名的信息。
5. （可选）验证来源 IP 地址：
   • 您可以验证您收到的 Webhooks 是否来自我们的授权 IP 列表：
     • 52.215.16.239
     • 54.216.8.72
     • 63.33.109.123
     • 2a05:d028:17:8000::/56

故障排除与监控

• 日志与可观测性：在 Webhooks 面板中，您可以查看每个事件及其是否成功投递。
• 重试：如果投递失败，Webhooks 会自动重试。
• 重放：您还可以在面板中手动触发重试，或在选定的时间范围内重放任何历史事件。