# Webhook 自動化
SUMMARY: メモリ変更時に外部システムをトリガー — 同期、通知、自動化。

Webhook 自動化
Webhook を使用すると、Synapse イベント発生時に外部システムをトリガーできます。本ガイドでは一般的な自動化パターンを説明します。
一般的なパターン
パターン 1：クリティカルメモリの通知
クリティカルメモリ保存時に Slack メッセージを送信します。
[CODE BLOCK]
Webhook を登録します。
[CODE BLOCK]
パターン 2：外部システムへの同期
メモリを Notion、Obsidian、その他の外部 KB に同期します。
[CODE BLOCK]
パターン 3：CI/CD のトリガー
「release」メモリ保存時にデプロイをトリガーします。
[CODE BLOCK]
パターン 4：人間メッセージでのエージェント起動
人間がチャットメッセージを送信したときに LLM エージェント実行をトリガーします。
[CODE BLOCK]
パターン 5：メトリクス集計
メモリ増加、チャット活動、タスク完了を追跡します。
[CODE BLOCK]
署名検証
なりすましを防ぐため、Webhook 署名を常に検証してください。
[CODE BLOCK]
再試行ロジック
Synapse は失敗した Webhook を指数バックオフで再試行します。ハンドラは以下を行うべきです。
1. 200 を素早く返す — 同期的に重い作業をしない
2. 作業をキューに入れる — バックグラウンドジョブシステムを使用
3. 冪等にする — 同じイベントが 2 回配信される可能性
[CODE BLOCK]
Webhook のデバッグ
配信履歴の確認
Webhook 配信はログに記録されます。Webhook の最近の配信を確認します。
[CODE BLOCK]
Webhook の手動テスト
[CODE BLOCK]
よくある問題
| 問題 | 修正 |
|-------|-----|
| 4xx レスポンス | ハンドラが 200 を返すか確認 |
| 5xx レスポンス | サーバーエラー — アプリログを確認 |
| タイムアウト | 200 を素早く返し、作業を非同期でキューに |
| 重複配信 | ハンドラを冪等にする |
| 署名不一致 | secret が正しいか確認 |
ベストプラクティス
> [!TIP]
> - 署名を常に検証 — 絶対にスキップしない
> - 200 を素早く返す — Synapse をブロックしない
> - 冪等にする — 重複配信を処理
> - 具体的なイベントを使用 —  ではなく 
> - 配信失敗を監視 — アラートを設定
次のステップ
- Webhooks API
- Cron & Scheduler
- Persistent LLM Agent