type
status
date
slug
summary
category
tags
create_time
May 25, 2025 09:07 AM
icon
password
my_create_time
📌 背景
Notion 不仅是一款强大的笔记和数据库工具,还是一款灵活的数字平台,越来越多开发者和团队希望将其与外部系统进行集成,实现自动化操作。
为了响应这一需求,Notion 官方提供了 Webhook 接口,让你的 Notion 页面能“听懂”变化并做出回应。
例如,我们开发的 nCalendar 工具,就利用了 Notion 的 API 和 Webhook 能力,将 Notion 模板数据库中的订阅信息自动同步到自建 CalDAV 服务,实现本地日历提醒功能。
Webhook 在这个流程中承担了“变化检测器”的角色,是自动化链条中不可或缺的一环。
无论是开发者、自动化爱好者,还是正在构建生产力工具的人,掌握 Notion Webhook 的使用方式都能显著提升效率。
📦 使用场景
- 📝 任务管理自动提醒:当任务状态从 “进行中” 变为 “已完成” 时,通过 Webhook 进行邮件。
- 📅 日程同步:数据库中新建带有日期的项目时,自动同步到本地或云端日历(例如 nCalendar)。
- 💬 客服自动分派:当用户提交 Notion 表单时,通过 Webhook 自动推送到客服系统。
- 🔄 与第三方系统集成:如 n8n、企业微信、nCalendar 等工具联动更新内容。
🛠️ 操作步骤详解
1️⃣ 准备工作
你需要以下资源:
- 注册 nCalendar 账号,作为接收 Webhook 的服务端,地址:https://ncalendar.lusyoe.com
- 一个启用了 API 权限的 Notion 集成(Integration)
- 对目标数据库或页面的编辑权限以及一套 nCalendar 模板
PS:稍后会介绍如何创建集成以及如何使用模板。
2️⃣ 克隆或复制模板页面
- 点击右上角 → 复制页面到你的 Notion
- 可自定义字段名称或样式(日期字段不要改)
3️⃣ 创建 Notion 集成
- 打开刚克隆或复制的 Notion 模板页面
- 点击右上角菜单 “…”
- 选择集成 → 管理连接

- 点击
开发或管理集成

- 点击
新集成

- 填写名称、选择模板所在的工作空间、类型为
内部
、上传logo(可选)

- 保存后点击进入配置集成页面
4️⃣ 配置 Notion + nCalendar 集成
打开集成的配置页面
- 首先显示内部集成密钥,然后拷贝到
nCalendar
的个人信息(Notion集成密钥)里面。
- 勾选功能权限,默认勾选上:读取内容、更新内容、插入内容。
- 然后别忘记点击右下方的
保存
。
PS:这一步是方便后续
nCalendar
自动读取页面内容的。

- 配置 Webhook 接口,在
nCalendar
的个人信息页面中复制API Key
(请点击后面的复制按钮,复制完整地址)

- 然后进入 Notion 集成的 Webhook 配置页面,点击
+创建订阅
,Webhook 网址直接粘贴刚复制的 API Key 完整地址,收听活动勾选:页面、数据库即可。

PS:完整 Webhook 地址格式应当为:https://ncalendar.lusyoe.com/api/webhook/notion?api_key=xxxxxx
- 由于 Notion 考虑到安全方面原因,创建完订阅后,还需要我们验证一下地址是否有效(只需要一次)
点击左下角的验证

- 填写 nCalendar 个人信息页面的 Notion 验证令牌,点击验证订阅
PS:此验证令牌会在您创建订阅后自动生成,也可以通过验证里面的重新发送令牌进行更新。


- 验证通过之后,可以看到会显示此订阅目前有效。

到这里我们的集成就可以使用了,别急还有最后一步,需要在我们的 Notion 模板里面配置使用集成。
5️⃣ 使用 nCalendar 集成
- 打开刚克隆或复制的 Notion 模板页面
- 点击右上角菜单 “…”
- 选择集成 → 找到我们刚创建的集成,选择即可

✅ 总结
通过 Notion 的 Webhook 接口,你可以将页面与数据库的变动实时传递到任意系统中,打通你的自动化链路。
尤其是在结合像 nCalendar 这样的日历同步工具时,可以实现真正意义上的“内容驱动提醒系统”。
有关文章的任何疑问,欢迎您在底部评论区留言,一起交流~
若您认可我的内容,欢迎 请我喝杯咖啡~
- 作者:lusyoe
- 链接:https://blog.lusyoe.com/article/notion-integration-guide
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。