Konfigurasi

Sesuaikan rupa dan kelakuan widget.

Pilihan Init#

Pilihan	Lalai	Penerangan
agentId	wajib*	ID unik ejen anda. *Untuk widget manusia-sahaja, `channelId` sahaja sudah memadai.
channelId	—	ID saluran widget. Menentukan tetapan widget yang mana (gaya, petua/sepanduk keluar) digunakan apabila satu ejen menggerakkan beberapa widget, dan menjadi satu-satunya pengecam bagi widget manusia-sahaja. Sekurang-kurangnya satu daripada `agentId` / `channelId` diperlukan.
position	bottom-right	`bottom-right` atau `bottom-left`
primaryColor	#3B82F6	Warna jenama untuk butang dan pengepala widget
title	Support	Teks tajuk pada pengepala
greeting	auto	Mesej alu-aluan (secara lalai dimuatkan daripada tetapan papan pemuka)
language	page	Bahasa widget sebagai kod BCP-47 (`de`, `pt-BR`). Menetapkan antara muka, ucapan alu-aluan dan soalan pantas. Jika tidak dinyatakan, widget mengikut `<html lang>` halaman: halaman yang `lang`-nya bukan `en` kini bermula dalam bahasa itu, tanpa mengira pelayar pelawat. `<html lang="en">` semata-mata dianggap nilai lalai templat dan diabaikan: pelawat mengekalkan tingkah laku sebelumnya (pilihan yang diingati, kemudian bahasa pelayar). Hantar `'browser'` untuk mengabaikan `<html lang>` sepenuhnya dan kembali kepada tingkah laku «pelayar sahaja». Tukar semasa runtime dengan `Respondo.setLanguage('fr')` — berguna untuk penukar bahasa yang tidak memuat semula halaman.
placeholder	—	Teks placeholder input tersuai
quickQuestions	—	Senarai soalan cadangan yang dipaparkan sebelum mesej pertama
logoUrl	—	URL logo anda yang dipaparkan dalam pengepala widget
avatarUrl	—	URL avatar ejen AI yang dipaparkan di sebelah mesej
identity	—	Tetapkan identiti pengguna semasa init (medan sama seperti `identify()`)
localStorageKey	—	Kunci localStorage untuk membaca `userId` secara automatik (untuk persediaan GTM / no-code)
chatSize	default	`compact`, `default`, atau `large` — dimensi tetingkap sembang
launcherSize	default	`small`, `default`, atau `large` — saiz butang pelancar
offsetBottom	20	Jarak dari tepi bawah (px)
offsetSide	20	Jarak dari tepi kiri/kanan (px)
borderRadius	20	Jejari sudut tetingkap sembang (px)
zIndex	999999	z-index CSS untuk bekas widget
customCSS	—	CSS tersuai yang disuntik ke dalam Shadow DOM widget untuk penggayaan lanjutan
testMode	false	Tandakan perbualan sebagai ujian (disembunyikan daripada paparan utama)

Konfigurasi Penuh#

Konfigurasi penuhjavascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47; lalai: <html lang> (en = isyarat lemah), 'browser' mengabaikannya
  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', // baca userId dari localStorage secara automatik (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // jarak dari bawah (px)
  identity: {                      // tidak wajib: tetapkan semasa init jika pengguna sudah dikenali
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // sifat kenalan tersuai
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

Kebanyakan tetapan (warna, logo, mesej alu-aluan, soalan pantas) diuruskan dari papan pemuka Channels. Widget mengambilnya semasa dimuatkan — anda hanya perlukan pasangan agentId/channelId daripada kod benam.