Referenční přehled nastavení widgetu

Na této stránce najdete přehled všech možností přizpůsobení widgetu, které nabízí návrhář widgetu (záložka Design v Playgroundu). Praktického průvodce najdete v Přizpůsobení vzhledu widgetu.

Barvy

Nastavení	Typ	Výchozí	Popis
Primární barva	Barva	Tmavě břidlicová (`#1E293B`)	Akcentová barva tlačítka spouštěče a bublin uživatelských zpráv.
Pozadí	Barva	Teplá krémově bílá (`#faf8f6`)	Barva pozadí okna chatu.
Barva textu	Barva	Tmavě šedá	Hlavní barva textu v okně chatu.
Uživatelská bublina	Barva	Černá (`#000000`)	Barva pozadí bublin uživatelských zpráv.
Bublina bota	Barva	Teplá krémová (`#f0ece8`)	Barva pozadí bublin zpráv bota.
Text uživatele	Barva	Bílá	Barva textu uvnitř bublin uživatelských zpráv.
Text bota	Barva	Tmavě šedá	Barva textu uvnitř bublin zpráv bota.
Barva odkazů	Barva	Modrá (`#2563eb`)	Barva klikatelných odkazů v odpovědích bota. Pokud ji necháte prázdnou, použije se primární barva.

Umístění a velikost

Nastavení	Možnosti	Výchozí	Popis
Styl otevření	Chatovací widget, Centrální dialog, Boční panel vpravo, Boční panel vlevo	Chatovací widget	Jak se widget otevírá (`open_style`). Chatovací widget je standardní vyskakovací panel, ostatní možnosti otevřou vycentrované modální okno nebo ukotvený postranní panel.
Pozice spouštěče	Vpravo dole, Vlevo dole, Na střed	Vpravo dole	Kde na stránce tlačítko spouštěče sedí (`launcher_position`).
Velikost widgetu	Kompaktní (400px), Standardní (500px), Velký (600px)	Velký	Výška otevřeného okna chatu.
Šířka panelu	0.25-0.75	0.35	Poměr šířky postranního panelu (zlomek viewportu). Týká se jen stylů s postranním panelem.
Odsadit obsah stránky	Přepínač	Vypnuto	Jen pro postranní panel. Místo překrytí stránku odsune stranou, takže návštěvník může číst obsah a chatovat vedle sebe. Na úzkých viewportech (pod 900px) se vrací k překrytí. Viz poznámky ke kompatibilitě níže.
Průhlednost dialogu	50%-100% (0.5-1.0)	1.0	Krytí pozadí u stylu vycentrovaného modálního okna.
Záře panelu	Přepínač	Vypnuto	Přidá kolem okna widgetu jemnou záři.

Kompatibilita režimu push obsahu

Režim push funguje na většině webů, ale u některých rozvržení může vést k drobným vizuálním vadám. Než ho zapnete pro všechny návštěvníky, vyzkoušejte si přepínač na staging nebo neveřejné stránce.

Pevná nebo lepivá záhlaví - prvky position: fixed/sticky se nezmenšují spolu se zbytkem stránky a zasahují pod panel. Spravíte to pár řádky vlastního CSS, viz Pevná nebo lepivá záhlaví níže.
Weby s transform na <html> nebo <body> - widget má sice záložní řešení pro rozbité position: fixed, ale interakci push si raději ověřte.
Sekce přes celou šířku s 100vw - zasáhnou pod panel a oříznou se (obvykle to nevadí).
Úzké viewporty (pod 900px) - push se automaticky vypne a panel přejde do režimu překrytí.

Chcete-li doladit přechod nebo vypnout push jen na některých stránkách, přepište jeho chování ve vlastním CSS cílením na html.ciq-pushing.

Pevná nebo lepivá záhlaví

Záhlaví s position: fixed/sticky jsou ukotvená k viewportu, takže se při zúžení stránky režimem push nezmenší. Aby na push reagovala, přidejte do CSS vlastního webu následující. Widget pro tento účel zpřístupňuje proměnnou --ciq-push-width (šířka panelu v pixelech) a třídy ciq-pushing / ciq-pushing--left na prvku <html>:

