# Webhooks API
SUMMARY: Đăng ký HTTP callback cho sự kiện bộ nhớ, chat và tác vụ — nhận thông báo khi dữ liệu thay đổi.

KEY CONTEXT:
Auth: Mind Key
Register: POST /webhooks { url, events, secret? }
List: GET /webhooks
Get: GET /webhooks/:id
Update: PUT /webhooks/:id { url?, events?, secret?, enabled? }
Delete: DELETE /webhooks/:id
Events: memory.*, memory.store, memory.update, memory.delete, chat.*, chat.message_received, task.*, task.created, task.completed
Secret: HMAC-SHA256 signed payload, sent in X-Synapse-Signature header
Pattern: register webhook → receive POST → process event → call Synapse API

Webhooks API
Webhook cho phép bạn nhận HTTP callback khi sự kiện xảy ra trong Synapse. Hoàn
hảo để kích hoạt tự động hóa bên ngoài, gửi thông báo hoặc đồng bộ với hệ thống
khác.
Các endpoint
POST /webhooks
Đăng ký webhook mới.
[CODE BLOCK]
Phản hồi:
[CODE BLOCK]
GET /webhooks
Liệt kê tất cả webhook cho mind hiện tại.
[CODE BLOCK]
GET /webhooks/:id
Lấy một webhook đơn lẻ.
[CODE BLOCK]
PUT /webhooks/:id
Cập nhật webhook (URL, sự kiện, secret hoặc cờ enabled).
[CODE BLOCK]
DELETE /webhooks/:id
Xóa một webhook.
[CODE BLOCK]
Loại sự kiện
| Mẫu | Kích hoạt khi |
|---------|------------|
|  | Bất kỳ sự kiện bộ nhớ nào |
|  | Bộ nhớ mới được lưu |
|  | Bộ nhớ được cập nhật |
|  | Bộ nhớ bị xóa |
|  | Bất kỳ sự kiện chat nào |
|  | Tin nhắn mới từ con người |
|  | Bất kỳ sự kiện tác vụ nào |
|  | Tác vụ mới được tạo |
|  | Tác vụ được đánh dấu đã xong |
|  | Tất cả sự kiện |
Payload Webhook
Khi sự kiện kích hoạt, Synapse POST đến URL của bạn:
[CODE BLOCK]
Xác minh chữ ký
Nếu bạn đặt , Synapse ký mỗi payload bằng HMAC-SHA256:
[CODE BLOCK]
Xác minh trong trình xử lý của bạn:
[CODE BLOCK]
Mẫu: Đồng bộ thời gian thực
[CODE BLOCK]
Bước tiếp theo
- Cron & Scheduler
- Hướng dẫn tự động hóa Webhook