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

# أضف ودجت المحادثة إلى موقعك

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

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

لا يحتاج الزائر إلى تثبيت شيء ولا إلى حساب. يضغط الزر ويكتب.

## التشغيل

<Steps>
  <Step title="أنشئ القناة">
    **الإعدادات ← القنوات ← محادثة الموقع**. اكتب النطاق الذي سيعمل عليه الودجت —
    `acme.com` — ثم اضغط **إنشاء**.

    نسأل عن النطاق أولًا لأن قناة بلا نطاق لا تخدم أحدًا: يرفض الودجت العمل في أي مكان لم
    يُسمح له به. هذا هو الوضع الآمن، وهو أيضًا السبب الأكثر شيوعًا لعدم ظهور الودجت بعد لصق
    الكود مباشرة.
  </Step>

  <Step title="احفظ المفتاح السري للهوية">
    يظهر **مرة واحدة** عند الإنشاء ويبدأ بـ `wc_sec_`. لن تحتاجه إلا إذا كان زوارك مسجّلي
    الدخول — راجع [إذا كان زوارك مسجّلي الدخول](#signed-in-visitors) — لكن لا سبيل
    لقراءته لاحقًا، فاحفظه الآن أو دوّره عند الحاجة.
  </Step>

  <Step title="انسخ الكود إلى موقعك">
    سطر واحد قبل وسم `</body>` مباشرة، في كل صفحة تريد ظهور الزر فيها. تبويب **التثبيت**
    يعرض الكود الخاص بك مع المفتاح جاهزًا:

    ```html theme={null}
    <script
      src="https://social.linkiasoft.com/widget/v1/loader.js"
      data-website-id="wc_pub_7c8d9e0f1a2b"
      async
    ></script>
    ```
  </Step>

  <Step title="امنح القناة لدور">
    **الأدوار ← الدور ← القنوات**. القناة التي لا يملكها أي دور لا تصل محادثاتها إلى أحد.
    هذه الخطوة يغفل عنها الجميع في كل قناة، وهذه ليست استثناءً.
  </Step>

  <Step title="افتح موقعك وأرسل رسالة لنفسك">
    يظهر الزر أسفل يمين الصفحة. أرسل رسالة تجريبية وراقب وصولها إلى صندوق الوارد.
  </Step>
</Steps>

<Note>
  لا تفضّل تعديل شيفرة موقعك؟ لكل منصة مكان مخصص لهذا:

  * **ووردبريس** — المظهر ← محرر ملفات القالب ← `footer.php`، أو أي إضافة للأكواد المخصصة.
  * **شوبيفاي** — المتجر الإلكتروني ← القوالب ← تحرير الكود ← `theme.liquid` قبل `</body>`.
  * **ويبفلو** — إعدادات المشروع ← Custom code ← Footer code.
  * **ويكس / سكوير سبيس** — لوحة الأكواد المخصصة في إعدادات الموقع.

  أي خانة تطلب "كود التذييل" أو "كود قبل وسم body" هي الخانة الصحيحة.
</Note>

## النطاقات المسموح بها

**محادثة الموقع ← الإعدادات ← الأمان.** لا يعمل الودجت إلا على النطاقات المذكورة هناك.

| المُدخل      | يشمل                                                 |
| ------------ | ---------------------------------------------------- |
| `acme.com`   | `acme.com` و`www.acme.com`                           |
| `*.acme.com` | `shop.acme.com` و`shop.eu.acme.com` و`acme.com` نفسه |
| `localhost`  | أي خادم تطوير محلي، على أي منفذ                      |
| `*`          | كل المواقع — للتجربة فقط                             |

معرّف الموقع في الكود **علني** بطبيعته: هو موجود في صفحة يستطيع أي أحد قراءة مصدرها. ما
يجعل ذلك آمنًا هو قائمة النطاقات: يرفض الودجت العمل على أي نطاق لم يُدرجه صاحب القناة، فلا
ينفع المعرّف المنسوخ في مكان آخر.

<Warning>
  أضف نطاق الاختبار أيضًا إن كنت تجرب عليه، واحذف `*` قبل الإطلاق. الودجت الذي يعمل في أي
  مكان يمكن تضمينه في صفحة شخص آخر لإرسال رسائل إليك تبدو وكأنها من موقعك.
</Warning>

## اجعله يشبه علامتك

**محادثة الموقع ← الإعدادات ← المظهر.** تُحفظ التغييرات مباشرة في الودجت — بلا تعديل كود
ولا نشر. أعد تحميل الصفحة فتجدها، ومعاينة بجانب النموذج أثناء التعديل.

| الإعداد                                  | ما يغيّره                                                                    |
| ---------------------------------------- | ---------------------------------------------------------------------------- |
| لون العلامة                              | زر المحادثة، والشريط العلوي، وفقاعات رسائل الزائر.                           |
| لون النص فوق لون العلامة                 | يُختار تلقائيًا لضمان الوضوح. غيّره فقط إذا كان الاختيار التلقائي غير مناسب. |
| فاتح / داكن / تلقائي                     | التلقائي يتبع إعداد جهاز الزائر نفسه.                                        |
| الموضع وانحناء الحواف والمسافة من الأسفل | يمين أو يسار، وكيف يستقر مع تصميم صفحتك.                                     |
| الشعار                                   | يظهر في الأعلى وبجانب الردود التي لا تحمل صورة موظف.                         |
| «نعمل عبر Linkiasoft»                    | سطر صغير أسفل الودجت، يمكن إيقافه.                                           |

<Warning>
  لون فاتح مع نص أبيض فوقه = نص غير مقروء. تنبّهك المعاينة عندما ينخفض التباين عن حد الوضوح
  المعتمد؛ عندها اجعل اللون أغمق أو اختر لون النص بنفسك. إن بدا باهتًا لك فهو أسوأ لمن لديه
  ضعف بصر.
</Warning>

في تبويب **النصوص** تضبط اسم الفريق ورسالة الترحيب ورسالة عدم التوفر والنص الإرشادي، وتختار
اللغة — والعربية تحوّل الودجت بالكامل من اليمين إلى اليسار.

يستطيع المطورون تجاوز الألوان والموضع والزر **لكل صفحة على حدة** من الكود نفسه. راجع
[دليل الودجت](/ar/widget#overriding-settings).

## ما يحصل عليه الزائر

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

يمكنك طلب الاسم أو البريد أو الهاتف قبل بدء المحادثة من **الإعدادات ← السلوك ← قبل بدء
المحادثة**. اجعله قصيرًا: كل حقل تضيفه سبب إضافي لإغلاق الودجت بدل الكتابة، ويمكنك طلب
البريد لاحقًا حين يكون الزائر بانتظار إجابتك.

## عندما لا يتوفر أحد

يتبع التوفر حالة الموظفين ومناوباتك كبقية المنتج. راجع
[حالة التوفر](/ar/help/routing/presence-ready-busy-off) و
[المناوبات](/ar/help/routing/shifts-and-rotas).

* **يوجد موظف جاهز** — يقول الودجت ذلك، ويعرض زمن الرد المعتاد إن حددته.
* **لا يوجد** — يرى الزائر رسالة عدم التوفر ويستطيع الكتابة، وتنتظر المحادثة في صندوق الوارد.

يمكنك تجاوز ذلك من **الإعدادات ← السلوك ← التوافر**: إظهار التوفر دائمًا (وهو المنطقي حين
يجيب [وكيل ذكاء اصطناعي](/ar/help/ai/agents-overview) أولًا)، أو إظهار عدم التوفر دائمًا.

<Note>
  لا تَعِد بزمن رد لا تستطيع الوفاء به مساء الجمعة. اترك الحقل فارغًا فلا يَعِد الودجت بشيء —
  الوعد غير المُوفى أغلى من عدم الوعد.
</Note>

<h2 id="who-gets-the-chat">
  من تصله المحادثة
</h2>

تمامًا كأي قناة أخرى: المالك الملتصق أولًا، ثم إعدادات التوزيع. راجع
[كيف تُوزَّع المحادثات](/ar/help/routing/how-assignment-works).

أمران خاصان بمحادثة الموقع:

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

<h2 id="signed-in-visitors">
  إذا كان زوارك مسجّلي الدخول
</h2>

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

<Warning>
  افعل ذلك مع **التحقق من الهوية**. بدون توقيع، يكون المتصفح مجرد مُدّعٍ لهوية، ويستطيع أي شخص
  يفتح أدوات المطور ادّعاء هوية غيره وقراءة محادثاته. يوقّع خادمك معرّف كل مستخدم بالمفتاح
  السري للقناة، ونتحقق منه قبل تصديق الادعاء.

  فعّل **اشتراط توقيع صحيح** من **الإعدادات ← الأمان** بعد أن يبدأ موقعك بالتوقيع، وليتبع
  مطوروك [التحقق من الهوية](/ar/widget-api#identity-verification). المسألة بضعة أسطر في الخادم.
</Warning>

**تسجيل خروج كل الزوار** في نفس الصفحة يُبطل كل الجلسات المخزنة دفعة واحدة: يصبح كل متصفح
زائرًا جديدًا مجهولًا. لا يُحذف شيء، لكنهم لن يروا سجلّهم بعدها. وُجد هذا الزر ليوم يتسرب فيه
مفتاح سري.

## لا يظهر شيء على الموقع

<AccordionGroup>
  <Accordion title="زر المحادثة لا يظهر إطلاقًا">
    بالترتيب:

    1. هل النطاق مُدرج تمامًا كما يظهر في شريط العنوان؟ `acme.com` يشمل `www.acme.com`،
       أما النطاق الفرعي فيحتاج `*.acme.com`.
    2. هل القناة **متصلة** وليست موقوفة؟
    3. هل وصل الكود إلى الصفحة فعلًا؟ اعرض مصدر الصفحة وابحث عن `linkiasoft`.
    4. افتح وحدة تحكم المتصفح. يكتب الودجت سطرًا واحدًا يبدأ بـ `[Linkia chat]` عند رفضه
       العمل، ويذكر السبب.
    5. مانعات الإعلانات وإضافات الخصوصية تحجب ودجتات المحادثة. جرّب في متصفح نظيف قبل أن
       تفترض وجود عطل.
  </Accordion>

  <Accordion title="الرسائل تُرسل ولا تصل إلى صندوق الوارد">
    السبب غالبًا منح القناة لدور: **الأدوار ← الدور ← القنوات**. القناة المتصلة التي لا
    يشملها أي دور لا تصل إلى أحد، والزائر لا يرى أي خطأ.
  </Accordion>

  <Accordion title="ظهور زرّين">
    الكود موجود في الصفحة مرتين — غالبًا مرة في القالب ومرة في مدير الوسوم. لا يُحمَّل الودجت
    إلا مرة واحدة مهما كررت لصق نفس الكود، فوجود زر ثانٍ يعني كودًا ثانيًا مختلفًا.
  </Accordion>

  <Accordion title="يقول إننا غير متاحين والموظفون يعملون">
    يتبع التوفر حالة «جاهز» والمناوبات لا مجرد تسجيل الدخول. الموظف في وضع **مشغول** أو خارج
    مناوبته لا يُحتسب متاحًا. راجع [حالة التوفر](/ar/help/routing/presence-ready-busy-off)، أو
    اضبط التوافر على **إظهار التوفر دائمًا** إن كان وكيل ذكاء اصطناعي يجيب أولًا.
  </Accordion>

  <Accordion title="زائر عائد فقد سجلّ محادثاته">
    تعيش جلسة الزائر في متصفحه هو. مسح بيانات الموقع أو نافذة التصفح الخفي أو جهاز آخر —
    كلها تبدأ من جديد، وهذا متوقع. لنقل السجل بين الأجهزة، عرّف الزوار المسجّلين كما سبق.

    ويحدث هذا أيضًا بعد **تسجيل خروج كل الزوار** أو بعد تدوير معرّف الموقع.
  </Accordion>

  <Accordion title="لم يظهر عميل محتمل في خط المبيعات">
    هذا هو السلوك المقصود ما دام الزائر مجهولًا — راجع [من تصله المحادثة](#who-gets-the-chat).
    فعّل نموذج ما قبل المحادثة، أو اطلب البريد داخل المحادثة، فيُنشأ العميل المحتمل حينها.
  </Accordion>
</AccordionGroup>