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
- Přejděte do nastavení svého chatbota
- Navigujte na záložku Vložení
- 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
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primární, pozadí a barvy textu, poloměr ohraničení | Dashboard → FAQs → Settings |
| Šířka | Volba mezi 100% (plná šířka) nebo vlastní pixelovou šířkou (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Poř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 widgetu | Embed code data-categories atribut |
| Custom Container | Vykreslit widget uvnitř vašeho vlastního elementu místo výchozího chatreact-faq divu | Embed code data-container atribut |
| Jazyk | Př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 Behavior | Povolit více otevřených FAQ současně, nebo automaticky rozbalit první FAQ | Dashboard → 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":
- Nainstalujte libovolný plugin "Header/Footer Scripts"
- Přidejte embed kód do sekce patičky (footer)
- Uložte a publikujte
Shopify
Doporučeno: ChatReact Shopify App
Nainstalujte aplikaci ChatReact z Shopify App Store pro nejjednodušší integraci:
- Nainstalujte aplikaci ChatReact ve vašem Shopify adminu
- Zadejte své Chatbot ID v nastavení aplikace
- Chat widget se automaticky zobrazí na vašem e-shopu
- 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í
- Přejděte na Online Store → Themes → Edit Code
- Otevřete
theme.liquid - Přidejte kód před
</body> - Uložte
Webflow
- Přejděte do Project Settings → Custom Code
- Přidejte do Footer Code
- 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:
- Použijte funkci Náhled ve vašem řídicím panelu
- Otestujte různé scénáře
- 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
- Zkontrolujte konzoli prohlížeče na chyby
- Ověřte, že ID chatbota je správné
- Zkontrolujte, že chatbot je aktivní (není deaktivovaný)
- Zjistěte, zda nezasahují adblockery
- 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
!importantpravidlů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
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — vložení samostatných formulářů pomocí form widgetu