الإعدادات

خصّص مظهر الأداة وسلوكها.

خيارات التهيئة#

الخيار	الافتراضي	الوصف
agentId	مطلوب*	المعرّف الفريد لوكيلك. *للأدوات المخصّصة للدعم البشري فقط، يكفي `channelId` وحده.
channelId	—	معرّف قناة الأداة. يحدد إعدادات أي أداة تُطبَّق (التنسيق، التلميحات/اللافتات الصادرة) عندما يشغّل وكيل واحد عدة أدوات، وهو المعرّف الوحيد للأدوات المخصّصة للدعم البشري فقط. يلزم واحد على الأقل من `agentId` / `channelId`.
position	bottom-right	`bottom-right` أو `bottom-left`
primaryColor	#3B82F6	لون العلامة التجارية لزر الأداة ورأسها
title	Support	نص عنوان الرأس
greeting	auto	رسالة الترحيب (تُحمَّل من إعدادات لوحة التحكّم افتراضياً)
language	page	لغة الودجت كرمز BCP-47 (`de`، `pt-BR`). تحدّد الواجهة ورسالة الترحيب والأسئلة السريعة. عند إغفالها يتبع الودجت `<html lang>` الخاص بالصفحة: الصفحة التي يكون `lang` فيها غير `en` تبدأ الآن بتلك اللغة بغضّ النظر عن متصفح الزائر. أما `<html lang="en">` وحده فيُعامل كقيمة افتراضية للقالب ويُتجاهَل: يحتفظ الزائر بالسلوك السابق (الاختيار المحفوظ ثم لغة المتصفح). مرّر `'browser'` لتجاهل `<html lang>` كليًا والعودة إلى سلوك «المتصفح فقط». يمكن تغييرها أثناء التشغيل عبر `Respondo.setLanguage('fr')` — مفيد لمبدّلات اللغة التي لا تعيد تحميل الصفحة.
placeholder	—	نص العنصر النائب المخصص لحقل الإدخال
quickQuestions	—	مصفوفة من الأسئلة المقترحة تُعرض قبل الرسالة الأولى
logoUrl	—	رابط شعارك المعروض في رأس الأداة
avatarUrl	—	رابط الصورة الرمزية لوكيل الذكاء الاصطناعي المعروضة بجانب الرسائل
identity	—	تعيين هوية المستخدم مسبقاً عند التهيئة (نفس حقول `identify()`)
localStorageKey	—	مفتاح localStorage لقراءة `userId` منه تلقائياً (لإعدادات GTM / بدون كود)
chatSize	default	`compact` أو `default` أو `large` — أبعاد نافذة الدردشة
launcherSize	default	`small` أو `default` أو `large` — حجم الزر العائم
offsetBottom	20	المسافة من الحافة السفلية (بكسل)
offsetSide	20	المسافة من الحافة اليسرى/اليمنى (بكسل)
borderRadius	20	استدارة حواف نافذة الدردشة (بكسل)
zIndex	999999	قيمة z-index في CSS لحاوية الأداة
customCSS	—	CSS مخصص يُحقَن في Shadow DOM الخاص بالأداة للتنسيق المتقدم
testMode	false	وسم المحادثات كاختبارية (مخفية عن العروض الرئيسية)

الإعداد الكامل#

الإعداد الكاملjavascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47؛ الافتراضي: <html lang> (en = إشارة ضعيفة)، 'browser' يتجاهله
  title: 'Help Center',
  greeting: 'How can we help?',
  placeholder: 'Ask anything...',
  logoUrl: 'https://yoursite.com/logo.png',
  avatarUrl: 'https://yoursite.com/avatar.png',
  quickQuestions: [
    'How do I get started?',
    'What are the pricing plans?',
    'How do I contact support?'
  ],
  testMode: false,
  localStorageKey: 'myapp_user_id', // قراءة userId تلقائياً من localStorage (GTM / بدون كود)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // المسافة من الأسفل (بكسل)
  identity: {                      // اختياري: يُضبط عند التهيئة إذا كان المستخدم معروفاً بالفعل
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // خصائص جهة اتصال مخصصة
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

تُدار معظم الإعدادات (اللون، الشعار، رسالة الترحيب، الأسئلة السريعة) من لوحة تحكّم القنوات. تجلب الأداة هذه الإعدادات عند التحميل — كل ما تحتاجه هو زوج agentId/channelId من كود التضمين.