# Webhook 自动化
SUMMARY: 在记忆变化时触发外部系统 — 同步、通知、自动化。

Webhook 自动化
Webhook 让你在 Synapse 事件触发时启动外部系统。本指南涵盖常见自动化模式。
常见模式
模式 1：关键记忆通知
当存储关键记忆时发送 Slack 消息：
[CODE BLOCK]
注册 Webhook：
[CODE BLOCK]
模式 2：同步到外部系统
把记忆同步到 Notion、Obsidian 或任何外部知识库：
[CODE BLOCK]
模式 3：触发 CI/CD
当存储 “release” 记忆时触发部署：
[CODE BLOCK]
模式 4：人类消息唤醒 Agent
当人类发送聊天消息时触发 LLM Agent 运行：
[CODE BLOCK]
模式 5：聚合指标
跟踪记忆增长、聊天活动、任务完成：
[CODE BLOCK]
签名验证
始终验证 Webhook 签名以防伪造：
[CODE BLOCK]
重试逻辑
Synapse 会以指数退避重试失败的 Webhook。你的处理程序应该：
1. 快速返回 200 — 不要同步做重活
2. 排队处理 — 使用后台作业系统
3. 保持幂等 — 同一事件可能被投递多次
[CODE BLOCK]
调试 Webhook
检查投递历史
Webhook 投递会被记录。查看你的 Webhook 最近的投递：
[CODE BLOCK]
手动测试 Webhook
[CODE BLOCK]
常见问题
| 问题 | 修复 |
|-------|-----|
| 4xx 响应 | 检查处理程序是否返回 200 |
| 5xx 响应 | 服务器错误 — 查看你的应用日志 |
| 超时 | 快速返回 200，异步排队处理 |
| 重复投递 | 让处理程序幂等 |
| 签名不匹配 | 确认 secret 正确 |
最佳实践
> [!TIP]
> - 始终验证签名 — 绝不跳过这一步
> - 快速返回 200 — 不要阻塞 Synapse
> - 保持幂等 — 处理重复投递
> - 使用具体事件 —  而非 
> - 监控投递失败 — 设置告警
下一步
- Webhooks API
- Cron 与调度器
- 持久化 LLM Agent