PočetnaDokumentacija

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

  1. Idite u postavke vašeg chatbota
  2. Navigirajte do Ugradnja kartice
  3. 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

SettingDescriptionWhere to Configure
Colors & StylingPrimarna, pozadinska i boja teksta, radijus obrubaDashboard → FAQs → Settings
ŠirinaOdaberite između 100% (puna širina) ili prilagođene širine u pikselima (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderRedoslijed prikaza: Date (najnovije prvo), Name (abecedno) ili Custom (ručno povlačenje)Dashboard → FAQs → Settings → Behavior
Filtar kategorijePrikaži samo određene kategorije u widgetuEmbed code data-categories attribute
Custom ContainerRenderirajte widget unutar vlastitog elementa umjesto zadane chatreact-faq divEmbed code data-container attribute
JezikPrepišite jezik widgeta (zadano koristi <html lang> atribut vaše stranice, zatim jezik preglednika posjetitelja)Embed code data-lang attribute
Accordion BehaviorDopuštajte istovremeno otvaranje više FAQ-ova, ili automatski proširite prvi FAQDashboard → 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:

  1. Instalirajte bilo koji "Header/Footer Scripts" plugin
  2. Dodajte embed kod u footer sekciju
  3. Spremite i objavite

Shopify

Preporučeno: ChatReact Shopify App

Instalirajte ChatReact aplikaciju iz Shopify App Store-a za najjednostavniju integraciju:

  1. Instalirajte ChatReact app u svom Shopify adminu
  2. Unesite svoj Chatbot ID u postavkama aplikacije
  3. Chat widget se automatski pojavljuje na vašoj trgovini
  4. 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

  1. Idite na Online Store → Themes → Edit Code
  2. Otvorite theme.liquid
  3. Dodajte kod prije </body>
  4. Spremite

Webflow

  1. Idite na Project Settings → Custom Code
  2. Dodajte u Footer Code
  3. 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:

  1. Koristite Pregled funkcionalnost na vašoj nadzornoj ploči
  2. Testirajte različite scenarije
  3. 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

  1. Provjerite konzolu preglednika za greške
  2. Provjerite je li ID chatbota ispravan
  3. Osigurajte da je chatbot aktivan (nije onemogućen)
  4. Provjerite ometaju li ad blockeri
  5. 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 !important pravila 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