কনফিগারেশন
উইজেটের চেহারা ও আচরণ নিজের মতো সাজান।
ইনিট অপশন#
| অপশন | ডিফল্ট | বিবরণ |
|---|---|---|
| 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 | — | init-এর সময়েই ব্যবহারকারীর পরিচয় নির্ধারণ (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', // 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 জোড়াটাই লাগে।