/* Replace `.your-header` with your fixed/sticky header's selector */
.your-header {
  transition: width 0.28s ease, margin-left 0.28s ease;
}
html.ciq-pushing .your-header {                    /* side panel right */
  width: calc(100% - var(--ciq-push-width, 0px)) !important;
}
html.ciq-pushing.ciq-pushing--left .your-header {  /* side panel left */
  margin-left: var(--ciq-push-width, 0px);
}

Záhlaví

Nastavení	Typ	Výchozí	Popis
Nadpis	Text	”Ask AI”	Hlavní text v záhlaví widgetu.
Podnadpis	Text	”Instant answers from our knowledge base”	Doplňkový text pod titulkem.
Ikona avatara	Obrázek/přednastavení	Výchozí ikona	Avatar v záhlaví. Vyberte z přednastavení nebo nahrajte vlastní obrázek.
Velikost avatara	Číslo (px)	24	Velikost avataru v záhlaví v pixelech, nastavíte ji posuvníkem.
Styl záhlaví	Plné, Přechod, Sklo	Plné	Vizuální styl oblasti záhlaví.
Zobrazit “Powered by”	Přepínač	Zapnuto	Zobrazí odznak “Powered by ChatbotIQ”. S doplňkem Branding Removal ho lze skrýt.

Tlačítko spouštěče

Nastavení	Typ	Výchozí	Popis
Styl spouštěče	Pouze ikona, Ikona + text, Pouze text	Ikona + text	Co tlačítko spouštěče ukazuje.
Ikona spouštěče	Přednastavení nebo vlastní URL	Jiskra	Ikona na spouštěči. K dispozici jsou přednastavení chat, message, help, headset, sparkle, bolt, robot a hand-wave, případně nahrajte vlastní ikonu.
Tvar spouštěče	Kruh, Zaoblený, Squircle, Blob, Pilulka, Šestiúhelník, Diamant	Kruh	Tvar tlačítka spouštěče.
Velikost spouštěče	Číslo	56	Velikost tlačítka spouštěče v pixelech.
Text spouštěče	Text	”Ask AI”	Popisek na spouštěči (u stylů Ikona + text nebo Pouze text).
Efekt spouštěče	Žádný, Pulzování, Záření, Poskakování, Vrtění, Plovoucí, Lesk, Morfování, Neon, Duha, Orbit	Pulzování	Animace na spouštěči, která upoutá pozornost.

Typografie

Nastavení	Možnosti	Výchozí	Popis
Velikost písma	Malé (13px), Střední (15px), Velké (17px)	Střední	Základní velikost písma pro text chatu.
Rodina písma	Systémové výchozí, Inter, Roboto, Open Sans, Lato, Georgia, Merriweather	Systémové výchozí	Písmo použité v chat widgetu.

Chování

Nastavení	Typ	Výchozí	Popis
Automatické otevření widgetu	Přepínač + prodleva (sekundy)	Vypnuto	Otevře widget automaticky po načtení stránky. Prodlevu před otevřením si nastavíte.
Zobrazit na mobilech	Přepínač	Zapnuto	Zda se widget zobrazuje na mobilních zařízeních.
Uvítací bublina	Text + prodleva + doba trvání	(prázdné)	Uvítací bublina, která se objeví vedle spouštěče dřív, než uživatel otevře chat. Nastavíte, kdy se ukáže a jak dlouho vydrží.
Plovoucí otázky	Přepínač + počet + načasování	Vypnuto	Zobrazí navržené otázky plovoucí poblíž spouštěče.
Animace vstupu	Přepínač	Vypnuto	Animuje widget při otevření.

Zprávy

Nastavení	Typ	Výchozí	Popis
Uvítací zpráva	Text	”Hey! Ask me anything.”	První zpráva, kterou uživatel uvidí po otevření prázdného chatu.
Zástupný text vstupu	Text	”Type your message…”	Nápovědný text v poli pro psaní zprávy.

Překrytí se souhlasem

Nastavení	Typ	Výchozí	Popis
Zobrazit overlay souhlasu	Přepínač	Vypnuto	Než uživatel začne chatovat, zobrazí obrazovku se souhlasem (GDPR/soukromí).

Související

Přizpůsobení vzhledu widgetu - praktický průvodce přizpůsobením
Vložení widgetu - přidání widgetu na váš web
Jak se widget načítá - pochopení procesu načítání