DomůDokumentace

Widget Embedding

Přidejte svého AI chatbota na jakoukoli webovou stránku během několika sekund pomocí našeho jednoduchého embed kódu.

Rychlý start

Vložte tento kód před zavírací </body> tag:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID" 
  async
></script>

To je vše! Váš chatbot je nyní na webu aktivní.

Kde najít ID chatbota

  1. Přejděte do nastavení svého chatbota
  2. Navigujte na záložku Vložení
  3. Zkopírujte embed kód (obsahuje vaše ID)

ID chatbota v embed kódu není stejné jako jméno v URL řídicího panelu. Vždy zkopírujte ID ze záložky Vložení.

Přizpůsobení widgetu

Vzhled a chování widgetu se nastavuje v řídicím panelu — nikoli v embed kódu. Přejděte na Dashboard → Chatbots → [váš chatbot] → Widget pro úpravy:

  • Position — pravý dolní roh, levý dolní roh nebo inline
  • Colors — primární, pozadí a barvy textu, plus poloměr ohraničení
  • Velikost — šířka a výška widgetu

Chcete-li chat automaticky otevřít po nastavitelném zpoždění, povolte Automatické otevření v záložce Chování na téže stránce nastavení. U white-label plánů je branding ChatReact ve výchozím nastavení skrytý — stejná záložka Chování obsahuje přepínač Show "Powered by ChatReact", pokud jej přesto chcete zobrazit v patičce widgetu.

Změny se na vašem webu projevují automaticky — není třeba aktualizovat embed kód. Podívejte se na průvodce Widget Customization pro všechny dostupné možnosti.

Jazyk widgetu se automaticky detekuje z prohlížeče každého návštěvníka na základě jazyků, které povolíte v záložce Jazyky svého chatbota.

Zvolte pozici Inline, chcete-li vložit chat přímo do stránky na místo, kde je umístěn skript tag. Widget je vždy otevřený, bez bubliny nebo tlačítka zavření — ideální pro samostatné stránky s chatem nebo sekce podpory.

FAQ widget

Zobrazte FAQ jako akordeon na jakékoli stránce:

<div id="chatreact-faq"></div>
<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>

FAQ widget zobrazuje publikované FAQ z vašeho chatbota. Barvy a stylování (primární, pozadí a barvy textu, poloměr ohraničení) se nastavují v Přehled → FAQ → Nastavení.

Možnosti FAQ widgetu

SettingDescriptionWhere to Configure
Colors & StylingPrimární, pozadí a barvy textu, poloměr ohraničeníDashboard → FAQs → Settings
ŠířkaVolba mezi 100% (plná šířka) nebo vlastní pixelovou šířkou (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderPořadí zobrazení: Date (novější první), Name (abecedně) nebo Custom (ruční přetažení)Dashboard → FAQs → Settings → Behavior
Filtr kategoriíZobrazit pouze specifické kategorie ve widgetuEmbed code data-categories atribut
Custom ContainerVykreslit widget uvnitř vašeho vlastního elementu místo výchozího chatreact-faq divuEmbed code data-container atribut
JazykPřepsat jazyk widgetu (výchozí podle <html lang> atributu stránky, následně podle jazyka prohlížeče návštěvníka)Embed code data-lang atribut
Accordion BehaviorPovolit více otevřených FAQ současně, nebo automaticky rozbalit první FAQDashboard → FAQs → Settings → Behavior

Příklad filtru podle kategorie

<script
  src="https://www.chatreact.ai/embed/faq-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-categories="shipping,returns"
  async
></script>

Pokud je widget filtrovaný na jednu kategorii, přepisuje vlastní pořadí té kategorie (nastavené v Dashboard → FAQs → Categories) globální nastavení řazení.

Optimalizace pro mobilní zařízení

Chat widget je plně optimalizovaný pro mobilní zařízení:

  • Rozložení na celou šířku na malých obrazovkách
  • Animace vysunutí při otevírání
  • Ošetření klávesnice na iOS (widget se přizpůsobí zobrazené klávesnici)
  • Podpora safe-area pro výřez a indikátor domů na iPhone
  • Větší dotykové cíle pro lepší použitelnost
  • Velikost písma v poli zabrání automatickému přiblížení na iOS

Platformně specifické návody

WordPress

Doporučeno: Použijte oficiální ChatReact WordPress Plugin pro nejjednodušší integraci s Gutenberg blocky, Elementor widgety a shortcody.

Alternativa: Ruční vložení přes plugin "Header/Footer Scripts":

  1. Nainstalujte libovolný plugin "Header/Footer Scripts"
  2. Přidejte embed kód do sekce patičky (footer)
  3. Uložte a publikujte

Shopify

Doporučeno: ChatReact Shopify App

Nainstalujte aplikaci ChatReact z Shopify App Store pro nejjednodušší integraci:

  1. Nainstalujte aplikaci ChatReact ve vašem Shopify adminu
  2. Zadejte své Chatbot ID v nastavení aplikace
  3. Chat widget se automaticky zobrazí na vašem e-shopu
  4. Spravujte přiřazení widgetu podle stránek, nebo jej povolte všude

Aplikace také podporuje Form a FAQ widgety jako App Blocks v Theme Editoru.

Alternativa: Ruční vložení

  1. Přejděte na Online Store → Themes → Edit Code
  2. Otevřete theme.liquid
  3. Přidejte kód před </body>
  4. Uložte

Webflow

  1. Přejděte do Project Settings → Custom Code
  2. Přidejte do Footer Code
  3. Publikujte web

Next.js / React

Použijte komponentu Script:

import Script from 'next/script';

export default function Layout({ children }) {
  return (
    <>
      {children}
      <Script 
        src="https://www.chatreact.ai/embed/widget.js"
        data-chatbot-id="YOUR_CHATBOT_ID"
        strategy="lazyOnload"
      />
    </>
  );
}

Vue.js

Přidejte do vašeho hlavního App.vue nebo layoutu:

<script setup>
import { onMounted } from 'vue';

onMounted(() => {
  const script = document.createElement('script');
  script.src = 'https://www.chatreact.ai/embed/widget.js';
  script.dataset.chatbotId = 'YOUR_CHATBOT_ID';
  script.async = true;
  document.body.appendChild(script);
});
</script>

JavaScript API

Interagujte s widgetem programově:

// Open the chat
ChatReact.open();

// Close the chat
ChatReact.close();

// Toggle open/closed
ChatReact.toggle();

// Start a fresh conversation
ChatReact.newChat();

// Remove the widget from the page entirely
// (useful in single-page apps, e.g. on route changes)
ChatReact.destroy();

Testování

Režim náhledu

Před živým vložením:

  1. Použijte funkci Náhled ve vašem řídicím panelu
  2. Otestujte různé scénáře
  3. Ověřte, že odpovědi jsou přesné

Testujete na lokálním vývojovém serveru? Použijte standardní embed kód beze změn — funguje i na localhost stránkách.

Řešení problémů

Widget se nezobrazuje

  1. Zkontrolujte konzoli prohlížeče na chyby
  2. Ověřte, že ID chatbota je správné
  3. Zkontrolujte, že chatbot je aktivní (není deaktivovaný)
  4. Zjistěte, zda nezasahují adblockery
  5. Zkontrolujte využití plánu — widget se pozastaví, když je dosažen měsíční limit vašeho plánu

Cache & optimalizační pluginy

Některé cache nebo pluginy pro optimalizaci skriptů přepisují URL skriptů, což může zastavit načítání widgetu. Pokud k tomu dojde, přidejte do script tagu explicitní API URL:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-api-url="https://www.chatreact.ai"
  async
></script>

Stejný atribut funguje u skriptů FAQ a form widgetů.

Konflikty stylování

Pokud se CSS vašeho webu konfliktuje:

  • Widget ohraničuje své styly do vlastního kontejneru a používá pravidla s vysokou prioritou, aby odolal konfliktům
  • Zkontrolujte hodnoty z-index prvků, které widget překrývají
  • Vyhněte se širokým !important pravidlům ve vašem CSS, která cílí na obecné elementy

Výkon

Widget je navržen s minimálním dopadem:

  • Načítá se asynchronně — nikdy neblokuje vykreslování stránky
  • Nízká váha: přibližně 30 KB komprimovaného přenosu

Další kroky