KezdőlapDokumentáció

Widget beágyazása

Adja hozzá AI chatbotját bármely weboldalhoz másodpercek alatt egyszerű beágyazó kódunkkal.

Gyors kezdés

Adja hozzá ezt a kódot a záró </body> tag előtt:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID" 
  async
></script>

Ennyi az egész! A chatbot mostantól élő a webhelyén.

A chatbot azonosítójának megtalálása

  1. Menjen a chatbotja beállításaihoz
  2. Navigáljon a Beágyazás fülre
  3. Másolja ki a beágyazó kódot (tartalmazza az azonosítót)

A beágyazó kódban szereplő chatbot-azonosító nem ugyanaz, mint a név a kezelőpanel URL-jében. Mindig a Beágyazás fülről másolja ki az azonosítót.

A widget testreszabása

A widget megjelenését és viselkedését a kezelőpanelen állítja be — nem a beágyazó kódban. Menjen a Dashboard → Chatbots → [your chatbot] → Widget oldalra, hogy módosítsa:

  • Position — jobb alsó, bal alsó vagy inline
  • Colors — elsődleges, háttér- és szövegszínek, valamint a keret lekerekítése
  • Méret — widget szélessége és magassága

A chat automatikus megnyitásához egy beállítható késleltetés után engedélyezze a Automatikus megnyitás opciót a ugyanazon beállítási oldal Viselkedés fülén. White-label csomagok esetén a ChatReact márkajelzése alapértelmezés szerint rejtve van — ugyanazon Viselkedés fülön talál egy Show "Powered by ChatReact" kapcsolót, ha mégis meg szeretné jeleníteni a láblécben.

A változtatások automatikusan érvénybe lépnek a webhelyén — nincs szükség a beágyazó kód frissítésére. Lásd a Widget Customization útmutatót az összes elérhető opcióért.

A widget nyelvét automatikusan észleli a látogató böngészője alapján, azokra a nyelvekre támaszkodva, amelyeket a chatbot Nyelvek fülén engedélyez.

Válassza az Inline pozíciót, ha a chatet közvetlenül az oldalba szeretné beágyazni ott, ahol a script tag elhelyezkedik. A widget ilyenkor mindig nyitva van, nincs buborék vagy bezáró gomb — ideális dedikált chatoldalakhoz vagy támogatási szekciókhoz.

FAQ widget

Megjeleníthet FAQ-okat akordeonként bármely oldalon:

<div id="chatreact-faq"></div>
<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>

A FAQ widget a chatbotból közzétett FAQ-okat mutatja. A színek és a stílus (elsődleges, háttér- és szövegszínek, keret lekerekítése) a Irányítópult → GYIK → Beállítások helyen vannak beállítva.

FAQ widget opciók

