ডকুমেন্টেশন

কনফিগারেশন

উইজেটের চেহারা ও আচরণ নিজের মতো সাজান।

ইনিট অপশন#

অপশনডিফল্টবিবরণ
agentIdআবশ্যক*আপনার এজেন্টের অনন্য ID। *কেবল-মানুষ (humans-only) উইজেটের জন্য শুধু channelId দিলেই চলে।
channelId—উইজেট চ্যানেলের ID। একটি এজেন্ট একাধিক উইজেট চালালে কোন উইজেটের সেটিংস (স্টাইলিং, আউটবাউন্ড টুলটিপ/ব্যানার) প্রযোজ্য হবে তা এটি নির্ধারণ করে, আর কেবল-মানুষ উইজেটের একমাত্র শনাক্তকারী এটিই। agentId / channelId-এর অন্তত একটি আবশ্যক।
positionbottom-rightbottom-right বা bottom-left
primaryColor#3B82F6উইজেটের বোতাম ও হেডারের ব্র্যান্ড রং
titleSupportহেডারের শিরোনামের লেখা
greetingautoস্বাগত বার্তা (ডিফল্টে ড্যাশবোর্ড সেটিংস থেকে লোড হয়)
languagepageউইজেটের ভাষা 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—init-এর সময়েই ব্যবহারকারীর পরিচয় নির্ধারণ (identify()-এর মতোই ফিল্ড)
localStorageKey—যে localStorage কী থেকে userId নিজে থেকে পড়া হবে (GTM / no-code সেটআপের জন্য)
chatSizedefaultcompact, default, বা large — চ্যাট উইন্ডোর মাপ
launcherSizedefaultsmall, default, বা large — লঞ্চার বোতামের আকার
offsetBottom20নিচের প্রান্ত থেকে দূরত্ব (px)
offsetSide20বাঁ/ডান প্রান্ত থেকে দূরত্ব (px)
borderRadius20চ্যাট উইন্ডোর কোণের গোলাই (px)
zIndex999999উইজেট কনটেইনারের CSS z-index
customCSS—উন্নত স্টাইলিংয়ের জন্য উইজেটের Shadow DOM-এ ইনজেক্ট করা কাস্টম CSS
testModefalseকথোপকথনগুলোকে টেস্ট হিসেবে চিহ্নিত করা (মূল ভিউ থেকে লুকানো থাকে)

সম্পূর্ণ কনফিগারেশন#

সম্পূর্ণ কনফিগারেশন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', // localStorage থেকে userId নিজে থেকে পড়া (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // নিচ থেকে দূরত্ব (px)
  identity: {                      // ঐচ্ছিক: ব্যবহারকারী আগে থেকেই জানা থাকলে init-এ সেট করুন
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // কাস্টম কন্টাক্ট প্রপার্টি
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});
বেশিরভাগ সেটিং (রং, লোগো, স্বাগত বার্তা, দ্রুত প্রশ্ন) Channels ড্যাশবোর্ড থেকে পরিচালনা করা হয়। উইজেট লোড হওয়ার সময়েই সেগুলো নিয়ে নেয় — এম্বেড কোড থেকে আপনার কেবল agentId/channelId জোড়াটাই লাগে।