DomovDokumentacija

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

  1. Pojdite v nastavitve vašega klepetalnega bota
  2. Odprite zavihek Vdelaj
  3. 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

SettingDescriptionWhere to Configure
Colors & StylingPrimarna, ozadje in barve besedila, radij robovDashboard → FAQs → Settings
ŠirinaIzberite med 100% (polna širina) ali prilagojeno širino v pikselih (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderVrstni red prikaza: Date (najprej najnovejše), Name (abecedno) ali Custom (ročno povleci in spusti)Dashboard → FAQs → Settings → Behavior
Filter kategorijPrikaži samo določene kategorije v vtičnikuEmbed code data-categories attribute
Custom ContainerPrikaži vtičnik znotraj lastnega elementa namesto privzetega chatreact-faq divEmbed code data-container attribute
JezikPrebridite jezik vtičnika (privzeto uporablja <html lang> atribut vaše strani, nato jezik brskalnika obiskovalca)Embed code data-lang attribute
Accordion BehaviorDovolite odpiranje več FAQ-ov hkrati ali samodejno razširite prvo vprašanjeDashboard → 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":

  1. Namestite poljuben vtičnik "Header/Footer Scripts"
  2. Dodajte vstavitveno kodo v footer razdelek
  3. Shrani in objavi

Shopify

Priporočeno: ChatReact Shopify App

Namestite ChatReact aplikacijo iz Shopify App Store za najlažjo integracijo:

  1. Namestite ChatReact aplikacijo v vašem Shopify upravljalniku
  2. Vnesite vaš Chatbot ID v nastavitve aplikacije
  3. Klepetalni vtičnik se samodejno pojavi na vaši trgovini
  4. 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

  1. Pojdite na Online Store → Themes → Edit Code
  2. Odprite theme.liquid
  3. Dodajte kodo pred </body>
  4. Shrani

Webflow

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

  1. Uporabite funkcijo Predogled v vaši nadzorni plošči
  2. Testirajte različne scenarije
  3. 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

  1. Preverite konzolo brskalnika za napake
  2. Preverite, ali je ID klepetalnega bota pravilen
  3. Zagotovite, da je klepetalni bot aktiven (ni onemogočen)
  4. Preverite, ali oglasni blokatorji motijo delovanje
  5. 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 !important pravilom 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