کنفیگریشن

ویجٹ کی ظاہری شکل اور رویّہ اپنی مرضی کے مطابق ترتیب دیں۔

init کے اختیارات#

اختیار	طے شدہ	تفصیل
agentId	لازمی*	آپ کے ایجنٹ کا منفرد ID۔ *صرف انسانوں والے (humans-only) ویجٹس کے لیے `channelId` اکیلا کافی ہے۔
channelId	—	ویجٹ چینل کا ID۔ جب ایک ہی ایجنٹ کئی ویجٹ چلا رہا ہو تو یہ طے کرتا ہے کہ کس ویجٹ کی سیٹنگز (اسٹائلنگ، آؤٹ باؤنڈ ٹول ٹپس/بینر) لاگو ہوں، اور صرف انسانوں والے ویجٹس کے لیے یہی واحد شناخت کنندہ ہے۔ `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">` کو ٹیمپلیٹ کی ڈیفالٹ قدر سمجھا اور نظرانداز کیا جاتا ہے: وزیٹر پچھلا رویہ برقرار رکھتا ہے (یاد رکھا گیا انتخاب، پھر براؤزر کی زبان)۔ `<html lang>` کو مکمل نظرانداز کرنے اور «صرف براؤزر» رویے پر واپس جانے کے لیے `'browser'` دیں۔ رن ٹائم پر `Respondo.setLanguage('fr')` سے بدلا جا سکتا ہے — ایسے زبان سوئچرز کے لیے مفید جو صفحہ دوبارہ لوڈ نہیں کرتے۔
placeholder	—	ان پٹ فیلڈ کا کسٹم پلیس ہولڈر متن
quickQuestions	—	تجویز کردہ سوالات کی فہرست، جو پہلے پیغام سے پہلے دکھائی جاتی ہے
logoUrl	—	آپ کے لوگو کا URL، جو ویجٹ کے ہیڈر میں دکھایا جاتا ہے
avatarUrl	—	AI ایجنٹ کے اوتار کا URL، جو پیغامات کے ساتھ دکھایا جاتا ہے
identity	—	انیشیئلائزیشن کے وقت پہلے سے مقرر صارف شناخت (وہی فیلڈز جو `identify()` میں ہیں)
localStorageKey	—	localStorage کی وہ کلید جس سے `userId` خودکار طور پر پڑھا جائے (GTM / no-code سیٹ اپ کے لیے)
chatSize	default	`compact`، `default` یا `large` — چیٹ ونڈو کے پیمانے
launcherSize	default	`small`، `default` یا `large` — لانچر بٹن کا سائز
offsetBottom	20	نیچے کے کنارے سے فاصلہ (px)
offsetSide	20	بائیں/دائیں کنارے سے فاصلہ (px)
borderRadius	20	چیٹ ونڈو کے کونوں کی گولائی (px)
zIndex	999999	ویجٹ کنٹینر کے لیے CSS z-index
customCSS	—	اعلیٰ سطحی اسٹائلنگ کے لیے ویجٹ کے Shadow DOM میں داخل کی جانے والی کسٹم CSS
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', // auto-read userId from localStorage (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // distance from bottom (px)
  identity: {                      // optional: set at init if user is already known
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // custom contact properties
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

زیادہ تر سیٹنگز (رنگ، لوگو، خوش آمدید پیغام، فوری سوالات) Channels ڈیش بورڈ سے سنبھالی جاتی ہیں۔ ویجٹ انہیں لوڈ ہوتے وقت خود لے آتا ہے — ایمبیڈ کوڈ سے آپ کو صرف agentId/channelId کا جوڑا چاہیے ہوتا ہے۔