Usanidi

Binafsisha muonekano na tabia ya wijeti.

Chaguo za uanzishaji#

Chaguo	Chaguo-msingi	Maelezo
agentId	inahitajika*	Kitambulisho cha kipekee cha wakala wako. *Kwa wijeti za binadamu pekee, `channelId` peke yake inatosha.
channelId	—	Kitambulisho cha kituo cha wijeti. Huchagua mipangilio ya wijeti ipi itumike (mitindo, vidokezo/mabango ya outbound) pale wakala mmoja anapoendesha wijeti kadhaa, na ndicho kitambulisho pekee kwa wijeti za binadamu pekee. Angalau kimoja kati ya `agentId` / `channelId` kinahitajika.
position	bottom-right	`bottom-right` au `bottom-left`
primaryColor	#3B82F6	Rangi ya chapa kwa kitufe na kichwa cha wijeti
title	Support	Maandishi ya kichwa cha wijeti
greeting	auto	Ujumbe wa kukaribisha (kwa chaguo-msingi hupakiwa kutoka mipangilio ya dashibodi)
language	page	Lugha ya wijeti kama msimbo wa BCP-47 (`de`, `pt-BR`). Huweka kiolesura, salamu na maswali ya haraka. Ikiachwa, wijeti hufuata `<html lang>` ya ukurasa: ukurasa ambao `lang` yake si `en` sasa huanza kwa lugha hiyo, bila kujali kivinjari cha mgeni. `<html lang="en">` pekee huchukuliwa kama chaguo-msingi la kiolezo na hupuuzwa: mgeni hubaki na tabia ya awali (chaguo lililokumbukwa, kisha lugha ya kivinjari). Pitisha `'browser'` ili kupuuza `<html lang>` kabisa na kurudi kwenye tabia ya «kivinjari pekee». Badilisha wakati wa utekelezaji kwa `Respondo.setLanguage('fr')` — inafaa kwa vibadilishaji lugha visivyopakia upya ukurasa.
placeholder	—	Maandishi maalum ya mwongozo katika sehemu ya kuandika
quickQuestions	—	Orodha ya maswali yanayopendekezwa yanayoonyeshwa kabla ya ujumbe wa kwanza
logoUrl	—	URL ya nembo yako inayoonyeshwa katika kichwa cha wijeti
avatarUrl	—	URL ya avatar ya wakala wa AI inayoonyeshwa kando ya ujumbe
identity	—	Weka utambulisho wa mtumiaji tayari wakati wa init (sehemu zile zile kama `identify()`)
localStorageKey	—	Ufunguo wa localStorage wa kusoma `userId` kiotomatiki (kwa usanidi wa GTM / bila msimbo)
chatSize	default	`compact`, `default`, au `large` — vipimo vya dirisha la gumzo
launcherSize	default	`small`, `default`, au `large` — ukubwa wa kitufe cha kufungua
offsetBottom	20	Umbali kutoka ukingo wa chini (px)
offsetSide	20	Umbali kutoka ukingo wa kushoto/kulia (px)
borderRadius	20	Mviringo wa pembe za dirisha la gumzo (px)
zIndex	999999	z-index ya CSS kwa kontena la wijeti
customCSS	—	CSS maalum inayoingizwa katika Shadow DOM ya wijeti kwa mitindo ya kina
testMode	false	Weka alama kwa mazungumzo kuwa ya majaribio (hufichwa kwenye mionekano mikuu)

Usanidi kamili#

Usanidi kamilijavascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47; chaguo-msingi: <html lang> (en = ishara dhaifu), 'browser' huipuuza
  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', // soma userId kiotomatiki kutoka localStorage (GTM / bila msimbo)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // umbali kutoka chini (px)
  identity: {                      // si lazima: weka wakati wa init ikiwa mtumiaji anajulikana
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // sifa maalum za mwasiliani
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

Mipangilio mingi (rangi, nembo, salamu, maswali ya haraka) husimamiwa kutoka dashibodi ya Channels. Wijeti huyachukua wakati wa kupakia — unahitaji tu jozi ya agentId/channelId kutoka msimbo wa kupachika.