# Tự động hóa Webhook
SUMMARY: Kích hoạt hệ thống bên ngoài khi bộ nhớ thay đổi — đồng bộ, thông báo, tự động hóa.

Tự động hóa Webhook
Webhook cho phép bạn kích hoạt hệ thống bên ngoài khi sự kiện Synapse kích
hoạt. Hướng dẫn này bao phủ mẫu tự động hóa phổ biến.
Mẫu phổ biến
Mẫu 1: Thông báo khi bộ nhớ Critical
Gửi tin nhắn Slack khi bộ nhớ critical được lưu:
[CODE BLOCK]
Đăng ký webhook:
[CODE BLOCK]
Mẫu 2: Đồng bộ với hệ thống bên ngoài
Đồng bộ bộ nhớ với Notion, Obsidian hoặc bất kỳ KB bên ngoài:
[CODE BLOCK]
Mẫu 3: Kích hoạt CI/CD
Kích hoạt triển khai khi một bộ nhớ "release" được lưu:
[CODE BLOCK]
Mẫu 4: Đánh thức Agent khi tin nhắn con người
Kích hoạt chạy LLM agent khi con người gửi tin nhắn chat:
[CODE BLOCK]
Mẫu 5: Tổng hợp chỉ số
Theo dõi tăng trưởng bộ nhớ, hoạt động chat, hoàn thành tác vụ:
[CODE BLOCK]
Xác minh chữ ký
Luôn xác minh chữ ký webhook để ngăn giả mạo:
[CODE BLOCK]
Logic thử lại
Synapse thử lại webhook thất bại với exponential backoff. Trình xử lý của bạn nên:
1. Trả 200 nhanh — không làm công việc nặng đồng bộ
2. Xếp hàng công việc — sử dụng hệ thống công việc nền
3. Idempotent — cùng sự kiện có thể được gửi hai lần
[CODE BLOCK]
Gỡ lỗi Webhook
Kiểm tra lịch sử gửi
Việc gửi webhook được ghi nhật ký. Kiểm tra gửi gần đây của webhook:
[CODE BLOCK]
Kiểm tra webhook thủ công
[CODE BLOCK]
Vấn đề phổ biến
| Vấn đề | Khắc phục |
|-------|-----|
| Phản hồi 4xx | Kiểm tra trình xử lý trả 200 |
| Phản hồi 5xx | Lỗi server — kiểm tra nhật ký ứng dụng |
| Timeout | Trả 200 nhanh, xếp hàng công việc async |
| Gửi trùng lặp | Làm trình xử lý idempotent |
| Chữ ký không khớp | Xác minh secret chính xác |
Thực hành tốt nhất
> [!TIP]
> - Luôn xác minh chữ ký — không bao giờ bỏ qua
> - Trả 200 nhanh — không chặn Synapse
> - Idempotent — xử lý gửi trùng lặp
> - Sử dụng sự kiện cụ thể —  không phải 
> - Giám sát gửi thất bại — thiết lập cảnh báo
Bước tiếp theo
- Webhooks API
- Cron & Scheduler
- LLM Agent cố định