Widget Embedding
Įdiekite savo DI pokalbių robotą bet kurioje svetainėje per kelias sekundes naudodami paprastą įterpimo kodą.
Greitas pradžia
Pridėkite šį kodą prieš uždarantįjį </body> žymeklį:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Viskas! Jūsų pokalbių robotas dabar veikia jūsų svetainėje.
Kaip rasti savo pokalbių roboto ID
- Eikite į savo pokalbių roboto nustatymus
- Pereikite į Įterpti skirtuką
- Nukopijuokite įterpimo kodą (jame yra jūsų ID)
Įterpimo kode esantis pokalbių roboto ID nėra tas pats, kas vardas jūsų prietaisų skydelio URL. Visada nukopijuokite ID iš Įterpti skirtuko.
Valdiklio pritaikymas
Valdiklio išvaizda ir elgsena konfigūruojamos jūsų prietaisų skydelyje — ne įterpimo kode. Eikite į Dashboard → Chatbots → [your chatbot] → Widget, kad pakeistumėte:
- Position — apačioje dešinėje, apačioje kairėje arba inline
- Colors — pagrindinė, fono ir teksto spalvos, taip pat krašto spindulys
- Dydis — valdiklio plotis ir aukštis
Norėdami automatiškai atidaryti pokalbį po nustatomo delsos laiko, įjunkite Automatinis atidarymas Elgsena skirtuke tame pačiame nustatymų puslapyje. White-label planuose ChatReact ženklinimas pagal numatytuosius nustatymus yra paslėptas — tas pats Elgsena skirtukas turi Show "Powered by ChatReact" jungiklį, jei vis dėlto norėtumėte jį rodyti valdiklio poraštėje.
Pakeitimai automatiškai taikomi jūsų svetainei — nereikia atnaujinti įterpimo kodo. Žr. Widget Customization vadovą dėl visų galimų parinkčių.
Valdiklio kalba automatiškai aptinkama pagal kiekvieno lankytojo naršyklę, remiantis kalbomis, kurias įjungiate savo pokalbių roboto Kalbos skirtuke.
Pasirinkite Inline padėtį, kad įterptumėte pokalbį tiesiogiai į puslapį toje vietoje, kur įdėtas script žymeklis. Valdiklis visada būna atidarytas, be piktogramos ar uždarymo mygtuko — puiku dedikuotoms pokalbių puslapio ar palaikymo sekcijoms.
DUK valdiklis
Rodykite DUK kaip akordeoną bet kuriame puslapyje:
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
DUK valdiklis rodo paskelbtas DUK iš jūsų pokalbių roboto. Spalvos ir stilius (pagrindinė, fono ir teksto spalvos, krašto spindulys) konfigūruojami Pagrindinis → DUK → Nustatymai.
DUK valdiklio parinktys
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primary, background and text colors, border radius | Dashboard → FAQs → Settings |
| Plotis | Choose between 100% (full width) or a custom pixel width (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Display order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop) | Dashboard → FAQs → Settings → Behavior |
| Kategorijų filtras | Show only specific categories in the widget | Embed code data-categories attribute |
| Custom Container | Render the widget inside your own element instead of the default chatreact-faq div | Embed code data-container attribute |
| Kalba | Override the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language) | Embed code data-lang attribute |
| Accordion Behavior | Allow multiple FAQs open at once, or auto-expand the first FAQ | Dashboard → FAQs → Settings → Behavior |
Kategorijų filtravimo pavyzdys
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Kai valdiklis filtruojamas pagal vieną kategoriją, tos kategorijos rūšiavimo tvarka (nustatyta Dashboard → FAQs → Categories) perrašo globalų rūšiavimą.
Optimizavimas mobiliesiems
Pokalbių valdiklis yra pilnai optimizuotas mobiliesiems įrenginiams:
- Pilno pločio išdėstymas mažiems ekranams
- Atrakcionas į viršų atidarant
- iOS klaviatūros valdymas (valdiklis prisitaiko prie ekrane esančios klaviatūros)
- Safe-area palaikymas iPhone notche'iui ir home indikatoriuje
- Didesni prisilietimo tikslai geresniam naudojimui
- Įvesties šrifto dydis apsaugo nuo iOS automatinio priartinimo
Platformai specifiniai vadovai
WordPress
Rekomenduojama: Naudokite oficialų ChatReact WordPress Plugin dėl paprasčiausios integracijos su Gutenberg blokais, Elementor valdikliais ir trumpaisiais kodais.
Alternatyva: Rankinė įterpimas per „Header/Footer Scripts“ papildinį:
- Įdiekite bet kurį „Header/Footer Scripts“ papildinį
- Pridėkite įterpimo kodą į footer skyrių
- Išsaugokite ir publikuokite
Shopify
Rekomenduojama: ChatReact Shopify App
Įdiekite ChatReact programėlę iš Shopify App Store dėl paprasčiausios integracijos:
- Įdiekite ChatReact programėlę savo Shopify administracijoje
- Įveskite savo Chatbot ID programėlės nustatymuose
- Pokalbių valdiklis automatiškai pasirodo jūsų parduotuvės priekyje
- Tvarkykite valdiklio paskyrimus puslapiams arba įjunkite jį visur
Programėlė taip pat palaiko Form ir FAQ valdiklius kaip App Blocks Theme Editor'e.
Alternatyva: rankinis įterpimas
- Eikite į Online Store → Themes → Edit Code
- Atidarykite
theme.liquid - Pridėkite kodą prieš
</body> - Išsaugokite
Webflow
- Eikite į Project Settings → Custom Code
- Pridėkite į Footer Code
- Publikuokite svetainę
Next.js / React
Naudokite Script komponentą:
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
Pridėkite į savo pagrindinį App.vue arba 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
Bendraukite su valdikliu programiškai:
// 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();
Testavimas
Peržiūros režimas
Prieš įdedant gyvai:
- Naudokitės Peržiūra funkcija savo prietaisų skydelyje
- Išbandykite įvairius scenarijus
- Patikrinkite, ar atsakymai yra tikslūs
Testuojate vietinėje kūrimo svetainėje? Naudokite standartinį įterpimo kodą be pakeitimų — jis veikia ir localhost puslapiuose.
Trikčių šalinimas
Valdiklis nerodomas
- Patikrinkite naršyklės konsolę dėl klaidų
- Patikrinkite, ar pokalbių roboto ID yra teisingas
- Įsitikinkite, kad pokalbių robotas aktyvus (nepašalintas)
- Patikrinkite, ar ad blokeriai netrukdo
- Patikrinkite savo plano naudojimą — valdiklis sustabdomas, kai pasiekiate mėnesio limito ribą
Talpyklos ir optimizavimo papildiniai
Kai kurie talpyklos arba skriptų optimizavimo papildiniai perrašo skriptų URL, dėl ko valdiklis gali neįsikrauti. Jei taip nutinka, pridėkite aiškų API URL prie script žymės:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-api-url="https://www.chatreact.ai"
async
></script>
Ta pati atributas veikia ir FAQ bei formos valdiklių skriptuose.
Stiliaus konfliktai
Jei jūsų svetainės CSS konfliktuoja:
- Valdiklis aprėmina savo stilius savo konteineryje ir naudoja aukštos prioritetinės taisykles, kad atsispirtų konfliktams
- Patikrinkite z-index reikšmes elementų, kurie dengia valdiklį
- Venkite plačių
!importanttaisyklių savo svetainės CSS, kurios taiko bendriems elementams
Veikimas
Valdiklis sukurtas su minimaliu poveikiu:
- Įkraunamas asinchroniškai — niekada neužblokuoja puslapio rodymo
- Lengvas: apie 30 KB suspausto perdavimo
Kiti žingsniai
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — įterpkite atskiras formas su formos valdikliu