# Webhooks API
SUMMARY: تسجيل استدعاءات HTTP لأحداث الذاكرة والدردشة والمهمة — احصل على إشعار عند تغيّر البيانات.

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
تتيح لك الـ Webhooks استقبال استدعاءات HTTP عند وقوع أحداث في Synapse. مثالية
لتشغيل الأتمتة الخارجية أو إرسال الإشعارات أو المزامنة مع أنظمة أخرى.
نقاط النهاية
POST /webhooks
تسجيل webhook جديد.
[CODE BLOCK]
الاستجابة:
[CODE BLOCK]
GET /webhooks
قائمة بجميع الـ webhooks للعقل الحالي.
[CODE BLOCK]
GET /webhooks/:id
الحصول على webhook واحد.
[CODE BLOCK]
PUT /webhooks/:id
تحديث webhook (URL، الأحداث، السر، أو علم التمكين).
[CODE BLOCK]
DELETE /webhooks/:id
حذف webhook.
[CODE BLOCK]
أنواع الأحداث
| النمط | يُطلق عندما |
|---------|------------|
|  | أي حدث ذاكرة |
|  | تخزين ذاكرة جديدة |
|  | تحديث ذاكرة |
|  | حذف ذاكرة |
|  | أي حدث دردشة |
|  | رسالة جديدة من الإنسان |
|  | أي حدث مهمة |
|  | إنشاء مهمة جديدة |
|  | تعليم مهمة كمنجزة |
|  | جميع الأحداث |
حمولة الـ Webhook
عند إطلاق حدث، يُرسل Synapse POST إلى عنوان URL الخاص بك:
[CODE BLOCK]
التحقق من التوقيع
إذا عيّنت ، يوقّع Synapse كل حمولة بـ HMAC-SHA256:
[CODE BLOCK]
تحقق في معالجك:
[CODE BLOCK]
النمط: المزامنة اللحظية
[CODE BLOCK]
الخطوات التالية
- Cron والمجدول
- دليل أتمتة الـ Webhooks