پیکربندی

ظاهر و رفتار ویجت را سفارشی کنید.

گزینه‌های راه‌اندازی#

گزینه	پیش‌فرض	توضیح
agentId	الزامی*	شناسهٔ یکتای عامل شما. *برای ویجت‌های فقط-انسانی، `channelId` به‌تنهایی کافی است.
channelId	—	شناسهٔ کانال ویجت. تعیین می‌کند وقتی یک عامل چند ویجت را می‌گرداند، تنظیمات کدام ویجت (ظاهر، تولتیپ‌ها/بنرهای outbound) اعمال شود، و برای ویجت‌های فقط-انسانی تنها شناسه است. دست‌کم یکی از `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	—	متن placeholder سفارشی برای فیلد ورودی
quickQuestions	—	آرایه‌ای از پرسش‌های پیشنهادی که پیش از نخستین پیام نشان داده می‌شوند
logoUrl	—	نشانی لوگوی شما که در سربرگ ویجت دیده می‌شود
avatarUrl	—	نشانی آواتار عامل هوش مصنوعی که کنار پیام‌ها دیده می‌شود
identity	—	تعیین هویت کاربر همان هنگام init (همان فیلدهای `identify()`)
localStorageKey	—	کلید localStorage که `userId` به‌طور خودکار از آن خوانده می‌شود (برای راه‌اندازی‌های GTM / بدون کد)
chatSize	default	`compact`، `default`یا `large` — ابعاد پنجرهٔ چت
launcherSize	default	`small`، `default`یا `large` — اندازهٔ دکمهٔ شناور
offsetBottom	20	فاصله از لبهٔ پایین (px)
offsetSide	20	فاصله از لبهٔ چپ/راست (px)
borderRadius	20	گردی گوشهٔ پنجرهٔ چت (px)
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', // 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 نیاز دارید.