SettingDescriptionWhere to Configure
Colors & StylingElsődleges, háttér- és szövegszínek, keret lekerekítéseDashboard → FAQs → Settings
SzélességVálasztható 100% (teljes szélesség) vagy egyéni pixel szélesség (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderMegjelenítési sorrend: Dátum (újabb elöl), Név (ábécé), vagy Egyedi (kézi átrendezés)Dashboard → FAQs → Settings → Behavior
KategóriaszűrőCsak bizonyos kategóriák megjelenítése a widgetbenEmbed code data-categories attribútum
Custom ContainerA widget megjelenítése saját elemben a alapértelmezett chatreact-faq div helyettEmbed code data-container attribútum
NyelvA widget nyelvének felülbírálása (alapértelmezés szerint a oldal <html lang> attribútuma, majd a látogató böngészője)Embed code data-lang attribútum
Accordion BehaviorTöbb FAQ egyidejű nyitva tartásának engedélyezése, vagy az első FAQ automatikus kinyitásaDashboard → FAQs → Settings → Behavior

Kategóriaszűrő példa

<script
  src="https://www.chatreact.ai/embed/faq-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-categories="shipping,returns"
  async
></script>

Ha a widget egyetlen kategóriára van szűkítve, akkor az adott kategória saját sorrendje (a Dashboard → FAQs → Categories beállításánál) felülírja a globális rendezési beállítást.

Mobil optimalizáció

A chat widget teljesen optimalizált mobil eszközökre:

  • Teljes szélességű elrendezés kis képernyőkön
  • Felcsúszó animáció megnyitáskor
  • iOS billentyűzet kezelése (a widget alkalmazkodik a képernyőn megjelenő billentyűzethez)
  • Safe-area támogatás iPhone notch és home indicator számára
  • Nagyobb érintési célpontok a jobb használhatóságért
  • A beviteli betűméret megakadályozza az iOS automatikus nagyítást

Platform specifikus útmutatók

WordPress

Ajánlott: Használja a hivatalos ChatReact WordPress Plugin plugint a legegyszerűbb integrációhoz Gutenberg blokkokkal, Elementor widgetekkel és shortcode-okkal.

Alternatíva: Kézi beágyazás egy "Header/Footer Scripts" pluginnal:

  1. Telepítsen egy tetszőleges "Header/Footer Scripts" plugint
  2. Adja hozzá a beágyazó kódot a footer szekcióhoz
  3. Mentse és tegye közzé

Shopify

Ajánlott: ChatReact Shopify App

Telepítse a ChatReact alkalmazást a Shopify App Store-ból a legegyszerűbb integrációért:

  1. Telepítse a ChatReact alkalmazást a Shopify adminban
  2. Adja meg chatbot-azonosítóját az alkalmazás beállításaiban
  3. A chat widget automatikusan megjelenik a bolt felületén
  4. Oldalonként kezelheti a widget hozzárendeléseket, vagy engedélyezheti mindenhol

Az alkalmazás Form és FAQ widgeteket is támogat App Blockként a Theme Editorban.

Alternatíva: kézi beágyazás

  1. Menjen az Online Store → Themes → Edit Code menüponthoz
  2. Nyissa meg a theme.liquid fájlt
  3. Adjon hozzá kódot a </body> elé
  4. Mentse

Webflow

  1. Menjen a Project Settings → Custom Code részre
  2. Adja hozzá a Footer Code-hoz
  3. Publikálja a webhelyet

Next.js / React

Használja a Script komponenst:

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

Adja hozzá a fő App.vue fájlhoz vagy a layout-hoz:

<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

Programozottan is kommunikálhat a widgettel:

// 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();

Tesztelés

Előnézeti mód

A live beágyazás előtt:

  1. Használja a Előnézet funkciót a kezelőpanelen
  2. Teszteljen különböző forgatókönyveket
  3. Ellenőrizze, hogy a válaszok pontosak

Fejlesztői helyi környezetben tesztel? Használja a szabványos beágyazó kódot változtatás nélkül — ez localhost oldalaknál is működik.

Hibaelhárítás

A widget nem jelenik meg

  1. Ellenőrizze a böngésző konzolját hibák után
  2. Győződjön meg róla, hogy a chatbot azonosító helyes
  3. Ellenőrizze, hogy a chatbot aktív-e (nem le van tiltva)
  4. Ellenőrizze, hogy nem zavarják-e hirdetésblokkolók
  5. Ellenőrizze a csomag használatát — a widget szünetel, ha a csomag havi limite eléri

Cache & optimalizáló bővítmények

Néhány cache- vagy script-optimalizáló plugin átírhatja a script URL-eket, ami megállíthatja a widget betöltését. Ha ez előfordul, adjon meg egy explicit API URL-t a script tagben:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-api-url="https://www.chatreact.ai"
  async
></script>

Ugyanez az attribútum működik a FAQ és űrlap widget scriptjeinél is.

Stílusütközések

Ha a webhely CSS-e ütközik:

  • A widget a saját konténerére korlátozza a stílusokat, és magas prioritású szabályokat használ az ütközések elnyomására
  • Ellenőrizze a widgetet átfedő elemek z-index értékeit
  • Kerülje a túl általános !important szabályokat a webhely CSS-ében, amelyek generikus elemeket céloznak

Teljesítmény

A widgetet minimális hatásra terveztük:

  • Aszinkron módon töltődik — soha nem blokkolja az oldal renderelését
  • Kisméretű: kb. 30 KB tömörített átvitel

Következő lépések