Widget Embedding
Dodajte svoj AI chatbot na bilo koju web-stranicu za nekoliko sekundi uz naš jednostavan embed kod.
Brzi početak
Dodajte ovaj kod prije zatvarajućeg </body> taga:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
To je sve! Vaš chatbot je sada uživo na vašoj web-stranici.
Pronalaženje ID-a chatbota
- Idite u postavke vašeg chatbota
- Navigirajte do Ugradnja kartice
- Kopirajte embed kod (sadrži vaš ID)
ID chatbota u embed kodu nije isti kao naziv u URL-u vaše nadzorne ploče. Uvijek kopirajte ID s Ugradnja kartice.
Prilagodba widgeta
Izgled i ponašanje widgeta konfigurira se na vašoj nadzornoj ploči — ne u embed kodu. Idite na Dashboard → Chatbots → [your chatbot] → Widget da biste prilagodili:
- Position — donje desno, donje lijevo ili inline
- Colors — primarna, pozadinska i boja teksta, plus radijus obruba
- Veličina — širina i visina widgeta
Za automatsko otvaranje chata nakon konfigurabilnog kašnjenja, omogućite Automatsko otvaranje na Ponašanje kartici iste stranice s postavkama. Na white-label planovima, ChatReact brendiranje je prema zadanim postavkama sakriveno — ista Ponašanje kartica ima Show "Powered by ChatReact" prekidač ako ga želite prikazati u podnožju widgeta.
Promjene se automatski primjenjuju na vašu web-stranicu — nema potrebe za ažuriranjem embed koda. Pogledajte vodič Widget Customization za sve dostupne opcije.
Jezik widgeta automatski se prepoznaje prema pregledniku svakog posjetitelja, na temelju jezika koje omogućite u Jezici kartici vašeg chatbota.
Odaberite poziciju Inline za ugradnju chata izravno u stranicu na mjestu gdje se nalazi script tag. Widget je uvijek otvoren, bez bubble-a ili gumba za zatvaranje — idealno za namjenske stranice za chat ili odjeljke podrške.
FAQ widget
Prikažite FAQ-ove kao akordeon na bilo kojoj stranici:
<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 prikazuje objavljene FAQ-ove iz vašeg chatbota. Boje i stilovi (primarna, pozadinska i boja teksta, radijus obruba) konfiguriraju se u Nadzorna ploča → Često postavljana pitanja → Postavke.
Opcije FAQ widgeta
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primarna, pozadinska i boja teksta, radijus obruba | Dashboard → FAQs → Settings |
| Širina | Odaberite između 100% (puna širina) ili prilagođene širine u pikselima (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Redoslijed prikaza: Date (najnovije prvo), Name (abecedno) ili Custom (ručno povlačenje) | Dashboard → FAQs → Settings → Behavior |
| Filtar kategorije | Prikaži samo određene kategorije u widgetu | Embed code data-categories attribute |
| Custom Container | Renderirajte widget unutar vlastitog elementa umjesto zadane chatreact-faq div | Embed code data-container attribute |
| Jezik | Prepišite jezik widgeta (zadano koristi <html lang> atribut vaše stranice, zatim jezik preglednika posjetitelja) | Embed code data-lang attribute |
| Accordion Behavior | Dopuštajte istovremeno otvaranje više FAQ-ova, ili automatski proširite prvi FAQ | Dashboard → FAQs → Settings → Behavior |
Primjer filtriranja po kategoriji
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Kada je widget filtriran na jednu kategoriju, redoslijed te kategorije (postavljen u Dashboard → FAQs → Categories) zamjenjuje globalnu postavku sortiranja.
Optimizacija za mobilne uređaje
Chat widget je u potpunosti optimiziran za mobilne uređaje:
- Izgled pune širine na malim ekranima
- Animacija pomicanja prema gore pri otvaranju
- Rukovanje iOS tipkovnicom (widget se prilagođava na ekran tipkovnice)
- Podrška za safe-area za iPhone zarez i indikator početka
- Veći ciljevi za dodir radi bolje upotrebljivosti
- Veličina fonta u unosu sprječava iOS automatsko zumiranje
Vodiči specifični za platformu
WordPress
Preporučeno: Koristite službeni ChatReact WordPress Plugin za najjednostavniju integraciju s Gutenberg blokovima, Elementor widgetima i shortcodeovima.
Alternativa: Ručno ugradite putem "Header/Footer Scripts" plugin-a:
- Instalirajte bilo koji "Header/Footer Scripts" plugin
- Dodajte embed kod u footer sekciju
- Spremite i objavite
Shopify
Preporučeno: ChatReact Shopify App
Instalirajte ChatReact aplikaciju iz Shopify App Store-a za najjednostavniju integraciju:
- Instalirajte ChatReact app u svom Shopify adminu
- Unesite svoj Chatbot ID u postavkama aplikacije
- Chat widget se automatski pojavljuje na vašoj trgovini
- Upravljajte dodjelama widgeta po stranici, ili ga omogućite svugdje
Aplikacija također podržava Form i FAQ widgete kao App Blocks u Theme Editoru.
Alternativa: Ručna ugradnja
- Idite na Online Store → Themes → Edit Code
- Otvorite
theme.liquid - Dodajte kod prije
</body> - Spremite
Webflow
- Idite na Project Settings → Custom Code
- Dodajte u Footer Code
- Objavite stranicu
Next.js / React
Koristite Script komponentu:
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 u svoj glavni App.vue ili 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 s widgetom programatski:
// 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
Preview Mode
Prije nego što ugradite uživo:
- Koristite Pregled funkcionalnost na vašoj nadzornoj ploči
- Testirajte različite scenarije
- Provjerite jesu li odgovori točni
Testirate na lokalnom razvojnom sajtu? Koristite standardni embed kod nepromijenjen — radi i na localhost stranicama.
Rješavanje problema
Widget se ne prikazuje
- Provjerite konzolu preglednika za greške
- Provjerite je li ID chatbota ispravan
- Osigurajte da je chatbot aktivan (nije onemogućen)
- Provjerite ometaju li ad blockeri
- Provjerite korištenje plana — widget se zaustavlja kada se dosegne mjesečni limit vašeg plana
Pluginovi za keširanje i optimizaciju
Neki pluginovi za keširanje ili optimizaciju skripti prepisuju URL-ove skripti, što može spriječiti učitavanje widgeta. Ako se to dogodi, dodajte eksplicitni API URL u script tag:
<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 radi i za FAQ i form widget skripte.
Sukobi stilova
Ako CSS vaše stranice stvara konflikte:
- Widget ograničava svoje stilove na vlastiti kontejner i koristi pravila visokog prioriteta kako bi se odupro konfliktima
- Provjerite z-index vrijednosti elemenata koji prekrivaju widget
- Izbjegavajte široka
!importantpravila u CSS-u vaše stranice koja ciljanju generičke elemente
Performanse
Widget je dizajniran za minimalan utjecaj:
- Učitava se asinhrono — nikada ne blokira render stranice
- Lagani: otprilike 30 KB komprimirano za prijenos
Sljedeći koraci
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — ugrađujte samostalne obrasce pomoću form widgeta