需检查API连接、权限配置及触发条件：先在MuleRun授权Notion连接并获取Token，再配置Database Watcher监听变更，接着设置字段映射与格式转换，然后启用自动回写机制，最后通过日志、指标和权限逐层验证同步状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在mulerun中实时获取notion数据库的最新条目或字段变更，但数据未能自动同步，则可能是由于api连接未建立、权限配置缺失或触发条件未匹配。以下是实现mulerun与notion数据联动的具体操作步骤：一、在MuleRun中创建Notion连接并授权
建立安全、持久的API通道是同步的前提，MuleRun需通过Notion官方API密钥获得读写权限，该密钥必须具备目标数据库的访问范围。
1、登录MuleRun控制台，进入“Integrations”页面，点击“+ New Integration”。
2、在搜索框中输入“Notion”，选择官方Notion连接器。
3、点击“Connect Account”，系统跳转至Notion授权页；此时需确保已登录具有编辑权限的Notion账号。
4、勾选所需权限范围：至少包含Read content of pages and databases与Update content of pages and databases两项。
5、点击“Continue”，完成授权后，MuleRun将生成并保存一个加密的Integration Token，该Token不可见但已绑定至当前工作区。
二、配置实时监听数据库变更的Agent流程
利用MuleRun的事件驱动架构，可部署常驻Agent持续轮询Notion数据库的last_edited_time字段，或订阅官方Webhook（若启用），从而捕获新增、更新、删除动作。
1、在MuleRun中新建Agent，类型选择“Database Watcher”。
2、在“Source”配置项中，选择已授权的Notion连接，并指定目标数据库的完整URL或Database ID。
3、设置触发模式：选择Webhook (recommended if enabled in Notion)或Polling every 30 seconds（轮询间隔支持15s–300s自定义）。
4、定义变更过滤条件：例如仅监听“Status”字段由“To Do”变为“In Progress”的记录，或仅捕获“Created time”为当日的数据。
5、保存Agent后，点击“Activate”，状态灯变为绿色即表示监听已就绪。
三、构建双向数据映射与字段转换规则
Notion字段类型（如Relation、Rollup、Select）与MuleRun内部结构不完全兼容，需通过Schema Mapping明确源字段与目标字段的对应关系及格式处理逻辑。
1、在Agent编辑界面，进入“Data Mapping”标签页。
2、点击“Add Field Mapping”，左侧选择Notion数据库中的原始字段（如“Deadline”），右侧选择MuleRun目标对象的对应属性（如“due_date”）。
3、对Select/Multi-select字段，启用“Convert to array”选项以保留多选项结构；对Relation字段，勾选Resolve relation items recursively以展开关联条目的标题与关键属性。
4、对日期字段，设定时区转换规则，例如将Notion默认UTC时间自动转为Asia/Shanghai本地时间。
5、测试映射效果：点击“Preview Sync”，输入一条样例Notion记录ID，查看MuleRun解析后的JSON输出是否符合预期。
四、启用自动回写机制保持状态一致性
当MuleRun内业务逻辑修改数据后，需将结果反向同步至Notion，避免两端状态漂移；此过程依赖Page ID或唯一标识字段的精确匹配。
1、在Agent的“Actions”模块中，添加“Update Notion Page”操作节点。
2、设置匹配键：选择Notion中已存在的唯一标识字段（如“External ID”），并将其与MuleRun内记录的id字段绑定。
3、配置更新内容：勾选需回写的字段，例如将MuleRun计算出的“SLA Remaining Hours”数值写入Notion的Number类型字段。
4、启用冲突处理策略：选择“Skip if Notion last_edited_time > MuleRun update time”以防止覆盖人工编辑。
5、启用后，每次MuleRun完成内部处理，将在2秒内发起一次PATCH请求更新对应Notion页面。
五、验证同步状态与排查常见中断点
同步链路涉及网络、权限、配额、格式多重依赖，需逐层验证各环节是否处于健康状态，定位阻断位置。
1、在MuleRun Agent详情页，打开“Logs”面板，筛选关键词“Notion API 401”检查Token是否过期或权限失效。
2、查看“Metrics”图表，确认“Successful Syncs/Min”是否持续为零；若为零，检查Notion数据库是否被设为“Private”或共享链接未开启“Can edit”权限。
3、在Notion数据库属性栏中，确认用于匹配的字段（如“External ID”）已设为“Unique”且无空值，否则回写将失败并标记为“Unmatched”。
4、进入Notion Settings & Members → Integrations，核实MuleRun应用是否仍显示为“Active”，若显示“Revoked”，需重新执行授权流程。
5、对含Rollup或Formula字段的数据库，注意MuleRun仅同步其计算结果值，不触发Notion端的实时重算；如需强制刷新，须在Notion中手动编辑任一源字段。
