# أتمتة الـ Webhooks
SUMMARY: شغّل الأنظمة الخارجية عند تغير الذكريات — مزامنة، إشعارات، أتمتة.

أتمتة الـ Webhooks
تتيح لك الـ Webhooks تشغيل الأنظمة الخارجية عند إطلاق أحداث 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 محاولة الـ webhooks الفاشلة مع تراجع أُسي. يجب أن يفعل معالجك:
1. يُرجع 200 بسرعة — لا تفعل عملًا ثقيلًا تزامنيًا
2. أدرج العمل في الطابور — استخدم نظام مهام خلفي
3. كن idempotent — قد يُسلَّم نفس الحدث مرتين
[CODE BLOCK]
تصحيح الـ Webhooks
تحقق من سجل التسليم
تُسجَّل تسليمات الـ webhook. تحقق من التسليمات الحديثة لـ webhook الخاص بك:
[CODE BLOCK]
اختبر الـ webhook يدويًا
[CODE BLOCK]
مشكلات شائعة
| المشكلة | الإصلاح |
|-------|-----|
| استجابات 4xx | تحقق أن معالجك يُرجع 200 |
| استجابات 5xx | خطأ خادم — تحقق من سجلات تطبيقك |
| انتهاء المهلة | أرجع 200 بسرعة، أدرج العمل غير المتزامن |
| تسليمات مكررة | اجعل المعالج idempotent |
| عدم تطابق التوقيع | تحقق أن السر صحيح |
أفضل الممارسات
> [!TIP]
> - تحقق من التوقيعات دائمًا — لا تتخطى هذا أبدًا
> - أرجع 200 بسرعة — لا تحجب Synapse
> - كن idempotent — تعامل مع التسليمات المكررة
> - استخدم أحداثًا محددة —  لا 
> - راقب إخفاقات التسليم — أعد تنبيهًا
الخطوات التالية
- Webhooks API
- Cron والمجدول
- وكيل LLM الدائم