> ## 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.

# كرزون ماسنجر

> أضف الدردشة المباشرة إلى موقعك: إنشاء القناة، إعداد الويدجت، التثبيت عبر بكسل كرزون، والذكاء الاصطناعي بحذر بين المتاح والاتجاه.

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

في نافذة الإضافة يظهر الاسم **الدردشة المباشرة**. في قائمة القنوات قد تظهر الشارة **ماسنجر**. في هذا المرجع نستخدم **كرزون ماسنجر** لكل الحديث التشغيلي.

## ما هو ولماذا تستخدمه؟

| السؤال           | الجواب                                                                      |
| ---------------- | --------------------------------------------------------------------------- |
| **ما معناه؟**    | تكامل من نوع `messenger`: أداة دردشة تُثبَّت على الموقع وتتصل بصندوق الفريق |
| **متى يظهر؟**    | بعد إنشائه وتثبيت السكربت؛ يظهر للزائر حسب إعدادات التوفر والسلوك           |
| **متى تستخدمه؟** | دعم فوري لزوار الموقع، تأهيل عملاء محتملين، ربط المحادثة بملف العميل        |
| **متى لا؟**      | إن كان عملاؤك على واتساب فقط ولا يزورون موقعاً — ابدأ بقناة أخرى            |
| **الأثر**        | محادثة موقع داخل نفس الوارد مع الوسوم والإسناد والأتمتة                     |

<Warning>
  المساحة الواحدة تسمح عادةً **بماسنجر واحد فقط**. إن فشلت الإضافة برسالة تكرار، عدّل الموجود بدل إنشاء ثانٍ.
</Warning>

## الإنشاء

<Steps>
  <Step title="من القنوات اختر الدردشة المباشرة">
    **البريد الوارد** ← **القنوات** ← **إنشاء جديد** ← **الدردشة المباشرة** ← **متابعة**.
  </Step>

  <Step title="سمِّ القناة وأنشئها">
    أدخل **اسم القناة** ثم **إنشاء القناة**. تظهر ملاحظة أن عنصراً سيُضمَّن في الموقع لاحقاً.
  </Step>

  <Step title="افتح تعديل الماسنجر">
    من قائمة القناة اختر **تعديل القناة** للانتقال إلى `/messenger/:id/edit` وإكمال المظهر والسلوك.
  </Step>
</Steps>

يوجد أيضاً مسار إنشاء أوسع عبر `/messenger/create` بخطوات كاملة ثم نافذة التثبيت. المسار اليومي للفرق هو الإضافة من قائمة القنوات ثم التعديل.

<Info>
  **وسائط مطلوبة:** خطوة إعداد الدردشة المباشرة داخل نافذة الإضافة + شاشة تعديل الماسنجر بخطواتها.\
  المسار المقترح: `/images/help/channels/messenger-create-and-edit.webp`
</Info>

## إعداد الويدجت

شاشة التعديل `/messenger/:id/edit` مقسومة إلى سبع خطوات — **بدون تبويب ذكاء اصطناعي داخل المظهر**:

| الخطوة              | ماذا تضبط                                                                                         |
| ------------------- | ------------------------------------------------------------------------------------------------- |
| **الإعداد**         | اسم التكامل، القسم، اللغة الافتراضية (العربية / English)                                          |
| **المظهر**          | اللون، نص، خلفية المحادثة، شعار — علامة تجارية فقط                                                |
| **التحيات والفريق** | الداعمون الظاهرون وروابط السوشيال والروابط الخارجية                                               |
| **الرسائل**         | نصوص التحية والترحيب والغياب والشكر لكل لغة                                                       |
| **التوفر**          | يدوي أو جدول ساعات، معدل الاستجابة، إخفاء الأداة عند عدم الاتصال                                  |
| **السلوك**          | طلب المصادقة، إظهار النافذة، زر المشغّل، إخطار العميل، تسجيل الخروج عند الحل، زر طلب مكالمة فيديو |
| **الإضافات**        | قاعدة المعرفة، نماذج العملاء المحتملين، تطبيقات مواقع                                             |

احفظ بعد التعديل. المعاينة على سطح المكتب تساعدك قبل النشر على الموقع.

| سلوك مهم                  | متى تستخدمه                         | متى لا                         |
| ------------------------- | ----------------------------------- | ------------------------------ |
| **طلب المصادقة**          | تريد هوية أوضح قبل بدء الحوار       | تجربة زائر سريعة بلا تسجيل     |
| **إخفاء عند عدم الاتصال** | لا تريد انتظاراً بلا فريق           | تعتمد على بوت خارج الدوام      |
| **زر طلب مكالمة فيديو**   | فريقك يستقبل طلبات فيديو من الويدجت | لا تملكون مساراً لمعالجة الطلب |

## التثبيت على الموقع

