أداة الدردشة المدمجة

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

Widget Settings & Live Preview

التثبيت

انتقل إلى القنوات ← أداة الدردشة المدمجة في القائمة الجانبية.
انقر على إنشاء أداة وأعطها اسمًا.
اضبط إعدادات الأداة (راجع قسم التخصيص أدناه).
انسخ مقتطف كود التضمين المُقدَّم.
الصق المقتطف في HTML موقعك الإلكتروني، قُبيل وسم الإغلاق </body> مباشرةً.
احفظ موقعك وانشره — ستظهر الأداة فورًا.

كود التضمين

<!-- Clienta.ai Web Widget -->
<script>
  window.ClientaConfig = {
    botId: "YOUR_BOT_ID",
    widgetId: "YOUR_WIDGET_ID",
  };
</script>
<script
  src="https://api.clienta.ai/widget/YOUR_WIDGET_ID/loader.js"
  async
></script>

استبدل YOUR_BOT_ID وYOUR_WIDGET_ID بالقيم الظاهرة في لوحة التحكم الخاصة بك.

التخصيص

الخيار	الوصف
لون السمة	حدِّد اللون الأساسي ليتناسب مع هويتك البصرية (رمز هكساديسيمال أو منتقي الألوان)
رسالة الترحيب	أول رسالة تُعرض عند فتح المستخدم للأداة
الموضع	اختر الوضع في أسفل اليمين أو أسفل اليسار على الشاشة
الصورة الرمزية	ارفع صورة رمزية مخصصة للروبوت

تشمل الخيارات الإضافية:

عنوان الأداة — الاسم المعروض في رأس الأداة
نص العنصر النائب — النص التلميحي داخل مربع إدخال الرسالة
تأخير الفتح التلقائي — فتح الأداة تلقائيًا بعد N ثوانٍ (اختياري)
إخفاء على الجوال — تفعيل/تعطيل ظهور الأداة على الأجهزة المحمولة

آلية العمل

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

نموذج الاتصال

v1.6.8

عندما يكون روبوت الذكاء الاصطناعي غير متصل أو غير قادر على الرد، تعرض الأداة بالون دعوة للتفاعل يطلب من الزائر ترك بيانات الاتصال. النقر على البالون يفتح نموذج اتصال:

الحقل	مطلوب	ملاحظات
البريد الإلكتروني	نعم	مطلوب دائمًا للمتابعة
الهاتف	لا	يتضمن منتقي رمز الدولة مع 37 دولة وأعلام إيموجي (مثل 🇹🇭 +66، 🇺🇸 +1، 🇬🇧 +44، 🇯🇵 +81). يضمن التحقق من جانب الخادم صحة الرموز المُرسَلة.
الاسم	لا	اسم الزائر
الرسالة	لا	سياق إضافي

يُنشئ تقديم نموذج الاتصال تذكرةً مرئية في صفحة التذاكر بلوحة الإدارة، وتعرض البريد الإلكتروني والهاتف معًا عند توفرهما.

محادثة جديدة بعد الإغلاق

v1.6.8

عندما يُغلق أحد الوكلاء محادثةً، تعرض الأداة إشعارًا من النظام وزرًا “بدء محادثة جديدة”. النقر عليه:

يمسح سجل المحادثة الحالي
يُعيد الاتصال بجلسة WebSocket جديدة
يُعيد الأداة إلى حالتها الأولية

يتيح ذلك للزوار بدء محادثة جديدة دون إعادة تحميل الصفحة.

WebSocket في الوقت الفعلي

تستخدم الأداة اتصالًا دائمًا بـ WebSocket للمراسلة الفورية منخفضة الكُمون. السلوكيات الرئيسية:

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

ردود Markdown

v1.6.4

تُعرض رسائل الذكاء الاصطناعي والوكلاء بتنسيق Markdown منسَّق بدلًا من النص العادي. يشمل التنسيق المدعوم:

عريض، مائل، ~~يتوسطه خط~~
روابط (تُفتح في تبويب جديد تلقائيًا)
كود مضمَّن وكتل كود مُسيَّجة
قوائم مرتبة وغير مرتبة
عناوين، واقتباسات، وجداول

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

الصورة الرمزية للعلامة التجارية

v1.6.4

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

تُقبَل فقط عناوين URL بـ https://
إذا كان عنوان URL غير صالح أو فشل تحميل الصورة، يُعرض أيقونة البريق الافتراضية
يُنصح باستخدام صورة مربعة (مثل 128 × 128 بكسل) للحصول على أفضل النتائج

راجع تخصيص الأداة — الصورة الرمزية لمزيد من التفاصيل.

تسميات الذكاء الاصطناعي مقابل الإنسان

v1.6.4

تعرض كل رسالة غير صادرة من المستخدم تسمية مؤلف صغيرة تُعرِّف بالمُرسِل:

نوع المؤلف	التسمية المعروضة
روبوت الذكاء الاصطناعي	”مساعد الذكاء الاصطناعي” (مُترجَم)
وكيل بشري	اسم الوكيل (مثل “سارة”)

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

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

v1.6.2

تدعم رسالة الترحيب في الأداة ثلاثة أوضاع للغة، يمكن إعدادها في الإعدادات ← القنوات ← الويب ← المخصِّص ← وضع الترحيب:

الوضع	السلوك
ثابت	يعرض رسالة الترحيب ذاتها لكل زائر بصرف النظر عن لغته
مطابقة الزائر	يعرض رسالة ترحيب بحسب لغة كل زائر — اضبط نصًا مختلفًا لكل من اللُّغات الخمس عشرة
لغة المؤسسة الرئيسية	يعرض دائمًا رسالة الترحيب بلغة الاستجابة الرئيسية للمؤسسة (المُحدَّدة في إعدادات الذكاء الاصطناعي)

