Konfigurasi

Sesuaikan tampilan dan perilaku widget.

Opsi Init#

Opsi	Default	Deskripsi
agentId	wajib*	ID unik agen Anda. *Untuk widget humans-only, `channelId` saja sudah cukup.
channelId	—	ID channel widget. Menentukan pengaturan widget mana (penataan gaya, tooltip/banner outbound) yang berlaku ketika satu agen menggerakkan beberapa widget, dan menjadi satu-satunya identifier untuk widget humans-only. Minimal salah satu dari `agentId` / `channelId` wajib diisi.
position	bottom-right	`bottom-right` atau `bottom-left`
primaryColor	#3B82F6	Warna merek untuk tombol dan header widget
title	Support	Teks judul header
greeting	auto	Pesan sambutan (dimuat dari pengaturan dashboard secara default)
language	page	Bahasa widget sebagai kode BCP-47 (`de`, `pt-BR`). Menentukan antarmuka, sapaan, dan pertanyaan cepat. Jika dikosongkan, widget mengikuti `<html lang>` halaman: halaman yang `lang`-nya bukan `en` kini dimulai dalam bahasa tersebut, apa pun browser pengunjung. `<html lang="en">` saja dianggap nilai bawaan template dan diabaikan: pengunjung tetap mendapat perilaku sebelumnya (pilihan yang diingat, lalu bahasa browser). Berikan `'browser'` untuk mengabaikan `<html lang>` sepenuhnya dan kembali ke perilaku «hanya browser». Ubah saat runtime dengan `Respondo.setLanguage('fr')` — berguna untuk pengalih bahasa yang tidak memuat ulang halaman.
placeholder	—	Teks placeholder input kustom
quickQuestions	—	Larik pertanyaan yang disarankan yang ditampilkan sebelum pesan pertama
logoUrl	—	URL logo Anda yang ditampilkan di header widget
avatarUrl	—	URL avatar agen AI yang ditampilkan di samping pesan
identity	—	Identitas pengguna yang ditetapkan sebelumnya saat init (bidang sama dengan `identify()`)
localStorageKey	—	Key localStorage untuk membaca otomatis `userId` (untuk penyiapan GTM / no-code)
chatSize	default	`compact`, `default`, atau `large` — dimensi jendela chat
launcherSize	default	`small`, `default`, atau `large` — ukuran tombol launcher
offsetBottom	20	Jarak dari tepi bawah (px)
offsetSide	20	Jarak dari tepi kiri/kanan (px)
borderRadius	20	Border radius jendela chat (px)
zIndex	999999	CSS z-index untuk kontainer widget
customCSS	—	CSS kustom yang disuntikkan ke Shadow DOM widget untuk penataan gaya lanjutan
testMode	false	Tandai percakapan sebagai uji (disembunyikan dari tampilan utama)

Konfigurasi Lengkap#

Konfigurasi Lengkapjavascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47; bawaan: <html lang> (en = sinyal 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 otomatis userId dari localStorage (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // jarak dari bawah (px)
  identity: {                      // opsional: tetapkan saat init jika pengguna sudah dikenal
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // properti kontak khusus
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

Sebagian besar pengaturan (warna, logo, sambutan, pertanyaan cepat) dikelola dari dashboard Channels. Widget mengambil pengaturan ini saat dimuat — Anda hanya memerlukan pasangan agentId/channelId dari kode sematan.