Notion Inbound Webhooks 实战：用外部事件直接触发工作流，告别轮询延迟

轮询触发的问题

Inbound Webhooks 是什么

• PR merge → 关闭对应 Notion Task
• 用户订阅变更 → 更新 CRM 数据库中的记录

配置步骤

前置条件：准备访问凭证

1. 进入 https://www.notion.com/my-integrations，创建 Internal Integration，获得以 ntn_ 开头的 bot token
2. 在目标数据库页面点右上角「···」→「Add connections」，把这个 Integration 加进去（不做这步，写入请求会 403）4

注册 Inbound Webhook 端点

1. 打开 Settings → Connections（Notion 3.5 统一了所有连接类型的管理入口3）
2. 切换到「Inbound Webhooks」标签，点击「New Webhook」
3. 填入来源系统名称，Notion 会生成一个唯一的 HTTPS 端点 URL（形如 https://api.notion.com/v1/webhooks/...），复制备用
4. 在同一配置页面，指定「接收到请求后执行哪个 Automations 工作流」——可以是已有的 Database Automation，也可以新建

在 n8n 中配置发送端

1. 在 n8n 创建一个新工作流，起始节点选 GitHub Trigger，事件选 pull_request，过滤 action = closed + merged = true
2. 添加 HTTP Request 节点，方式选 POST，URL 填入第二步复制的 Notion Webhook 端点
3. Headers 中加入 Authorization: Bearer <你的 Integration token 或 PAT>
4. Body 中传入你希望 Notion 工作流接收的 payload，例如：

{
  "pr_title": "{{ $json.pull_request.title }}",
  "pr_number": "{{ $json.pull_request.number }}",
  "repo": "{{ $json.repository.full_name }}"
}

5. 在 Notion 的 Automations 工作流中，引用 Webhook payload 里的字段（字段名由 Notion 界面配置时提示），匹配对应 Task 并将 Status 更新为「Done」

使用前要知道的限制

落地验证路径

1. 用 Webhook.site 先收一个 payload——Webhook.site 是一个免费的 HTTP 请求调试工具，可以生成临时 URL。在 n8n 的 HTTP Request 节点先把目标 URL 换成 Webhook.site 的临时地址，触发一次真实事件，确认 payload 字段结构符合预期后再换回 Notion 端点
2. 在测试数据库跑一条记录——触发一次真实 PR merge，观察 Notion 数据库中对应 Task 的状态是否即时变更，确认通路正常后再接入生产数据库