تخصيص الودجت

تخصيص الودجت

خصِّص مظهر ودجت الدردشة ليتناسب مع هويتك التجارية وتصميم موقعك الإلكتروني.

الإعدادات

تتوفر جميع خيارات تخصيص الودجت في الإعدادات ← القنوات ← ويب. اختر قناة الويب وافتح تبويب المظهر.

---

لون الثيم

يُطبَّق لون الثيم بشكل موحد على جميع أجزاء الودجت:

• خلفية زر التشغيل
• خلفية شريط الرأس
• لون زر الإرسال
• لون تمييز الروابط
• خلفية فقاعة رسائل المستخدم

اختر لونًا يعكس هويتك التجارية ويضمن تباينًا جيدًا مع النص الأبيض.

---

رسالة الترحيب

رسالة الترحيب هي أول نص يراه العملاء عند فتح الودجت. اجعلها ودية ووضِّح فيها ما يمكن للبوت مساعدتهم به.

أمثلة:

1. “مرحبًا! كيف يمكنني مساعدتك اليوم؟”
2. “أهلًا بك في دعم Acme. اسألني أي شيء عن منتجاتنا وخدماتنا.”
3. “مرحبًا! أنا هنا للمساعدة. بماذا يمكنني خدمتك؟“

---

موضع الودجت

الموضع	قيمة الإعداد	متى تستخدمه
أسفل اليمين	bottom-right (افتراضي)	الموضع المعتاد، يناسب معظم المواقع
أسفل اليسار	bottom-left	عندما يتعارض الجانب الأيمن مع عناصر أخرى

---

الصورة الرمزية

v1.6.4

اعرض صورة رمزية مخصصة في رأس الودجت وشاشة الرئيسية عبر توفير رابط الصورة.

عبر لوحة التحكم: عيِّن رابط الصورة الرمزية في الإعدادات ← القنوات ← ويب ← المخصص ← رابط الصورة الرمزية.

عبر كود التضمين: مرِّر avatarUrl في إعداد الثيم:

<script>
  window.ClientaConfig = {
    botId: "YOUR_BOT_ID",
    widgetId: "YOUR_WIDGET_ID",
    theme: {
      avatarUrl: "https://example.com/your-logo.png"
    }
  };
</script>

المتطلبات:

• يجب أن يكون الرابط بصيغة https:// (تُرفض روابط http وdata: وjavascript: لأسباب أمنية)
• الحجم الموصى به: 128 × 128 بكسل (مربع)
• الصيغ المدعومة: PNG وJPG وWebP وSVG
• في حال كان الرابط غير صالح أو فشل تحميل الصورة، يُعرض الأيقون الافتراضي

---

وضع رسالة التحية

v1.6.2

تدعم رسالة التحية ثلاثة أوضاع للغة. انتقل إلى الإعدادات ← القنوات ← ويب ← المخصص وابحث عن قسم وضع رسالة التحية.

ثابت

تُعرض نفس نص التحية لجميع الزوار بغض النظر عن لغتهم. هذا هو الوضع الافتراضي.

أدخل تحية واحدة في حقل النص. مثال: “مرحبًا! كيف يمكنني مساعدتك اليوم؟“

مطابقة الزائر (المنطقة اللغوية)

اعرض تحية مختلفة لكل لغة. يقرأ الودجت اللغة المكتشفة للزائر ويعرض التحية المقابلة.

1. اختر وضع مطابقة الزائر.
2. يظهر حقل لكل من المناطق اللغوية الـ 15 المدعومة.
3. أدخل نص التحية لكل لغة تريد دعمها.
4. اتركْ حقل المنطقة اللغوية فارغًا للرجوع إلى التحية الثابتة لتلك اللغة.

مثال على الإعداد:

• التايلاندية: “สวัสดีค่ะ! มีอะไรให้ช่วยไหม?”
• الإنجليزية: “Hi! How can I help you today?”
• اليابانية: “こんにちは！何かお手伝いできますか？“

