Konpigurasyon

Ipasadya ang itsura at kilos ng widget.

Mga Opsyon sa Init#

Opsyon	Default	Paglalarawan
agentId	kailangan*	Ang natatanging ID ng agent ninyo. *Para sa mga widget na tao lang ang sumasagot, sapat na ang `channelId` lang.
channelId	—	ID ng widget channel. Pinipili nito kung aling setting ng widget (estilo, papalabas na tooltip/banner) ang gagamitin kapag isang agent ang nagpapatakbo ng ilang widget, at ito ang tanging pagkakakilanlan ng mga widget na tao lang ang sumasagot. Kailangan ng kahit isa sa `agentId` / `channelId`.
position	bottom-right	`bottom-right` o `bottom-left`
primaryColor	#3B82F6	Kulay ng brand para sa button at header ng widget
title	Support	Teksto ng pamagat sa header
greeting	auto	Mensahe ng pagbati (kinukuha sa setting ng dashboard bilang default)
language	page	Wika ng widget bilang BCP-47 code (`de`, `pt-BR`). Tumutukoy sa interface, pagbati at mga mabilisang tanong. Kapag hindi ibinigay, sinusunod ng widget ang `<html lang>` ng pahina: ang pahinang ang `lang` ay hindi `en` ay nagsisimula na ngayon sa wikang iyon, anuman ang browser ng bisita. Ang `<html lang="en">` lamang ay itinuturing na default ng template at binabalewala: ang bisita ay nananatili sa dating gawi (naalalang pinili, pagkatapos ay wika ng browser). Ipasa ang `'browser'` upang tuluyang balewalain ang `<html lang>` at bumalik sa gawing «browser lamang». Baguhin habang tumatakbo gamit ang `Respondo.setLanguage('fr')` — kapaki-pakinabang para sa mga language switcher na hindi nagre-reload ng pahina.
placeholder	—	Custom na teksto ng placeholder sa input
quickQuestions	—	Array ng mga iminumungkahing tanong bago ang unang mensahe
logoUrl	—	URL ng logo ninyong ipinapakita sa header ng widget
avatarUrl	—	URL ng avatar ng ahente ng AI na ipinapakita katabi ng mga mensahe
identity	—	Nakatakda nang identity ng user sa init (kaparehong field ng `identify()`)
localStorageKey	—	Key sa localStorage na awtomatikong babasahin para sa `userId` (para sa GTM / no-code na setup)
chatSize	default	`compact`, `default`, o `large` — sukat ng chat window
launcherSize	default	`small`, `default`, o `large` — sukat ng launcher button
offsetBottom	20	Layo mula sa ibabang gilid (px)
offsetSide	20	Layo mula sa kaliwa/kanang gilid (px)
borderRadius	20	Radius ng sulok ng chat window (px)
zIndex	999999	CSS z-index para sa container ng widget
customCSS	—	Custom na CSS na ini-inject sa Shadow DOM ng widget para sa mas malalim na estilo
testMode	false	Markahan ang mga usapan bilang test (itinatago sa mga pangunahing view)

Buong Konpigurasyon#

Buong Konpigurasyonjavascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47; default: <html lang> (en = mahinang signal), binabalewala ito ng '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', // awtomatikong basahin ang userId sa localStorage (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // layo mula sa ibaba (px)
  identity: {                      // opsyonal: itakda sa init kung kilala na ang user
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // custom na katangian ng contact
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

Karamihan sa mga setting (kulay, logo, pagbati, mabilisang tanong) ay pinapamahalaan mula sa Channels dashboard. Kinukuha ng widget ang mga ito sa pagkarga — ang kailangan lang ninyo ay ang pares na agentId/channelId mula sa embed code.