من قائمة القناة اختر **تثبيت الكود** (أو أكمل التثبيت بعد الإنشاء الكامل). النافذة تعرض:

1. **سكربت بكسل كرزون** — يفعّل الماسنجر (وغالباً البكسل) عبر `karzounSettings` وملف `p.js`.
2. **مفتاح مخصص (اختياري)** — مثل فتح الماسنجر برمجياً.
3. **بيانات العميل والشركة (اختياري)** — لتمرير هوية معروفة مسبقاً.
4. **معاينة** — للتأكد قبل اللصق على الموقع.

بديل لمن يملك صلاحية المطوّر: **مدير السكريبتات** (`/developer/script-manager`) لتجميع الماسنجر مع البكسل والنماذج وقاعدة المعرفة في مقتطف واحد. راجع أيضاً [تثبيت كرزون بكسل](/ar/help-center/guides/pixel/install).

<Tip>
  الصق السكربت على الصفحات التي تريد ظهور الأداة فيها، واختبر من نافذة خاصة (بدون كاش) بعد النشر. إن لم يظهر الويدجت: تأكد أن القناة نشطة، وأن `integrationId` يطابق قناتك، وأن السكربت لم يُحظر.
</Tip>

## الذكاء الاصطناعي في المحادثة

كرزون يراهن على أن ماسنجر الموقع يصبح محادثة مباشرة أغنى — نصية، وبمسارات أذكى مع الوقت. في التوثيق نفرّق بين **ما هو متاح للتشغيل اليوم** وبين **اتجاه المنتج** بلا وعد بتاريخ وبلا اختراع تبويب غير موجود في شاشة المظهر.

### متاح اليوم (LIVE)

| القدرة                        | أين تضبطها                                                             | ماذا تعني للفريق                                           |
| ----------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------- |
| **رد آلي للقناة**             | **الأتمتة** ← **الرد الآلي**                                           | مسار افتراضي وكلمات مفتاحية لماسنجر كرزون                  |
| **وكيل مساعد داخل مسار**      | عقدة [وكيل المساعد](/ar/help-center/guides/automations/nodes/ai-agent) | حوار أذكى داخل الأتمتة مع مخارج وتسليم بشري                |
| **معرفة ونماذج داخل الويدجت** | خطوة **الإضافات**                                                      | مقالات ونماذج تلتقط بيانات الزائر                          |
| **زر طلب مكالمة فيديو**       | خطوة **السلوك**                                                        | طلب من الزائر — ليس استوديو مكالمات كامل داخل إعداد المظهر |

### اتجاه / قيد تحسين (بحذر)

* محادثة صوتية أصلية داخل الويدجت (ميكروفون جاهز للزائر) **ليست** سطحاً مكتملاً في إعداد الماسنجر اليوم — لا تَعِد العملاء بها كزر ظاهر في المظهر.
* لا يوجد تبويب «ذكاء اصطناعي» ضمن خطوة **المظهر**؛ المظهر للعلامة البصرية فقط.
* مساعدات أوسع في البريد الوارد أو استوديو الوكلاء تُوثَّق في موجاتها الخاصة — لا تُخلط مع إعداد الويدجت.

| استخدم الذكاء هنا عندما…                | لا تعتمد عليه وحده عندما…                      |
| --------------------------------------- | ---------------------------------------------- |
| لديك مسار أتمتة منشور + تسليم بشري واضح | تحتاج وعداً تسويقياً بصوت فوري بلا مسار تشغيلي |
| تريد فرز الزوار قبل الفريق              | لم تضبط التوفر وساعات الفريق بعد               |

## الربط مع باقي المنصة

* الرسائل تصل إلى [البريد الوارد](/ar/help-center/guides/inbox/channels-in-inbox).
* حملات **الدردشة المباشرة** للزائر مشروحة في [حملة الدردشة المباشرة](/ar/help-center/guides/broadcasts/livechat).
* الرد الآلي: [إعداد الرد الآلي للقناة](/ar/help-center/guides/automations/channel-bots).

## ذات صلة

* [إضافة القنوات وإدارتها](/ar/help-center/guides/channels/add-and-manage)
* [تثبيت كرزون بكسل](/ar/help-center/guides/pixel/install)
* [حملة الدردشة المباشرة](/ar/help-center/guides/broadcasts/livechat)
* [عقدة: وكيل المساعد](/ar/help-center/guides/automations/nodes/ai-agent)


## Related topics

- [نظرة عامة](/ar/help-center/guides/channels/overview.md)
- [تثبيت كود التتبع](/ar/help-center/guides/pixel/install.md)
- [الدردشة المباشرة](/ar/help-center/guides/broadcasts/livechat.md)
- [إضافة القنوات وإدارتها](/ar/help-center/guides/channels/add-and-manage.md)