必须通过Webhook打通WorkBuddy与Notion通信，因Notion不支持OAuth直连和API密钥管理；需依次完成：①Notion创建并配置Incoming Webhook端点；②WorkBuddy注册验证该URL并设Notion Signature校验；③配置JSON路径映射提取page_id、title、status字段；④在AI工作流中绑定Webhook触发器并设置page.created条件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让WorkBuddy自动同步任务到Notion数据库、响应页面更新或触发AI工作流，必须通过Webhook机制打通双方通信链路。Notion不提供OAuth 2.0直连入口，也不开放REST API密钥管理面板，所有外部写入都依赖开发者手动配置的Incoming Webhook端点——这一步漏掉或填错，后续所有AI动作都会静默失败。
第一步：在Notion中创建Webhook端点
打开Notion工作区 → 点击左下角「设置与成员」→ 选择「连接」→ 点击「+ 添加连接」→ 在搜索框输入「Webhooks」→ 点击「Incoming Webhook」卡片 → 点击「添加」。
系统自动生成一个唯一Webhook URL，形如https://api.notion.com/v1/webhook/xxxx-xxxx-xxxx-xxxx。该URL含一次性签名，【复制后立即失效，不可二次生成】。若误关页面，请删除当前Webhook并新建一个。
点击「配置」按钮，在弹出面板中勾选「允许来自此Webhook的请求」→ 下拉选择目标数据库（Database）→ 点击「保存」。
第二步：在WorkBuddy中注册并验证Webhook
启动WorkBuddy客户端 → 点击左下角头像 → 进入【Claw设置】→ 【集成中心】→ 【Webhook接收器】→ 点击【新增入口】。
填写名称（如“Notion任务同步”）、描述（可留空），在「Webhook URL」字段粘贴上一步复制的完整Notion链接。
关键操作：在「验证方式」下拉菜单中选择「Notion Signature」→ 系统将自动填充Header校验规则：Notion-Version: 2022-06-04 和 Content-Type: application/json。不要手动修改这两项，否则Notion会拒绝请求。
点击【测试连接】→ WorkBuddy向Notion发送一条空payload探测请求 → 若Notion返回HTTP 200且状态栏显示绿色对勾，表示通道已通；若返回400或超时，请检查URL是否含多余空格、是否被浏览器自动截断（尤其注意末尾换行符）。
第三步：定义Notion数据映射规则
在【Webhook接收器】列表中找到刚创建的条目 → 点击右侧「编辑」→ 进入「响应解析」标签页。
Notion Webhook推送的数据结构固定为JSON，顶层必含event对象，内含type（page.created/page.updated）、page_id、properties字段。你需要告诉WorkBuddy从哪提取关键信息：
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
在「JSON路径映射」区域添加三行：
page_id → 填写 $.event.page_id
title → 填写 $.event.properties.Name.title[0].plain_text（Notion标题字段名为Name，且为数组结构）
status → 填写 $.event.properties.Status.select.name（假设你建了一个Select类型的状态列）
每行映射后，右侧「示例值」会实时解析出对应字段内容。若显示null，请确认Notion数据库中该字段已存在且有值，【空字段或未命名列会导致整个映射失败】。
第四步：绑定AI工作流触发条件
打开WorkBuddy主界面 → 点击「新建任务」→ 选择「AI工作流」模板 → 拖入「Webhook触发器」节点 → 在配置面板中选择刚刚注册的Notion Webhook入口。
设置触发条件：点击「+ 添加条件」→ 选择「event.type」→ 运算符选「等于」→ 值填入page.created → 点击确认。
拖入「Notion读取页面」动作节点 → 在「Page ID」字段绑定上一步提取的page_id变量 → 配置完成后，该工作流将在每次Notion新建页面时自动运行。
点击右上角「发布」→ 工作流即刻启用。此时在Notion数据库中新建一页，WorkBuddy日志面板将实时显示触发记录和执行结果。
