Widget Embedding
Dodajte svoj AI klepetalni bot na katero koli spletno stran v nekaj sekundah z našo enostavno vstavitveno kodo.
Hitri začetek
To kodo dodajte pred zapiralni </body> oznako:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
To je vse! Vaš klepetalni bot je zdaj aktiven na vaši spletni strani.
Kako najti ID klepetalnega bota
- Pojdite v nastavitve vašega klepetalnega bota
- Odprite zavihek Vdelaj
- Kopirajte vstavitveno kodo (vsebuje vaš ID)
ID klepetalnega bota v vstavitveni kodi ni enak imenu v URL-ju vaše nadzorne plošče. Vedno kopirajte ID iz zavihka Vdelaj.
Prilagajanje vtičnika
Videz in vedenje vtičnika nastavljate v nadzorni plošči — ne v vstavitveni kodi. Pojdite na Dashboard → Chatbots → [your chatbot] → Widget, da prilagodite:
- Position — spodaj desno, spodaj levo ali v vrstici (inline)
- Colors — primarna, ozadje in barve besedila, ter radij robov
- Velikost — širina in višina vtičnika
Če želite, da se klepet samodejno odpre po nastavljivem zamiku, omogočite Samodejno odpri v zavihku Vedenje iste strani z nastavitvami. Pri white-label načrtih je ChatReact blagovna znamka privzeto skrita — isti zavihek Vedenje ima Show "Powered by ChatReact" preklop, če jo želite vseeno prikazati v nogi vtičnika.
Spremembe se samodejno uporabijo na vaši spletni strani — ni potrebe po posodabljanju vstavitvene kode. Oglejte si vodič Widget Customization za vse razpoložljive možnosti.
Jezik vtičnika se samodejno zazna glede na brskalnik vsakega obiskovalca, na podlagi jezikov, ki jih omogočite v zavihku Jeziki vašega klepetalnega bota.
Izberite položaj Inline, če želite vstaviti klepet neposredno na stran na mesto, kjer je postavljen script tag. Vtičnik je vedno odprt, brez mehurčka ali gumba za zapiranje — idealno za namenske strani za klepet ali podporne strani.
FAQ Widget
Prikažite pogosta vprašanja (FAQ) kot harmoniko (accordion) na kateri koli strani:
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
FAQ vtičnik prikazuje objavljena pogosta vprašanja iz vašega klepetalnega bota. Barve in stil (primarna, ozadje in barva besedila, radij robov) se nastavljajo v Nadzorna plošča → Pogosto zastavljena vprašanja → Nastavitve.
Možnosti FAQ vtičnika
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primarna, ozadje in barve besedila, radij robov | Dashboard → FAQs → Settings |
| Širina | Izberite med 100% (polna širina) ali prilagojeno širino v pikselih (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Vrstni red prikaza: Date (najprej najnovejše), Name (abecedno) ali Custom (ročno povleci in spusti) | Dashboard → FAQs → Settings → Behavior |
| Filter kategorij | Prikaži samo določene kategorije v vtičniku | Embed code data-categories attribute |
| Custom Container | Prikaži vtičnik znotraj lastnega elementa namesto privzetega chatreact-faq div | Embed code data-container attribute |
| Jezik | Prebridite jezik vtičnika (privzeto uporablja <html lang> atribut vaše strani, nato jezik brskalnika obiskovalca) | Embed code data-lang attribute |
| Accordion Behavior | Dovolite odpiranje več FAQ-ov hkrati ali samodejno razširite prvo vprašanje | Dashboard → FAQs → Settings → Behavior |
Primer filtra po kategoriji
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Ko je vtičnik filtriran na eno samo kategorijo, vrstni red te kategorije (nastavljen v Dashboard → FAQs → Categories) prevlada nad globalno nastavitvijo razvrščanja.
Optimizacija za mobilne naprave
Klepetalni vtičnik je popolnoma optimiziran za mobilne naprave:
- Postavitev celotne širine na majhnih zaslonih
- Animacija premika navzgor ob odpiranju
- Ravnanje s tipkovnico na iOS (vtičnik se prilagodi zaslonski tipkovnici)
- Podpora za varno območje (safe-area) za zarezavo iPhona in indikator domov
- Večji cilji za dotik za boljšo uporabnost
- Velikost pisave v vhodnem polju preprečuje samodejno povečevanje na iOS
Vodniki po platformah
WordPress
Priporočeno: Uporabite uradni ChatReact WordPress Plugin za najlažjo integracijo z Gutenberg bloki, Elementor gradniki in kratkimi kodami.
Alternativa: Ročna vdelava preko vtičnika "Header/Footer Scripts":
- Namestite poljuben vtičnik "Header/Footer Scripts"
- Dodajte vstavitveno kodo v footer razdelek
- Shrani in objavi
Shopify
Priporočeno: ChatReact Shopify App
Namestite ChatReact aplikacijo iz Shopify App Store za najlažjo integracijo:
- Namestite ChatReact aplikacijo v vašem Shopify upravljalniku
- Vnesite vaš Chatbot ID v nastavitve aplikacije
- Klepetalni vtičnik se samodejno pojavi na vaši trgovini
- Upravljajte dodelitve vtičnika po straneh ali ga omogočite povsod
Aplikacija prav tako podpira obrazce in FAQ vtičnike kot App Blocks v Theme Editorju.
Alternativa: ročna vdelava
- Pojdite na Online Store → Themes → Edit Code
- Odprite
theme.liquid - Dodajte kodo pred
</body> - Shrani
Webflow
- Pojdite v Project Settings → Custom Code
- Dodajte v Footer Code
- Objavite splet
Next.js / React
Uporabite komponento 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
Dodajte v vaš glavni App.vue ali layout:
<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
Interakcija z vtičnikom programatično:
// 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();
Testiranje
Način predogleda
Pred vdelavo v živo:
- Uporabite funkcijo Predogled v vaši nadzorni plošči
- Testirajte različne scenarije
- Preverite, ali so odgovori točni
Testirate na lokalni razvojni strani? Uporabite standardno vstavitveno kodo nespremenjeno — deluje tudi na localhost straneh.
Odpravljanje težav
Vtičnik se ne prikazuje
- Preverite konzolo brskalnika za napake
- Preverite, ali je ID klepetalnega bota pravilen
- Zagotovite, da je klepetalni bot aktiven (ni onemogočen)
- Preverite, ali oglasni blokatorji motijo delovanje
- Preverite uporabo vašega načrta — vtičnik se ustavi, ko dosežete mesečni limit vašega načrta
Vtičniki za predpomnjenje in optimizacijo
Nekateri vtičniki za predpomnjenje ali optimizacijo skript prepisujejo URL-je skript, kar lahko ustavi nalaganje vtičnika. Če se to zgodi, dodajte eksplicitno API URL v tag script:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-api-url="https://www.chatreact.ai"
async
></script>
Isti atribut deluje tudi na FAQ in form widget skripte.
Konflikti s stiliranjem
Če se CSS vaše strani spopada z vtičnikom:
- Vtičnik omeji svoje stile na lastni vsebnik in uporablja pravila z visoko prioriteto, da se upre konfliktom
- Preverite z vrednostmi z-index elementov, ki prekrivajo vtičnik
- Izogibajte se širokim
!importantpravilom v vašem CSS-ju strani, ki ciljajo generične elemente
Zmogljivost
Vtičnik je zasnovan z minimalnim vplivom:
- Nalaga se asinhrono — nikoli ne blokira upodabljanja strani
- Lahkoten: približno 30 KB stisnjenega prenosa
Naslednji koraki
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — vstavite samostojne obrazce z form widgetom