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

哪些用户可以使用此功能?

适用于 Enterprise 套餐。

所有者和管理员可在网页版应用中使用。

新功能:Webhook 已更新 
Webhook 现已提供更完善的配置、投递日志、事件重放和签名验证功能。如果您在 2026 年 8 月 31 日之前配置过 webhook,您的端点仍可正常使用,但需要在 2027 年 1 月 15 日之前完成迁移。您可以按照迁移步骤操作。

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

开发者参考:如需了解完整的技术细节,包括事件类型、载荷结构和签名验证,请参阅Fax.Plus 关于 webhook 的 API 文档。

Webhook 配置

  1. 打开 Webhooks 面板:
    • 登录您的 Fax.Plus 账户。
    • 前往设置下的集成部分。
    • 找到 Webhooks 并点击管理。
  2. 添加端点:
    • 点击添加端点,然后输入您服务器上用于接收事件的绝对 URL。
    • 选择要接收的事件。您可以订阅所有事件,也可以只从
      事件目录中选择所需的事件。
    • 可选:按传真号码筛选。关联一个或多个传真号码,即可只接收
      这些号码的事件。
  3. 接收状态更新

    • 配置完成后,每当传真状态
      发生变化,Fax.Plus 都会向您指定的 URL 发送 webhook。
    • webhook 载荷将包含传真 ID、状态、时间戳和
      收件人信息等重要详情。

    注意:如果 hook.id 不等于 data.id,则表示该传真正在重试。如果 hook.id 等于 data.id,则表示该传真是首次发送。

  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 会自动重试。
  • 重放:您还可以在面板中手动触发重试,或在选定的时间窗口内重放任何过去的事件。
这篇文章有帮助吗?
1 人中有 0 人觉得有帮助
本部分的更多文章