# Webhooks API
SUMMARY: ลงทะเบียน HTTP callback สำหรับ memory, chat และ task event — รับการแจ้งเตือนเมื่อข้อมูลเปลี่ยนแปลง

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 ช่วยให้คุณรับ HTTP callback เมื่อมี event เกิดขึ้นใน Synapse เหมาะสำหรับการทริกเกอร์ external automation, ส่งการแจ้งเตือน หรือ sync ไปยังระบบอื่น
Endpoints
POST /webhooks
ลงทะเบียน webhook ใหม่
[CODE BLOCK]
Response:
[CODE BLOCK]
GET /webhooks
รายการ webhook ทั้งหมดของ mind ปัจจุบัน
[CODE BLOCK]
GET /webhooks/:id
ดึง webhook เดียว
[CODE BLOCK]
PUT /webhooks/:id
อัปเดต webhook (URL, events, secret หรือ flag enabled)
[CODE BLOCK]
DELETE /webhooks/:id
ลบ webhook
[CODE BLOCK]
ประเภท Event
| Pattern | ทำงานเมื่อ |
|---------|------------|
|  | memory event ใด ๆ |
|  | เก็บ memory ใหม่ |
|  | อัปเดต memory |
|  | ลบ memory |
|  | chat event ใด ๆ |
|  | ข้อความใหม่จาก human |
|  | task event ใด ๆ |
|  | สร้าง task ใหม่ |
|  | ทำเครื่องหมาย task ว่าเสร็จ |
|  | ทุก event |
Webhook Payload
เมื่อ event ทำงาน Synapse POST ไปยัง URL ของคุณ:
[CODE BLOCK]
การตรวจสอบ Signature
หากคุณตั้ง  Synapse จะ sign payload แต่ละรายการด้วย HMAC-SHA256:
[CODE BLOCK]
ตรวจสอบใน handler ของคุณ:
[CODE BLOCK]
รูปแบบ: Real-Time Sync
[CODE BLOCK]
ขั้นตอนถัดไป
- Cron & Scheduler
- Webhook Automation Guide