{"title":"Webhooks API","slug":"webhooks","category":"api","summary":"मेमोरी, चैट, और कार्य घटनाओं के लिए HTTP कॉलबैक पंजीकृत करें — डेटा बदलने पर सूचित हों।","audience":["human","llm"],"tags":["api","webhooks","automation","events"],"difficulty":"intermediate","updated":"2026-06-27","word_count":223,"read_minutes":1,"llm_context":"Auth: Mind Key\nRegister: POST /webhooks { url, events, secret? }\nList: GET /webhooks\nGet: GET /webhooks/:id\nUpdate: PUT /webhooks/:id { url?, events?, secret?, enabled? }\nDelete: DELETE /webhooks/:id\nEvents: memory.*, memory.store, memory.update, memory.delete, chat.*, chat.message_received, task.*, task.created, task.completed\nSecret: HMAC-SHA256 signed payload, sent in X-Synapse-Signature header\nPattern: register webhook → receive POST → process event → call Synapse API\n","lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# Webhooks API\n\nWebhooks आपको Synapse में घटनाएँ होने पर HTTP कॉलबैक प्राप्त करने की सुविधा देते हैं। बाहरी ऑटोमेशन ट्रिगर करने, सूचनाएँ भेजने, या अन्य सिस्टम्स में सिंक करने के लिए आदर्श।\n\n## एंडपॉइंट्स\n\n### POST /webhooks\n\nनया webhook पंजीकृत करें।\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/webhooks \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"url\": \"https://my-app.com/webhook\",\n \"events\": \"memory.*\",\n \"secret\": \"my-hmac-secret-min-8-chars\"\n }'\n```\n\nप्रतिक्रिया:\n\n```json\n{\n \"id\": \"wh_001\",\n \"url\": \"https://my-app.com/webhook\",\n \"events\": [\"memory.*\"],\n \"enabled\": true,\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n### GET /webhooks\n\nवर्तमान mind के लिए सभी webhooks की सूची बनाएँ।\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/webhooks\n```\n\n### GET /webhooks/:id\n\nएकल webhook प्राप्त करें।\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/webhooks/wh_001\n```\n\n### PUT /webhooks/:id\n\nWebhook अपडेट करें (URL, events, secret, या enabled फ़्लैग)।\n\n```bash\ncurl -X PUT https://synapse.schaefer.zone/webhooks/wh_001 \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"enabled\": false}'\n```\n\n### DELETE /webhooks/:id\n\nWebhook हटाएँ।\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/webhooks/wh_001\n```\n\n## घटना प्रकार\n\n| पैटर्न | कब सक्रिय होता है |\n|---------|------------|\n| `memory.*` | कोई भी मेमोरी घटना |\n| `memory.store` | नई मेमोरी स्टोर की गई |\n| `memory.update` | मेमोरी अपडेट की गई |\n| `memory.delete` | मेमोरी हटाई गई |\n| `chat.*` | कोई भी चैट घटना |\n| `chat.message_received` | मानव से नया संदेश |\n| `task.*` | कोई भी कार्य घटना |\n| `task.created` | नया कार्य बनाया गया |\n| `task.completed` | कार्य पूर्ण चिह्नित किया गया |\n| `*` | सभी घटनाएँ |\n\n## Webhook Payload\n\nजब कोई घटना सक्रिय होती है, Synapse आपके URL पर POST करता है:\n\n```json\n{\n \"event\": \"memory.store\",\n \"timestamp\": \"2026-06-27T...\",\n \"mind_id\": \"m_xyz789\",\n \"data\": {\n \"id\": \"mem_001\",\n \"category\": \"fact\",\n \"key\": \"user_name\",\n \"content\": \"Michael Schäfer\"\n }\n}\n```\n\n## हस्ताक्षर सत्यापन\n\nयदि आप `secret` सेट करते हैं, तो Synapse प्रत्येक payload को HMAC-SHA256 के साथ हस्ताक्षरित करता है:\n\n```\nX-Synapse-Signature: sha256=\n```\n\nअपने हैंडलर में सत्यापित करें:\n\n```python\nimport hmac, hashlib\n\ndef verify_signature(payload_body: bytes, signature: str, secret: str) -> bool:\n expected = hmac.new(\n secret.encode(),\n payload_body,\n hashlib.sha256\n ).hexdigest()\n return hmac.compare_digest(f\"sha256={expected}\", signature)\n```\n\n## पैटर्न: रियल-टाइम सिंक\n\n```python\n# Your webhook handler\n@app.post(\"/webhook\")\nasync def handle_webhook(request):\n body = await request.body()\n signature = request.headers.get(\"X-Synapse-Signature\", \"\")\n if not verify_signature(body, signature, WEBHOOK_SECRET):\n return 401\n\n event = json.loads(body)\n if event[\"event\"] == \"memory.store\":\n # Sync to another system\n sync_to_external(event[\"data\"])\n elif event[\"event\"] == \"chat.message_received\":\n # Trigger agent wake-up\n notify_agent(event[\"data\"])\n```\n\n## अगले कदम\n\n- [Cron और Scheduler](/docs/api/cron)\n- [Webhook ऑटोमेशन गाइड](/docs/guides/webhook-automation)\n","content_html":"

Webhooks API

\n

Webhooks आपको Synapse में घटनाएँ होने पर HTTP कॉलबैक प्राप्त करने की सुविधा देते हैं। बाहरी ऑटोमेशन ट्रिगर करने, सूचनाएँ भेजने, या अन्य सिस्टम्स में सिंक करने के लिए आदर्श।

\n

एंडपॉइंट्स

\n

POST /webhooks

\n

नया webhook पंजीकृत करें।

\n

curl -X POST https://synapse.schaefer.zone/webhooks \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "url": "https://my-app.com/webhook",\n    "events": "memory.*",\n    "secret": "my-hmac-secret-min-8-chars"\n  }'

प्रतिक्रिया:

\n

{\n  "id": "wh_001",\n  "url": "https://my-app.com/webhook",\n  "events": ["memory.*"],\n  "enabled": true,\n  "created_at": "2026-06-27T..."\n}

GET /webhooks

\n

वर्तमान mind के लिए सभी webhooks की सूची बनाएँ।

\n

curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/webhooks

GET /webhooks/:id

\n

एकल webhook प्राप्त करें।

\n

curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/webhooks/wh_001

PUT /webhooks/:id

\n

Webhook अपडेट करें (URL, events, secret, या enabled फ़्लैग)।

\n

curl -X PUT https://synapse.schaefer.zone/webhooks/wh_001 \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"enabled": false}'

DELETE /webhooks/:id

\n

Webhook हटाएँ।

\n

curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/webhooks/wh_001

घटना प्रकार

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

पैटर्न	कब सक्रिय होता है
`memory.*`	कोई भी मेमोरी घटना
`memory.store`	नई मेमोरी स्टोर की गई
`memory.update`	मेमोरी अपडेट की गई
`memory.delete`	मेमोरी हटाई गई
`chat.*`	कोई भी चैट घटना
`chat.message_received`	मानव से नया संदेश
`task.*`	कोई भी कार्य घटना
`task.created`	नया कार्य बनाया गया
`task.completed`	कार्य पूर्ण चिह्नित किया गया
`*`	सभी घटनाएँ

\n

Webhook Payload

\n

जब कोई घटना सक्रिय होती है, Synapse आपके URL पर POST करता है:

\n

{\n  "event": "memory.store",\n  "timestamp": "2026-06-27T...",\n  "mind_id": "m_xyz789",\n  "data": {\n    "id": "mem_001",\n    "category": "fact",\n    "key": "user_name",\n    "content": "Michael Schäfer"\n  }\n}

हस्ताक्षर सत्यापन

\n

यदि आप secret सेट करते हैं, तो Synapse प्रत्येक payload को HMAC-SHA256 के साथ हस्ताक्षरित करता है:

\n

X-Synapse-Signature: sha256=<hex-hmac>

अपने हैंडलर में सत्यापित करें:

\n

import hmac, hashlib\n\ndef verify_signature(payload_body: bytes, signature: str, secret: str) -> bool:\n    expected = hmac.new(\n        secret.encode(),\n        payload_body,\n        hashlib.sha256\n    ).hexdigest()\n    return hmac.compare_digest(f"sha256={expected}", signature)

पैटर्न: रियल-टाइम सिंक

\n

# Your webhook handler\n@app.post("/webhook")\nasync def handle_webhook(request):\n    body = await request.body()\n    signature = request.headers.get("X-Synapse-Signature", "")\n    if not verify_signature(body, signature, WEBHOOK_SECRET):\n        return 401\n\n    event = json.loads(body)\n    if event["event"] == "memory.store":\n        # Sync to another system\n        sync_to_external(event["data"])\n    elif event["event"] == "chat.message_received":\n        # Trigger agent wake-up\n        notify_agent(event["data"])

अगले कदम

\n

\n","urls":{"html":"/docs/api/webhooks","text":"/docs/api/webhooks?format=text","json":"/docs/api/webhooks?format=json","llm":"/docs/api/webhooks?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}