Notion 集成入门指南(nCalendar篇)
Notion 集成入门指南(nCalendar篇)
青萍叙事📌 背景
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️⃣ 克隆或复制模板页面
👉 点击打开模板页面：https://lusyoe.notion.site/1f89161fd46b805a8adce048ec2912d1
点击右上角 → 复制页面到你的 Notion可自定义字段名称或样式(名称和到期时间字段不要改)
PS：最新版 nCalendar 已支持 Notion 公共集成，无需手动复制模板，也无需配置内部集成！
教程文档：《nCalendar 第三方登录：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 这样的日历同步工具时，可以实现真正意义上的“内容驱动提醒系统”。