اللغة الرئيسية للمنظمة

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

استخدم وضع اللغة الرئيسية للمنظمة عندما يعمل فريقك بلغة واحدة وتريد أن تكون جميع التحيات متسقة.

---

منتقي اللغة

v1.6.2

يُضيف منتقي اللغة أيقونة كرة أرضية (🌐) إلى رأس الودجت ليتمكن الزوار من اختيار لغتهم صراحةً. وهو معطَّل افتراضيًا.

للتفعيل: في الإعدادات ← القنوات ← ويب ← المخصص، فعِّل خيار إظهار منتقي اللغة.

عندما يختار الزائر لغة من القائمة المنسدلة:

• تُقفل جميع ردود الذكاء الاصطناعي على تلك اللغة طوال الجلسة
• يتجاوز القفل الاكتشاف التلقائي حتى لو كتب الزائر بلغة مختلفة
• تتحول واجهة الودجت إلى اللغة المختارة

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

---

اللغة الافتراضية

v1.6.8

حدِّد لغة افتراضية للودجت ليرى الزوار الواجهة بمنطقتك اللغوية المفضلة قبل أي اكتشاف تلقائي. انتقل إلى الإعدادات ← القنوات ← ويب ← المخصص ← اللغة الافتراضية واختر من القائمة المنسدلة.

سلسلة أولويات اللغة هي:

1. إجبار هذه اللغة (إعدادات الذكاء الاصطناعي) — يتجاوز كل شيء عند تفعيله
2. اختيار الزائر الصريح (عبر منتقي اللغة، إن كان مفعَّلًا)
3. اللغة الافتراضية — هذا الإعداد
4. منطقة الإعداد في كود التضمين — قيمة locale في كود التضمين
5. التايلاندية — الخيار الاحتياطي عند عدم تعيين أي شيء آخر

اختر “بلا — اتبع إعداد التضمين” لتجاهل هذا الإعداد والاعتماد على قيمة المنطقة اللغوية في كود التضمين.

ملاحظة

تؤثر اللغة الافتراضية فقط على لغة واجهة الودجت. تُتحكَّم في لغة استجابة الذكاء الاصطناعي بشكل منفصل في إعدادات الذكاء الاصطناعي.

---

الوضع الداكن ومتغيرات CSS

v1.6.8

يدعم الودجت مبدِّل وضع داكن مدمج يمكن للزوار تفعيله من رأس الدردشة. تعتمد واجهة الودجت بالكامل على خصائص CSS المخصصة، مما يضمن مظهرًا متسقًا في كلا الوضعين.

متغيرات CSS الأساسية

المتغير	الوصف
--cw-primary	لون العلامة التجارية الأساسي (من إعداد لون الثيم)
--cw-primary-rgb	مكونات RGB للون الأساسي، تُستخدم لتأثيرات الشفافية
--cw-bg	لون خلفية الودجت
--cw-bg-secondary	الخلفية الثانوية (حقول الإدخال، عناصر النماذج)
--cw-surface	لون السطح للبطاقات والتلميحات ومقتطفات الاستشهادات
--cw-text	لون النص الأساسي
--cw-text-secondary	لون النص الثانوي/الخافت
--cw-border	لون الحدود للفواصل وحدود الإدخال

عند تبديل الوضع الداكن، يُطبِّق الودجت الصنف cw-dark أو cw-light على الحاوية الجذر، وتتحدث جميع متغيرات CSS تلقائيًا. يحترم رأس التدرج وفقاعات الرسائل ونموذج الاتصال وشرائح الاستشهادات الوضع الحالي.

ملاحظة

الوضع الداكن مبدِّل من جانب الزائر — لا يستمر بين الجلسات. يعمل الودجت افتراضيًا بالوضع الفاتح ما لم يُفعِّل الزائر الوضع الداكن خلال جلسة الدردشة.

---

المعاينة

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

---

نصائح

نصيحة

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