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

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

Webhook 配置

1. 打开 Webhook 面板：
   • 登录您的 Fax.Plus 账户。
   • 前往设置下的集成部分。
   • 找到 Webhook 并点击管理。
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 地址：
   • 您可以验证收到的 webhook 是否来自我们授权的 IP 列表：
     • 52.215.16.239
     • 54.216.8.72
     • 63.33.109.123
     • 2a05:d028:17:8000::/56

故障排查与监控

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