snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ar/developers/extend/capabilities/webhooks.mdx

@@ -0,0 +1,112 @@
+---
+title: الويب هوكس
+description: استقبل إشعارات في الوقت الفعلي عند وقوع أحداث في نظام إدارة علاقات العملاء (CRM) الخاص بك.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+تدفع خطافات الويب البيانات إلى أنظمتك في الوقت الفعلي عند وقوع أحداث في Twenty — دون الحاجة إلى الاستطلاع الدوري. استخدمها للحفاظ على تزامن الأنظمة الخارجية، وتشغيل الأتمتة، أو إرسال التنبيهات.
+
+## إنشاء ربط ويب
+
+1. انتقل إلى **الإعدادات → APIs & Webhooks → Webhooks**
+2. انقر على **+ إنشاء ربط ويب**
+3. أدخل عنوان URL لخطاف الويب الخاص بك (يجب أن يكون قابلاً للوصول علنًا)
+4. انقر على **حفظ**
+
+يتم تفعيل خطاف الويب فورًا ويبدأ في إرسال الإشعارات.
+
+<VimeoEmbed videoId="928786708" title="إنشاء خطاف ويب" />
+
+### إدارة Webhooks
+
+**تحرير**: انقر على خطاف الويب → تحديث عنوان URL → **حفظ**
+
+**حذف**: انقر على خطاف الويب → **حذف** → تأكيد
+
+## الأحداث
+
+يرسل Twenty خطافات الويب لأنواع الأحداث التالية:
+
+| حدث             | مثال                                                       |
+| --------------- | ---------------------------------------------------------- |
+| **إنشاء سجل**   | `person.created`, `company.created`, `note.created`        |
+| **تحديث السجل** | `person.updated`, `company.updated`, `opportunity.updated` |
+| **حذف السجل**   | `person.deleted`, `company.deleted`                        |
+
+يتم إرسال جميع أنواع الأحداث إلى عنوان URL لخطاف الويب الخاص بك. قد تتم إضافة تصفية الأحداث في الإصدارات المستقبلية.
+
+## تنسيق الحمولة
+
+يرسل كل خطاف ويب طلب HTTP من نوع POST يتضمن جسمًا بصيغة JSON:
+
+```json
+{
+  "event": "person.created",
+  "data": {
+    "id": "abc12345",
+    "firstName": "Alice",
+    "lastName": "Doe",
+    "email": "alice@example.com",
+    "createdAt": "2025-02-10T15:30:45Z",
+    "createdBy": "user_123"
+  },
+  "timestamp": "2025-02-10T15:30:50Z"
+}
+```
+
+| الحقل           | الوصف                                           |
+| --------------- | ----------------------------------------------- |
+| `حدث`           | ما الذي حدث (على سبيل المثال، `person.created`) |
+| `بيانات`        | السجل الكامل الذي تم إنشاؤه/تحديثه/حذفه         |
+| `الطابع الزمني` | وقت حدوث الحدث (UTC)                            |
+
+<Note>
+استجب بحالة **HTTP 2xx** ‏(200-299) لتأكيد الاستلام. تُسجَّل الاستجابات غير 2xx كإخفاقات في التسليم.
+</Note>
+
+## التحقق من صحة خطاف الويب
+
+يقوم Twenty بتوقيع كل طلب خطاف ويب لأغراض الأمان. تحقّق من التواقيع للتأكد من أن الطلبات أصيلة.
+
+### الرؤوس
+
+| رأس الصفحة                   | الوصف               |
+| ---------------------------- | ------------------- |
+| `X-Twenty-Webhook-Signature` | توقيع HMAC SHA256   |
+| `X-Twenty-Webhook-Timestamp` | الطابع الزمني للطلب |
+
+### خطوات التحقق
+
+1. احصل على الطابع الزمني من `X-Twenty-Webhook-Timestamp`
+2. أنشئ السلسلة: `{timestamp}:{JSON payload}`
+3. احسب HMAC SHA256 باستخدام سر خطاف الويب الخاص بك
+4. قارِن مع `X-Twenty-Webhook-Signature`
+
+### مثال (Node.js)
+
+```javascript
+const crypto = require("crypto");
+
+const timestamp = req.headers["x-twenty-webhook-timestamp"];
+const payload = JSON.stringify(req.body);
+const secret = "your-webhook-secret";
+
+const stringToSign = `${timestamp}:${payload}`;
+const expectedSignature = crypto
+  .createHmac("sha256", secret)
+  .update(stringToSign)
+  .digest("hex");
+
+const isValid = expectedSignature === req.headers["x-twenty-webhook-signature"];
+```
+
+## خطافات الويب مقابل سير العمل
+
+| طريقة                         | الاتجاه | حالة الاستخدام                                              |
+| ----------------------------- | ------- | ----------------------------------------------------------- |
+| **خطافات الويب**              | OUT     | إخطار الأنظمة الخارجية تلقائيًا بأي تغيير في السجل          |
+| **سير العمل + طلب HTTP**      | OUT     | إرسال البيانات إلى الخارج بمنطق مخصص (عوامل تصفية، تحويلات) |
+| **مشغّل خطاف ويب لسير العمل** | IN      | استقبال البيانات في Twenty من الأنظمة الخارجية              |
+
+لاستقبال البيانات الخارجية، راجع [إعداد مشغّل خطاف الويب](/l/ar/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger).