Widget Embedding
Pridajte svoj AI chatbot na ľubovoľnú webovú stránku za pár sekúnd pomocou nášho jednoduchého embed kódu.
Rýchly začiatok
Vložte tento kód pred zatvárací </body> tag:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Hotovo! Váš chatbot je teraz aktívny na vašej webovej stránke.
Ako nájsť ID chatbota
- Prejdite do nastavení svojho chatbota
- Prejdite na kartu Vloženie
- Skopírujte embed kód (obsahuje vaše ID)
ID chatbota v embed kóde nie je rovnaké ako názov v URL v dashboarde. Vždy skopírujte ID z karty Vloženie.
Prispôsobenie widgetu
Vzhľad a správanie widgetu sa nastavuje v dashboarde — nie v embed kóde. Prejdite na Dashboard → Chatbots → [your chatbot] → Widget, aby ste upravili:
- Position — vpravo dole, vľavo dole alebo inline
- Colors — primárne, pozadie a farby textu, plus polomer zaoblenia
- Veľkosť — šírka a výška widgetu
Ak chcete chat automaticky otvoriť po nastaviteľnom oneskorení, povolte Automatické otvorenie na karte Správanie tej istej stránky nastavení. Na white-label plánoch je branding ChatReact skrytý predvolene — tá istá karta Správanie obsahuje prepínač Show "Powered by ChatReact", ak ho chcete napriek tomu zobraziť v päte widgetu.
Zmeny sa na vašej stránke prejavia automaticky — nie je potrebné aktualizovať embed kód. Pozrite si sprievodcu Widget Customization pre všetky dostupné možnosti.
Jazyk widgetu sa automaticky detekuje podľa prehliadača návštevníka, na základe jazykov, ktoré povolíte na karte Jazyky vášho chatbota.
Vyberte pozíciu Inline, ak chcete vložiť chat priamo do stránky na miesto, kde je umiestnený script tag. Widget je vtedy vždy otvorený, bez bubliny alebo tlačidla zatvorenia — ideálne pre samostatné chat stránky alebo sekcie podpory.
FAQ widget
Zobrazte FAQ ako akordeón na ľubovoľnej stránke:
<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 vášho chatbota. Farby a štýl (primárna, pozadie a farby textu, polomer zaoblenia) sa konfigurujú v Dashboard → FAQ → Nastavenia.
Možnosti FAQ widgetu
| Nastavenie | Popis | Kde nakonfigurovať |
|---|---|---|
| Farby a štýl | Primárna, pozadie a farby textu, polomer zaoblenia | Dashboard → FAQs → Settings |
| Šírka | Vyberte medzi 100% (plná šírka) alebo vlastnou šírkou v pixeloch (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Poradie zobrazenia: Dátum (najnovšie ako prvé), Názov (abecedne) alebo Vlastné (manuálne presúvanie) | Dashboard → FAQs → Settings → Behavior |
| Filter kategórií | Zobraziť iba konkrétne kategórie vo widgete | Embed code data-categories attribute |
| Vlastný kontajner | Renderovať widget vo vašom vlastnom elemente namiesto predvoleného chatreact-faq divu | Embed code data-container attribute |
| Jazyk | Prekryť jazyk widgetu (predvolene sa používa <html lang> atribút vašej stránky, potom jazyk prehliadača návštevníka) | Embed code data-lang attribute |
| Správanie akordeónu | Povoliť viacero otvorených FAQ naraz, alebo automaticky rozbaliť prvé FAQ | Dashboard → FAQs → Settings → Behavior |
Príklad filtra podľa kategórie
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Keď je widget filtrovaný na jednu kategóriu, poradie danej kategórie (nastavené v Dashboard → FAQs → Categories) prepisuje globálne nastavenie triedenia.
Optimalizácia pre mobilné zariadenia
Chat widget je plne optimalizovaný pre mobilné zariadenia:
- Rozloženie na plnú šírku na malých obrazovkách
- Animácia posunutia pri otvorení
- Riešenie klávesnice iOS (widget sa prispôsobí na obrazovku klávesnice)
- Podpora bezpečnej oblasti pre výrez iPhone a indikátor domovského tlačidla
- Väčšie dotykové prvky pre lepšiu použiteľnosť
- Veľkosť písma vstupu zabraňuje automatickému zväčšeniu v iOS
Platformovo špecifické návody
WordPress
Odporúčané: Použite oficiálny ChatReact WordPress Plugin pre najjednoduchšiu integráciu s Gutenberg blokmi, Elementor widgetmi a shortcode.
Alternatíva: Manuálne vloženie cez plugin "Header/Footer Scripts":
- Nainštalujte akýkoľvek plugin "Header/Footer Scripts"
- Pridajte embed kód do sekcie footer
- Uložte a publikujte
Shopify
Odporúčané: ChatReact Shopify App
Nainštalujte aplikáciu ChatReact z Shopify App Store pre najjednoduchšiu integráciu:
- Nainštalujte ChatReact app v administrácii Shopify
- Zadajte svoje Chatbot ID v nastaveniach appky
- Chat widget sa automaticky zobrazí na vašom obchode
- Spravujte priradenie widgetu pre jednotlivé stránky alebo ho povolte všade
Appka tiež podporuje Form a FAQ widgety ako App Blocks v Theme Editore.
Alternatíva: Manuálne vloženie
- Prejdite na Online Store → Themes → Edit Code
- Otvorte
theme.liquid - Pridajte kód pred
</body> - Uložte
Webflow
- Prejdite do Project Settings → Custom Code
- Pridajte do Footer Code
- Publikujte stránku
Next.js / React
Použite komponent 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
Pridajte do svojho hlavného App.vue alebo 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 widgetom programovo:
// 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();
Testovanie
Režim náhľadu
Pred živým vložením:
- Použite funkciu Náhľad vo vašom dashboarde
- Otestujte rôzne scenáre
- Overte, či sú odpovede presné
Testujete na lokálnom vývojovom serveri? Použite štandardný embed kód bez úprav — funguje aj na localhost stránkach.
Riešenie problémov
Widget sa nezobrazuje
- Skontrolujte konzolu prehliadača kvôli chybám
- Overte, či je ID chatbota správne
- Uistite sa, že je chatbot aktívny (nie je deaktivovaný)
- Skontrolujte, či adblockery nezasahujú
- Skontrolujte využitie vášho plánu — widget sa pozastaví, keď je dosiahnutý mesačný limit vášho plánu
Caching & optimalizačné pluginy
Niektoré caching alebo pluginy na optimalizáciu scriptov prepíšu URL skriptov, čo môže zastaviť načítanie widgetu. Ak sa to stane, pridajte explicitnú API URL do script tagu:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-api-url="https://www.chatreact.ai"
async
></script>
Tá istá atribúcia funguje pre skripty FAQ a form widgetov.
Konflikty so štýlmi
Ak konfliktuje CSS vašej stránky:
- Widget obmedzuje svoje štýly na vlastný kontajner a používa pravidlá s vysokou prioritou, aby odolal konfliktom
- Skontrolujte hodnoty z-index prvkov, ktoré prekrývajú widget
- Vyhnite sa širokým
!importantpravidlám vo vašom site CSS, ktoré cielia na generické elementy
Výkon
Widget je navrhnutý s minimálnym dopadom:
- Načítava sa asynchrónne — nikdy neblokuje renderovanie stránky
- Nízka váha: približne 30 KB stlačený prenos
Ďalšie kroky
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — vložte samostatné formuláre pomocou form widgetu