开发者

Webhooks

您账户生成的每条通知均可作为已签名的 JSON POST 直接发送至您自己的系统——因此,您主机上发生的任何事情都可以在其他任何地方启动工作流。

所有开发者文档 →

您可以将其连接至的对象

Webhook 只是普通的 HTTPS 请求,因此任何能够接收该请求的系统都可以对其进行处理。您无需我们为您的工具构建集成。

自动化平台

将 Webhook 指向 n8n, Make, Zapier, Pipedream, Activepieces 中的工作流,每个事件都会成为一个触发器 — 发布到频道、创建工单、更新电子表格、调用其他 API。自托管平台的工作方式完全相同,只要可以通过 HTTPS 访问终端节点即可。

CRM 与服务台

将账单和账户事件发送到 HubSpot, Pipedrive, Salesforce,或发送到任何带有入站 Webhook 的服务台或 CRM,以便客户记录能够反映其托管服务的动态,而无需任何人手动复制。

正在侦听的其他任何项

Slack, Discord, Google Sheets, Airtable, Notion、您自己的监控系统、数据仓库,或是您编写的一个小脚本。只要它能接收 HTTPS POST 请求并读取 JSON,就可以接收这些内容。

发送的内容

您可以选择将哪些类别发送至哪个目标位置——并且您可以连接多个目标,从而使账单发送到一个位置,而网站提醒发送到另一个位置。默认情况下所有功能均处于开启状态。

账单与付款

已开具和已支付的发票、失败的付款、即将到期的卡片、续约及取消。

网站与安全

配置完成、站点被暂停、发现恶意软件、备份以及证书更改。

支持与域名

已开启和已升级的工单、域名转入、续费以及 DNS 更改。

证明请求来自我们

每个请求均使用仅您和我们持有的密钥进行签名。在对请求体执行操作之前,请先验证签名——每次交付都会随附这些标头:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

时间戳与正文一同进行签名,而不是在其旁单独发送,因此他人捕获的请求无法在稍后针对您进行重放。请拒绝任何超过几分钟的内容。

您的签名密钥仅在添加网络钩子时显示一次。我们无法再次显示该密钥 — 如果遗失,请移除该目标并重新添加。

正在设置

  1. 在您的控制面板中,打开“通知”并添加一个 Webhook 类型的目标。
  2. 向其提供您的 HTTPS 端点,并复制我们向您显示的签名密钥。
  3. 按 Test。我们发送格式与实际请求完全相同的真实请求,以便您在发生任何实际操作之前基于它进行构建。
  4. 选择该目的地应接收的类别。新类型的通知会自动开启。

您可以根据需要添加任意数量的目的地,将 Webhook 与电子邮件、Slack 和 Telegram 结合使用,并为每个目的地分配不同的类别集。

更希望通过电话联系我们?

Webhooks 会在事件发生时通知您。API 则是您触发操作的方式——控制面板执行的每一项操作您均可使用。

浏览 API 参考