Widget Embedding
Lisa oma AI-vestlusrobot igale veebisaidile sekunditega meie lihtsa manustuskoodi abil.
Quick Start
Lisa see kood enne sulguvat </body> sildi:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
See on kõik! Sinu vestlusrobot on nüüd veebisaidil aktiivne.
Finding Your Chatbot ID
- Mine oma vestlusroboti seadistustesse
- Ava Manustamine vahekaart
- Kopeeri manustuskood (sisaldab sinu ID-d)
Manustuskoodis olev vestlusroboti ID ei ole sama mis nimi sinu juhtpaneeli URL-is. Alati kopeeri ID Manustamine vahekaardilt.
Customizing the Widget
Vidina välimust ja käitumist seadistatakse sinu juhtpaneelil — mitte manustuskoodis. Mine Dashboard → Chatbots → [your chatbot] → Widget, et kohandada:
- Position — all paremas, all vasakus või inline
- Colors — põhivärv, taust- ja tekstivärvid ning äärise raadius
- Suurus — vidina laius ja kõrgus
Et avada vestlus automaatselt pärast seadistatavat viivitust, lülita sisse Automaatselt avamine Käitumine vahekaardil samal seadistuste lehel. White-label plaanide puhul on ChatReacti bränding vaikimisi peidetud — sama Käitumine vahekaart sisaldab Show "Powered by ChatReact" lülitit, kui soovite selle siiski vidina jaluses kuvada.
Muudatused kehtivad teie veebisaidil automaatselt — manustuskoodi ei ole vaja uuendada. Kõigi saadaolevate valikute jaoks vaata juhendit Widget Customization.
Vidina keel tuvastatakse automaatselt iga külastaja brauseri põhjal, lähtudes keeltest, mida lubate oma vestlusroboti Keeled vahekaardil.
Vali Inline positsioon, et manustada vestlus otse lehele sinna, kuhu skriptitähis on paigutatud. Vidin on alati avatud, ilma mullita või sulgemise nuputa — ideaalne pühendatud vestluse lehtede või tugilehtede jaoks.
FAQ Widget
Kuva KKK-d akordionina mis tahes lehel:
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
KKK-vidin näitab avaldatud KKK-sid sinu vestlusrobotist. Värvid ja stiil (põhivärv, taust- ja tekstivärvid, äärise raadius) seadistatakse Töölauavaade → KKK-d → Seaded.
FAQ Widget Options
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Põhivärv, taust- ja tekstivärvid, äärise raadius | Dashboard → FAQs → Settings |
| Laius | Vali 100% (täislaius) või kohandatud piksel-laius (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Kuvamise järjekord: Kuupäev (uusim ees), Nimi (alfabeet), või Kohandatud (manuaalne lohistamine) | Dashboard → FAQs → Settings → Behavior |
| Kategooriafilter | Kuvada ainult konkreetseid kategooriaid vidinas | Embed code data-categories atribuut |
| Custom Container | Renderda vidin oma elemendi sees, mitte vaikimisi chatreact-faq div-is | Embed code data-container atribuut |
| Keel | Üle kirjutada vidina keel (vaikimisi kasutab sinu lehe <html lang> atribuuti, seejärel külastaja brauseri keelt) | Embed code data-lang atribuut |
| Accordion Behavior | Luba mitme KKK samaaegne avamine või automaatne esimese KKK laiendamine | Dashboard → FAQs → Settings → Behavior |
Category Filter Example
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Kui vidin on filtreeritud ühele kategooriale, siis selle kategooria enda sortimisjärjestus (määra Dashboard → FAQs → Categories) kirjutab üle globaalse sortimisseade.
Mobile Optimization
Vestlusvidin on täielikult optimeeritud mobiilseadmete jaoks:
- Täislaiuse paigutus väikestel ekraanidel
- Avamisel keriv animatsioon
- iOS-klaviatuuri käsitlemine (vidin kohandub ekraanil oleva klaviatuuriga)
- Safe-area tugi iPhone'i sälgu ja koduindikaatori jaoks
- Suuremad puutealad paremaks kasutatavuseks
- Sisendi fondi suurus takistab iOS-i automaatset suumimist
Platform-Specific Guides
WordPress
Soovitatav: Kasuta ametlikku ChatReact WordPress Plugin lihtsaimaks integreerimiseks Gutenbergi plokkide, Elementor vidinate ja lühikoodidega.
Alternatiiv: Käsitsi manustamine läbi "Header/Footer Scripts" plugin'i:
- Paigalda ükskõik milline "Header/Footer Scripts" plugin
- Lisa manustuskood jaluse sektsiooni
- Salvesta ja avalda
Shopify
Soovitatav: ChatReact Shopify App
Paigalda ChatReacti rakendus Shopify App Store'ist kõige lihtsamaks integreerimiseks:
- Paigalda ChatReacti rakendus oma Shopify administraatoris
- Sisesta vestlusroboti ID rakenduse seadetes
- Vestlusvidin ilmub automaatselt sinu e-poe esilehele
- Halda vidina määramisi lehekülgede kaupa või lülita see kõigil lehtedel sisse
Rakendus toetab ka vormi- ja KKK-vidinaid kui App Block'e teema redaktoris.
Alternatiiv: Käsitsi manustamine
- Mine Online Store → Themes → Edit Code
- Ava
theme.liquid - Lisa kood enne
</body> - Salvesta
Webflow
- Mine Project Settings → Custom Code
- Lisa Footer Code ossa
- Avalda sait
Next.js / React
Kasuta Script komponenti:
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
Lisa oma peamisele App.vue või layout-i:
<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
Suhtle vidinaga programmiliselt:
// 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();
Testing
Preview Mode
Enne live-manustamist:
- Kasuta Eelvaade funktsiooni oma juhtpaneelil
- Testi erinevaid stsenaariume
- Kinnita, et vastused on õiged
Testid lokaalsel arendussaidil? Kasuta standardset manustuskoodi muutmata — see töötab ka localhost lehtedel.
Troubleshooting
Widget Not Appearing
- Kontrolli brauseri konsooli veaosade jaoks
- Veendu, et vestlusroboti ID on õige
- Veendu, et vestlusrobot on aktiivne (mitte keelatud)
- Kontrolli, kas reklaamiblokkerid segavad
- Kontrolli oma plaani kasutust — vidin peatub, kui sinu plaani igakuine limiit on täis
Caching & Optimization Plugins
Mõned vahemälu- või skriptioptimeerimise pluginad kirjutavad ümber skripti URL-e, mis võib peatada vidina laadimise. Kui see juhtub, lisa skripti sildile eksplicitne API URL:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-api-url="https://www.chatreact.ai"
async
></script>
Sama atribuut toimib FAQ ja vormi vidina skriptide puhul.
Styling Conflicts
Kui sinu saidi CSS tekitab konflikte:
- Vidin piiritleb oma stiilid oma konteinerisse ja kasutab kõrge prioriteediga reegleid konfliktide vastu seismiseks
- Kontrolli elementide z-index väärtusi, mis võivad vidinat kattuda
- Vältige üldiseid
!importantreegleid oma saidi CSS-is, mis sihivad generilisi elemente
Performance
Vidin on disainitud minimaalset mõjuga:
- Laeb asünkroonselt — ei blokeeri sinu lehe renderdamist
- Kerge: umbes 30 KB kompresseeritult
Next Steps
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — manusta iseseisvaid vorme vormi vidinaga