# Webhook स्वचालन
SUMMARY: मेमोरी बदलने पर बाहरी सिस्टम्स को ट्रिगर करें — सिंक, सूचना, स्वचालन।

Webhook स्वचालन
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 रिस्पॉन्स | सर्वर त्रुटि — अपने ऐप लॉग जाँचें |
| Timeout | तेज़ी से 200 लौटाएँ, कार्य एसिंक कतारबद्ध करें |
| डुप्लिकेट डिलीवरी | हैंडलर को idempotent बनाएँ |
| सिग्नेचर मिसमैच | सत्यापित करें कि secret सही है |
सर्वोत्तम अभ्यास
> [!TIP]
> - हमेशा सिग्नेचर सत्यापित करें — इसे कभी न छोड़ें
> - तेज़ी से 200 लौटाएँ — Synapse को ब्लॉक न करें
> - Idempotent बनें — डुप्लिकेट डिलीवरी संभालें
> - विशिष्ट इवेंट्स का उपयोग करें — ,  नहीं
> - डिलीवरी विफलता मॉनिटर करें — अलर्टिंग सेटअप करें
अगले कदम
- Webhooks API
- Cron & Scheduler
- Persistent LLM Agent