开发者

Webhook

让您的系统了解工作区中发生的事情:所选事件的签名调用,带重试和日志。

事件

  • 合作伙伴: 创建、更新、删除、状态变更、等级变更、经理变更。
  • 付款方式: 创建、更新。
  • 表单请求: 创建、更新、删除。
  • 转化: 创建、更新、状态变更。
  • 结算和付款: 结算创建、付款状态变更。
  • 优惠: 创建、更新、删除;授予访问权限、撤销访问权限。
  • 回传: 失败。
  • 白标: 创建、更新、删除。

如何创建

  1. 设置 › 开发者 › Webhook › 新建 Webhook: 您的端点 URL 和事件。
  2. 仅在以下情况发送(可选):针对记录字段的规则,全部或任一满足,可与某个值、列表或其他字段比较。
  3. 发送什么: 兼容(现有集成期望的简短格式)或完整记录(每个字段,变更时附前后值)。示例会随您的选择更新。
  4. 如果端点需要,可添加额外的请求头。

校验签名

每次调用都带有 Signature 请求头:用 Webhook 的签名密钥对请求体计算的 HMAC-SHA256。密钥只在创建 Webhook 时显示一次;新密钥会替换它。

投递

  • 服务器响应不正常的调用会被重试。
  • 投递日志显示每次调用、每次尝试以及发送的内容;再次发送会重复该调用。
  • 发送测试会用您最近的真实记录(或示例)发送一个事件。
  • 连续失败 20 次后,Webhook 会自动暂停,并向您发送提醒。修复端点后,点击恢复。

已于 2026年10月18日 与应用核对