WorkBuddy Notion Webhook入门配置教程：从零开始

要将WorkBuddy与Notion实现双向联动，唯一可靠的方案就是通过Webhook。Notion并未提供OAuth 2.0直接集成入口，也未开放API密钥管理面板——若需将任务写入数据库，必须使用开发者手动配置的Incoming Webhook端点。配置过程中任何字符错误或遗漏，都会导致后续所有AI操作静默失败，且不产生任何错误提示。

以下是四步完整流程，顺序不可颠倒。

第一步：在Notion中创建Webhook端点

进入Notion工作区后，点击左下角「设置与成员」，选择「连接」，再点击「+ 添加连接」。在弹出的搜索框中输入「Webhooks」，找到「Incoming Webhook」卡片，点击它，然后点击「添加」。

系统会立即生成唯一的Webhook URL，格式如：https://api.notion.com/v1/webhook/xxxx-xxxx-xxxx-xxxx。该地址包含一次性签名，复制后即失效，无法二次获取。如果误关闭页面，无法找回——需删除当前Webhook并重新创建。

获取URL后，点击「配置」按钮。在弹出的面板中勾选「允许来自此Webhook的请求」，下拉选择目标操作数据库（Database），最后点击「保存」。此时Notion端配置完成。

第二步：在WorkBuddy中注册并验证Webhook

启动WorkBuddy客户端，点击左下角头像进入【Claw设置】→ 【集成中心】→ 【Webhook接收器】。点击【新增入口】。

为入口命名，例如“Notion任务同步”，描述可选。关键步骤：将从Notion复制的完整URL粘贴到「Webhook URL」字段。

接下来，在「验证方式」下拉菜单中选择「Notion Signature」。系统自动填充Header校验规则：Notion-Version: 2024-06-04 和 Content-Type: application/json。这两个参数不可手动修改，否则Notion将拒绝请求。

完成配置后，点击【测试连接】。WorkBuddy会向Notion发送空payload探测请求。若Notion返回HTTP 200且状态栏显示绿色对勾，表示通道连通。若返回400或超时，请检查URL中是否存在多余空格，或浏览器是否自动截断了URL（尤其是末尾不可见换行符）。

第三步：定义Notion数据映射规则

返回【Webhook接收器】列表，找到刚创建的条目，点击右侧「编辑」，进入「响应解析」标签页。

Notion Webhook推送的数据为固定JSON结构，顶层包含event对象，其内包含type（例如page.created或page.updated）、page_id、properties等字段。需告知WorkBuddy从何处提取关键信息。

在「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日志面板会实时显示触发记录与执行结果——成功与否，一目了然。