في وضع مطابقة الزائر، أي لغة لم يُضبَط لها نص ترحيب تُرجَع إلى نص الترحيب الثابت.

راجع تخصيص الأداة — وضع الترحيب للإعداد خطوة بخطوة.

منتقي اللغة

v1.6.2

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

عند التفعيل:

تظهر أيقونة كرة أرضية (🌐) في رأس الأداة
يمكن للزوار الاختيار من بين 15 لغة مدعومة
اختيار لغة ما يُثبِّت جميع ردود الذكاء الاصطناعي على تلك اللغة طوال الجلسة، متجاوزًا الكشف التلقائي
يبقى التثبيت ساريًا حتى لو كتب الزائر بلغة مختلفة

دعم الكتابة من اليمين إلى اليسار (RTL)

v1.6.2

تدعم الأداة وصفحة الهبوط دعمًا كاملًا لـ تخطيطات RTL للغتين العربية والعبرية. عندما يستخدم زائر لغة RTL:

يُعكَس التخطيط بالكامل (محاذاة النص، التنقل، عناصر الواجهة)
يُضبَط سمة <html dir="rtl"> تلقائيًا
تتمحاذى رسائل الدردشة ومربع الإدخال بشكل صحيح لاتجاه القراءة من اليمين إلى اليسار

لا يلزم أي إعداد يدوي — يُفعَّل RTL تلقائيًا بناءً على اللغة المختارة.

احتياطي مهلة التحميل

v1.6.5

إذا فشل سكريبت الأداة (widget.js) في التحميل خلال 10 ثوانٍ، يعرض التضمين واجهة احتياطية بدلًا من ترك مساحة فارغة. تتضمن الواجهة الاحتياطية زر إعادة محاولة يتيح للزائر محاولة إعادة تحميل الأداة دون تحديث الصفحة.

يحمي ذلك تجربة المستخدم عند مواجهة مشكلات شبكية أو حاجبات إعلانات أو انقطاعات في CDN تمنع تحميل الأداة.

إعادة تصميم الأداة البصري

v1.6.8

حظيت الأداة بتجديد بصري في الإصدار v1.6.8 بمظهر عصري ومصقول:

رأس متدرج — يستخدم رأس الأداة تدرجًا لطيفًا مستندًا إلى لون السمة، مع نقطة حالة وعرض الصورة الرمزية.
فقاعات رسائل مستديرة — تستخدم فقاعات الدردشة نصف قطر حد أكبر (rounded-2xl) لمظهر أكثر نعومة.
حركة فتح/إغلاق متحركة — تنزلق الأداة للداخل والخارج بحركات CSS سلسة بدلًا من الظهور الفوري.
مشغِّل معاد تصميمه — مشغِّل فقاعة الدردشة عبارة عن مربع مستدير الزوايا بحجم 60 بكسل مع ظل متوهج بلون العلامة التجارية وحركة دخول.
زر تبديل الوضع الداكن — يتيح زر التبديل في رأس الدردشة للزوار التنقل بين الوضع الفاتح والداكن خلال جلستهم.
حلقات تركيز بنمط العلامة التجارية — تعرض حقول الإدخال حلقات تركيز بلون العلامة التجارية لتعزيز إمكانية الوصول.
شارة إشعار — تظهر شارة للرسائل غير المقروءة على فقاعة المشغِّل.

تُطبَّق هذه التغييرات البصرية تلقائيًا — لا حاجة لأي تعديلات في الإعدادات.

شرائح الاستشهادات

v1.6.5

عندما يرد روبوت الذكاء الاصطناعي بمعلومات مصدرها قاعدة المعرفة، تظهر شرائح استشهادات أسفل الرسالة. كل شريحة تمثل مستندًا مسترجَعًا أسهم في الإجابة.

السلوك	الوصف
عرض الشرائح	يعرض ما يصل إلى 3 شرائح بعناوين المستندات. إذا استُخدمت مصادر أكثر، تشير شريحة “+N أخرى” إلى استشهادات إضافية.
النقر للتوسيع	النقر على شريحة يُبدِّل مقتطفًا مضمَّنًا يعرض أول 200 حرف من المحتوى المسترجَع. لا يمكن فتح سوى مقتطف واحد في المرة الواحدة.
اختزال العنوان	تُختزَل عناوين المستندات الطويلة إلى 40 حرفًا مع علامة حذف.
التصميم	تستخدم الشرائح اللون الأساسي للأداة كصبغة خفية، مع دعم كامل للوضع الداكن وRTL.
إمكانية الوصول	الشرائح قابلة للتنقل بلوحة المفاتيح مع سمات ARIA مناسبة (`aria-expanded`)، وأدوار القوائم، ودعم قارئات الشاشة.

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

التمرير التلقائي

v1.6.8

تُمرِّر الأداة تلقائيًا إلى أحدث رسالة كلما وصل محتوى جديد. ينطبق ذلك على:

الرسائل الجديدة من روبوت الذكاء الاصطناعي أو وكيل بشري
المحتوى المتدفق أثناء توليد الروبوت للرد في الوقت الفعلي

يستخدم التمرير حركة سلسة لتبدو الانتقالات طبيعية. لا يلزم أي إعداد — التمرير التلقائي نشط دائمًا.

حدود القنوات حسب الخطة

الخطة	الحد الأقصى للقنوات
مجاني	1
مبتدئ	2
نمو	5
بلس	6
احترافي	15
موسَّع	30
مؤسسي	50