文档

Webhook——概览与设置 Pro

Savebase Webhook 可将资料库连接到任意自动化工具,例如 Zapier、Make、Slack、Airtable、Discord 或自己的后端。每当帖子被保存、添加标签、删除或恢复时,Savebase 就向登记端点发送 HTTP POST。

Pro 功能

Webhook 适用于 Pro 和 Lifetime 方案。升级请前往 savebase.space/pricing.

概览

资料库发生事件时,Savebase 会向登记了该事件的所有已启用 Webhook 端点发送已签名 JSON 载荷。可登记多个端点,例如每项集成一个。

设置 Webhook

1

前往设置 → Webhook

前往 Dashboard → Settings → Webhooks.
2

点击“添加 Webhook”

输入端点 URL(必须为 HTTPS),可添加标签,并选择要订阅的事件。
3

复制签名密钥

创建 webhook 后,显示并复制 签名密钥。用它验证请求是否来自 Savebase。
4

测试端点

点击 发送测试事件 以立即发送示例载荷。

支持的事件

事件触发时机
post.saved资料库中新增一条帖子
post.tagged为帖子添加标签
post.deleted帖子被移入回收站
post.restored帖子从回收站恢复

载荷格式

所有事件均使用相同的 JSON 外层结构:

bash
{
  "event": "post.saved",
  "timestamp": "2026-03-11T12:00:00.000Z",
  "data": {
    "id": 123,
    "url": "https://x.com/user/status/...",
    "title": "Post title or null",
    "source": "x",
    "author_name": "username",
    "tags": ["design", "ai"],
    "saved_at": "2026-03-11T12:00:00.000Z"
  }
}

Zapier 集成

1

创建新的 Zap

在 Zapier 中点击 Create Zap 并搜索 Webhooks by Zapier 作为触发应用。
2

选择 Catch Hook

选择 Catch Hook。Zapier 会生成专属的 webhook 网址。
3

将 URL 登记到 Savebase

将 Zapier URL 复制到 Settings → Webhooks 并选择事件。
4

测试触发条件

保存帖子。Zapier 检测到载荷后,映射 data.url, data.title等信息添加到操作步骤中。
5

添加你的操作

连接任意 Zapier 操作,例如添加 Google Sheets 行、发送 Slack 消息、创建 Notion 页面或发布 Discord 消息。

Zapier 没有原生签名验证

在 Zapier 中添加 Filter 或 Code 步骤,以验证 X-Savebase-Signature 请求头,如果需要安全验证。

Make(Integromat)

1

创建新的场景

在 Make 中添加一个 Webhook → 自定义 Webhook 触发模块。
2

在 Savebase 注册

将 Make URL 复制到 Settings → Webhooks.
3

确定数据结构

在 Savebase 保存一条帖子,Make 会自动检测载荷结构。
4

创建你的场景

映射 data.url, data.source等字段传递给 Airtable、Notion 或电子邮件等下游模块。