> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> إرسال بيانات الأحداث في الوقت الفعلي إلى نقطة النهاية الخاصة بك.

الـ Webhooks هي الخيار العام لإدخال بيانات Scanova إلى أنظمتك الخاصة: اختر دفق بيانات، وأعطِ Scanova عنوان URL لنقطة نهاية، وستُرسل تلك البيانات بطلب POST إلى خادمك في الوقت الفعلي عند وقوع الأحداث — دون أي تطبيق من طرف ثالث بينهما.

## المتطلبات الأساسية

* نقطة نهاية HTTPS (أو HTTP) تقبل طلبات `POST` وتُعيد رمز حالة 2xx لتأكيد التسليم.
* إذا كنت تخطط لإرسال بيانات عملاء محتملين: قائمة عملاء محتملين واحدة على الأقل أو نموذج من Form-builder مُعدّ بالفعل كمصدر.

## إعداد Webhook

تفتح الـ Webhooks كصفحة كاملة خاصة بها (وليس لوحة جانبية).

<Steps>
  <Step title="فتح تكامل Webhooks">
    من **Integrations**، اختر **Add Integration**، ثم ابحث عن بطاقة **Webhooks** واختر **Setup**.
  </Step>

  <Step title="اختيار البيانات المراد إرسالها">
    اختر واحدًا من:

    * **Scan Analytics Data** — أحداث المسح لرموز QR الخاصة بك.
    * **Event Tracking Data** — بيانات تتبّع أحداث مخصصة.
    * **Lead List Data** — مرسلات النماذج أو قوائم العملاء المحتملين.
  </Step>

  <Step title="اختيار مصدر (Lead List Data فقط)">
    إذا اخترت **Lead List Data**، اختر أيضًا قائمة العملاء المحتملين أو نموذج Form-builder الذي ينبغي أن تأتي منه المرسلات.
  </Step>

  <Step title="إدخال عنوان URL لنقطة النهاية">
    أدخل عنوان URL الكامل بصيغة `https://` (أو `http://`) الذي ينبغي أن ترسل Scanova طلبات POST إليه. اختر **Add another URL** لإرسال الحمولة نفسها إلى ما يصل إلى 5 نقاط نهاية إجمالًا.
  </Step>

  <Step title="إنشاء الـ Webhook">
    اختر **Create webhook**. تبدأ Scanova بإرسال طلبات POST للأحداث المطابقة إلى كل عنوان URL هيّأته بمجرد وقوعها.
  </Step>
</Steps>

<Note>
  تُرسل Scanova حمولات الأحداث بطلبات POST إلى نقطة النهاية الخاصة بك في الوقت الفعلي. ينبغي أن تُعيد نقطة النهاية الخاصة بك استجابة 2xx لتأكيد التسليم — الاستجابة غير 2xx لا تُعيد المحاولة تلقائيًا.
</Note>

## تعديل Webhook موجود

فتح Webhook من **Active Connections** يعيد فتح النموذج نفسه، مُعبّأً مسبقًا. بما أن نموذج القراءة لا يعرض سوى عنوان URL واحد مُحلّل لكل اتصال، يعرض التعديل حقل عنوان URL واحدًا حتى لو كان الإعداد الأصلي يحتوي على أكثر من واحد.

## أين تذهب البيانات

حسب نوع البيانات المختار، تُرسل Scanova أحداث المسح، أو أحداث تتبّع الأحداث، أو مرسلات العملاء المحتملين/النماذج كحمولة JSON إلى كل عنوان URL لنقطة نهاية مُهيَّأ، بمجرد وقوع الحدث الأساسي.

## ذات صلة

* [Slack](/ar/integrations/slack) — تكامل مشابه مدفوع بالأحداث، مقصور تحديدًا على قنوات Slack.
* [Zapier](/ar/integrations/zapier) — يوجّه نفس نوع بيانات الأحداث عبر كتالوج تطبيقات Zapier بدلًا من عنوان URL خام.
* [Google Analytics (GA4)](/ar/integrations/google-analytics) — تكامل آخر لإخراج البيانات من جهة الخادم لبيانات المسح/الأحداث.
* [Management API overview](/ar/api-reference/management-api/overview) — اسحب البيانات نفسها وفق جدولك الزمني الخاص بدلًا من تلقي أحداث الدفع.