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

# ويب هوك وارد

> أنشئ قناة ويب هوك وارد بمخطط ثابت لاستقبال رسائل وأنشئ محادثات في البريد الوارد من أنظمتك الخارجية.

**ويب هوك وارد** قناة في قائمة القنوات: نظامك الخارجي يُرسل طلبات إلى كرزون فتنشأ (أو تُفتح) محادثة في البريد الوارد مع عميل. ليست مشغّل أتمتة عاماً يستقبل أي JSON، وليست ويب هوك المطوّر الصادرة من المنصة.

في الإضافة: **ويب هوك وارد** · `/channels?add=webhook`.

## وضّح الحدود أولاً

| هذا                                  | ليس هذا                                                                                             |
| ------------------------------------ | --------------------------------------------------------------------------------------------------- |
| قناة وارد لمحادثات العملاء           | مشغّل أتمتة «عند وصول ويب هوك» لأي جسم                                                              |
| مخطط حقول معروف (محتوى، عميل، شركة…) | استقبال حر بلا شكل                                                                                  |
| بديل لربط نظام داخلي/CRM بسيط        | بديل عن [طلب HTTP](/ar/help-center/guides/automations/nodes/actions/http-request) الصادر من الأتمتة |
| تكامل تشغيل للفريق                   | مرجع مطوّر GraphQL الكامل                                                                           |

إن احتجت المنصة أن **تستدعي** نظاماً خارجياً: ابنِ ذلك داخل مسار أتمتة بطلب HTTP. إن احتجت تطبيق متجر جاهز: راجع [التطبيقات](/ar/help-center/guides/automations/apps/overview).

## التعريف والأثر

|                    |                                                               |
| ------------------ | ------------------------------------------------------------- |
| **المعنى**         | تكامل `webhook` بعنوان استقبال ورمز/أصل للتحقق                |
| **متى تظهر رسالة** | عند `POST` ناجح يتضمن محتوى رسالة وفق المخطط                  |
| **الاستخدام**      | نماذج داخلية، أنظمة تذاكر قديمة، جسور مخصصة                   |
| **متى لا**         | تريد فلو أتمتة يبدأ من حدث عشوائي بلا محادثة — هذا ليس المكان |
| **الأثر**          | محادثة في الوارد يمكن للفريق الرد عليها كقناة عادية           |

## الإنشاء

<Steps>
  <Step title="افتح إنشاء ويب هوك">
    **القنوات** ← **إنشاء جديد** ← **ويب هوك وارد**.
  </Step>

  <Step title="عبّئ النموذج">
    * **الاسم** (مطلوب، 2–100 حرفاً)
    * **الرمز المميز** (اختياري — يُولَّد إن تُرك فارغاً)
    * **المصدر / Origin** (اختياري — تقييد بالمصدر)
    * **السكريبت** (اختياري — تحويل بسيط للبيانات قبل المعالجة)
    * **القسم** (مطلوب)
  </Step>

  <Step title="احفظ وانسخ بيانات الاستدعاء">
    بعد الإنشاء استخدم معرّف القناة والرمز في نظامك. الطلب يذهب إلى مسار الاستقبال الخاص بالتكامل.
  </Step>

  <Step title="أرسل حمولة تجريبية">
    أرسل `content` مع بيانات عميل بسيطة وتأكد من ظهور المحادثة في البريد الوارد.
  </Step>
</Steps>

<Info>
  **وسائط مطلوبة:** نافذة إنشاء ويب هوك بالحقول الاسم والرمز والقسم.\
  المسار المقترح: `/images/help/channels/incoming-webhook-wizard.webp`
</Info>

## المخطط الثابت (ما يهم المشغّل)

جسم الطلب يدعم حقولاً محددة — أهمها للتشغيل:

| الحقل                                                                                  | الدور                                                   |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| **content**                                                                            | نص الرسالة؛ بدونه لا تُنشأ رسالة محادثة بالمسار المعتاد |
| **customerFirstName / LastName / PrimaryEmail / PrimaryPhone / Code / Avatar / State** | إنشاء أو تحديث جهة الاتصال                              |
| **customFields** أو **data**                                                           | حقول مخصصة للعميل                                       |
| **attachments**                                                                        | مرفقات مرتبطة بالرسالة                                  |
| **formContent**                                                                        | عندما تكون الرسالة من نوع نموذج                         |
| **company…**                                                                           | ربط أو إنشاء شركة اختيارياً                             |

التحقق: يجب أن يمرّر الطلب قيمة تطابق **الرمز** أو **الأصل** المعرّفين على القناة (حسب ما ضبطت). هناك أيضاً حماية تكرار قصيرة لنفس المحتوى والعميل — لا ترسل نفس التجربة مرات متتالية وتتوقع محادثات جديدة فورية.

<Warning>
  الرد الآلي للبوت **غير مدعوم** على قناة ويب هوك وارد في المسار الحالي. صمّم التسليم للفريق البشري أو عالج المنطق في نظامك قبل الإرسال.
</Warning>

## بعد الإنشاء

| إجراء             | أين                                                             |
| ----------------- | --------------------------------------------------------------- |
| تعديل الاسم/القسم | `/channels/:id/edit`                                            |
| جلب البيانات      | من قائمة إجراءات القناة عند توفره                               |
| العمل على الرسائل | [البريد الوارد](/ar/help-center/guides/inbox/channels-in-inbox) |

للتوثيق البرمجي الأوسع (GraphQL، مفاتيح، ويب هوك مطوّر): تبويب المطوّرين — خارج مركز المساعدة التشغيلي.

## ذات صلة

* [نظرة عامة على الأتمتة](/ar/help-center/guides/automations/overview) — دقة الصادر مقابل الوارد
* [طلب HTTP](/ar/help-center/guides/automations/nodes/actions/http-request)
* [إضافة القنوات وإدارتها](/ar/help-center/guides/channels/add-and-manage)


## Related topics

- [نظرة عامة](/ar/help-center/guides/channels/overview.md)
- [إضافة القنوات وإدارتها](/ar/help-center/guides/channels/add-and-manage.md)
- [مرجع واجهة البرمجة](/ar/miniapps/reference/api-reference.md)
- [الويب هوك](/ar/miniapps/guides/webhooks.md)