# تثبيت الويدجت

> الويدجت · انسخ كود التثبيت، والصقه في HTML موقعك، وانتهى الأمر.

يُثبَّت الويدجت بمقتطف كود واحد. الكود جاهز في لوحة التحكم ومرتبط بمشروعك مسبقًا — لا شيء تكتبه بيدك.

1. **انسخ الكود** — افتح صفحة **Widget** (الويدجت) من القائمة اليسرى وانقر على **Integrate** (الدمج)؛ ثم انسخ الكود بزر **Copy Code** (نسخ الكود).
2. **الصقه في HTML موقعك** — ضع الكود في مكان يُحمَّل في كل الصفحات — ويُفضَّل أن يكون قبل وسم الإغلاق `</body>` مباشرة. على منصات مثل WordPress وWix وShopify، يوضع في منطقة «الكود المخصص».
3. **تحقق منه** — حدّث موقعك؛ يجب أن تظهر فقاعة الدردشة في الزاوية السفلية اليمنى. إذا لم تظهر، راجع «الويدجت لا يظهر» في قسم الأسئلة الشائعة.

![صفحة Widget مع إبراز زر Integrate في أعلى اليمين](/docs/docs-widget-integrate.png)

*زر ① Integrate في أعلى يمين صفحة Widget يفتح كود التثبيت.*

![نافذة Integrate Widget مع تمييز كود التثبيت (1) وزر Copy Code (2)](/docs/docs-embed-kod.png)

*① الكود الخاص بمشروعك، جاهز للاستخدام ← ② انسخه بزر Copy Code.*

يبدو الكود هكذا (يأتي كودك معبّأً مسبقًا بمعرّف مشروعك وعنوانه):

كود التثبيت (مثال)

```
<!-- Chat Widget -->
<script>
  window.ChatWidgetSettings = { projectId: "YOUR-PROJECT-ID" };
  (function(){
    var w=window,d=document;
    var i=function(){i.q.push(arguments)};i.q=[];w.ChatWidget=i;
    var s=d.createElement("script");s.async=true;
    s.src=".../widget.js";
    d.head.appendChild(s);
  })();
</script>
```

> **قاعدة:** انسخ الكود دائمًا **من لوحة التحكم** — المثال أعلاه يوضح الشكل فقط؛ أما معرّف المشروع والعنوان فخاصان بك.

## اختبره قبل الإطلاق

لا تحتاج إلى لمس موقعك الحقيقي لتجربة الأمور: زر **Live test** (اختبار مباشر) في محرر الويدجت يفتح متجرًا تجريبيًا مدمجًا فيه **الويدجت الحقيقي** الخاص بك، تمامًا كما سيراه العملاء. افتحه، وأجرِ محادثة، واحجز موعدًا تجريبيًا — ثم أطلقه بثقة.

> **نصيحة:** يمكنك أيضًا تجربة الويدجت أولًا على صفحة واحدة من موقعك (صفحة اختبار مخفية مناسبة لذلك)، ثم تعميمه على الموقع كله عندما تكون راضيًا.

---

اقرأ هذه الصفحة على الموقع: [تثبيت الويدجت](/ar/docs/widget/install-on-your-site)
