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
- Menjen a chatbotja beállításaihoz
- Navigáljon a Beágyazás fülre
- 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
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Elsődleges, háttér- és szövegszínek, keret lekerekítése | Dashboard → FAQs → Settings |
| Szélesség | Választható 100% (teljes szélesség) vagy egyéni pixel szélesség (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Megjelení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 widgetben | Embed code data-categories attribútum |
| Custom Container | A widget megjelenítése saját elemben a alapértelmezett chatreact-faq div helyett | Embed code data-container attribútum |
| Nyelv | A 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 Behavior | Több FAQ egyidejű nyitva tartásának engedélyezése, vagy az első FAQ automatikus kinyitása | Dashboard → 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:
- Telepítsen egy tetszőleges "Header/Footer Scripts" plugint
- Adja hozzá a beágyazó kódot a footer szekcióhoz
- 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:
- Telepítse a ChatReact alkalmazást a Shopify adminban
- Adja meg chatbot-azonosítóját az alkalmazás beállításaiban
- A chat widget automatikusan megjelenik a bolt felületén
- 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
- Menjen az Online Store → Themes → Edit Code menüponthoz
- Nyissa meg a
theme.liquidfájlt - Adjon hozzá kódot a
</body>elé - Mentse
Webflow
- Menjen a Project Settings → Custom Code részre
- Adja hozzá a Footer Code-hoz
- 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:
- Használja a Előnézet funkciót a kezelőpanelen
- Teszteljen különböző forgatókönyveket
- 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
- Ellenőrizze a böngésző konzolját hibák után
- Győződjön meg róla, hogy a chatbot azonosító helyes
- Ellenőrizze, hogy a chatbot aktív-e (nem le van tiltva)
- Ellenőrizze, hogy nem zavarják-e hirdetésblokkolók
- 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
!importantszabá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
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — beágyazott önálló űrlapok a form widgettel