Instalace widgetu

Chat widget Awentail je lehká, vložitelná komponenta, která se načte na vašem webu. Jeden script tag — žádné závislosti, žádné build nástroje.

Základní instalace

Zkopírujte tento script tag a vložte ho před uzavírací tag </body> na vašem webu:

<script
  src="https://app.awentail.com/widget.js"
  data-bot-id="your-bot-id"
  defer>
</script>

Nahraďte your-bot-id skutečným ID vašeho asistenta (najdete ho v nastavení asistenta).

Možnosti přizpůsobení

Widget konfigurujte pomocí data- atributů na script tagu:

Atribut	Výchozí hodnota	Popis
`data-bot-id`	(povinné)	Unikátní identifikátor vašeho asistenta
`data-color`	`#7C3AED`	Primární barva pro záhlaví widgetu a zprávy uživatele
`data-position`	`bottom-right`	Pozice widgetu: `bottom-right` nebo `bottom-left`
`data-title`	Název asistenta	Vlastní název zobrazený v záhlaví widgetu
`data-welcome`	Uvítací zpráva asistenta	Přepsání uvítací zprávy
`data-auto-open`	`0`	Prodleva automatického otevření v sekundách (0 = vypnuto)

Příklad se všemi možnostmi

<script
  src="https://app.awentail.com/widget.js"
  data-bot-id="abc123"
  data-color="#2563EB"
  data-position="bottom-left"
  data-title="Help Center"
  data-welcome="How can I help you today?"
  data-auto-open="5"
  defer>
</script>

Živé konverzace

Uchovávání relací

Widget používá localStorage pro uchovávání konverzací. Pokud návštěvník odejde a vrátí se, jeho historie chatu je zachována. Relace jsou vázány na ID asistenta — různí asistenti udržují oddělené konverzace.

Stylování

Widget se vykresluje uvnitř <iframe> s vlastními izolovanými styly, takže nebude kolidovat s CSS vašeho webu. Widget přizpůsobuje svůj vzhled na základě atributu data-color.

Více asistentů

Na jedné stránce můžete vložit více asistentů — stačí přidat více script tagů s různými hodnotami data-bot-id:

<script src="https://app.awentail.com/widget.js" data-bot-id="sales-assistant" defer></script>
<script src="https://app.awentail.com/widget.js" data-bot-id="support-assistant" defer></script>

Výkon

Skript widgetu se načítá asynchronně s defer — neblokuje vykreslování stránky
Celková velikost balíčku je pod 15 KB gzipovaně
Žádné externí závislosti
Konverzace se načítají na vyžádání, ne při načtení stránky

Řešení problémů

Widget se nezobrazuje?

Zkontrolujte, že data-bot-id přesně odpovídá ID vašeho asistenta
Ujistěte se, že skript je umístěn před </body>
Zkontrolujte konzoli prohlížeče, zda neobsahuje chyby

Konflikty stylů?

Widget se vykresluje v iframe — neměl by dědit styly vašeho webu
Pokud vidíte problémy, zkontrolujte globální CSS, které cílí na elementy iframe

Asistent neodpovídá?

Ověřte, že váš asistent má nahrané dokumenty ve znalostní bázi
Zkontrolujte, zda jste nepřekročili měsíční kvótu konverzací