新功能:Webhook 已更新
Webhook 现已提供更完善的配置、投递日志、事件重放和签名验证功能。如果您在 2026 年 8 月 31 日之前配置过 webhook,您的端点仍可正常使用,但需要在 2027 年 1 月 15 日之前完成迁移。您可以按照迁移步骤操作。
通过 Webhook,您可以直接从 Fax.Plus 实时接收已发送和已接收传真的状态更新。配置 Webhook 后,您可以自动监控传真传输情况,并将状态更新集成到您现有的系统中。
开发者参考:如需了解完整的技术细节,包括事件类型、载荷结构和签名验证,请参阅Fax.Plus 关于 webhook 的 API 文档。
Webhook 配置
- 打开 Webhooks 面板:
- 登录您的 Fax.Plus 账户。
- 前往设置下的集成部分。
- 找到 Webhooks 并点击管理。
- 添加端点:
- 点击添加端点,然后输入您服务器上用于接收事件的绝对 URL。
- 选择要接收的事件。您可以订阅所有事件,也可以只从
事件目录中选择所需的事件。 -
可选:按传真号码筛选。关联一个或多个传真号码,即可只接收
这些号码的事件。
-
接收状态更新
- 配置完成后,每当传真状态
发生变化,Fax.Plus 都会向您指定的 URL 发送 webhook。 - webhook 载荷将包含传真 ID、状态、时间戳和
收件人信息等重要详情。
注意:如果 hook.id 不等于 data.id,则表示该传真正在重试。如果 hook.id 等于 data.id,则表示该传真是首次发送。
- 配置完成后,每当传真状态
- 验证签名
- 每创建一个端点,系统都会自动生成一个签名密钥,您可以用它来验证每个传入的请求。详细了解如何验证 webhook 签名。
- (可选)验证来源 IP 地址:
- 您可以验证收到的 webhook 是否来自我们的授权 IP 列表:
- 52.215.16.239
- 54.216.8.72
- 63.33.109.123
- 2a05:d028:17:8000::/56
- 您可以验证收到的 webhook 是否来自我们的授权 IP 列表:
故障排查与监控
- 日志与可观测性:在 webhook 面板中,您可以查看每个事件,以及其是否已成功送达。
- 重试:如果送达失败,webhook 会自动重试。
- 重放:您还可以在面板中手动触发重试,或在选定的时间窗口内重放任何过去的事件。