Widgeta iegulšana
Pievienojiet savu AI tērzēšanas robotu jebkurai vietnei dažu sekunžu laikā, izmantojot mūsu vienkāršo iegulšanas kodu.
Ātrā uzstādīšana
Pievienojiet šo kodu pirms aizveroša </body> taga:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Tā arī viss! Jūsu tērzēšanas robots tagad ir aktīvs jūsu vietnē.
Kā atrast sava tērzēšanas robota ID
- Dodieties uz sava tērzēšanas robota iestatījumiem
- Atveriet cilni Iegult
- Kopējiet iegulšanas kodu (tajā iekļauts jūsu ID)
Iegulšanas koda tērzēšanas robota ID nav tas pats, kas nosaukums jūsu informācijas paneļa URL. Vienmēr kopējiet ID no cilnes Iegult.
Widgeta pielāgošana
Widgeta izskats un uzvedība tiek konfigurēta jūsu informācijas panelī — ne iegulšanas kodā. Dodieties uz Dashboard → Chatbots → [your chatbot] → Widget, lai pielāgotu:
- Position — apakšējais labais stūris, apakšējais kreisais stūris vai inline
- Colors — primārā, fona un teksta krāsas, kā arī stūra noapaļojums
- Izmērs — widgeta platums un augstums
Lai atvērtu tērzēšanu automātiski pēc konfigurējama aiztures, ieslēdziet Automātiska atvēršana cilnē Uzvedība tajā pašā iestatījumu lapā. White-label plānos ChatReact zīmols pēc noklusējuma ir paslēpts — tajā pašā cilnē Uzvedība ir pārslēgs Show "Powered by ChatReact", ja vēlaties to tomēr rādīt widgeta kājenē.
Izmaiņas tiek automātiski piemērotas jūsu vietnē — nav nepieciešams atjaunināt iegulšanas kodu. Skatiet ceļvedi Widget Customization par visām pieejamajām iespējām.
Widgeta valoda tiek automātiski noteikta pēc katra apmeklētāja pārlūkprogrammas, pamatojoties uz valodām, kuras aktivizējat sava tērzēšanas robota cilnē Valodas.
Izvēlieties pozīciju Inline, lai iegultu tērzēšanu tieši lapā vietā, kur ievietots skripta tags. Widgetam vienmēr ir atvērts skats, bez burbuļa vai aizvēršanas pogas — ideāli piemērots speciālām tērzēšanas lapām vai atbalsta sadaļām.
FAQ widget
Rādiet bieži uzdotos jautājumus kā akordeonu jebkurā lapā:
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
FAQ widget rāda publicētos FAQ no jūsu tērzēšanas robota. Krāsas un stils (primārā, fona un teksta krāsas, stūra noapaļojums) tiek konfigurēti Informācijas panelis → BUJ → Iestatījumi.
FAQ widgeta iespējas
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primārā, fona un teksta krāsas, stūra noapaļojums | Dashboard → FAQs → Settings |
| Platums | Izvēle starp 100% (pilna platuma) vai pielāgotu pikseļu platumu (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Rādīšanas secība: Datums (jaunākie pirmie), Nosaukums (alfabētiski) vai Pielāgots (manuāla vilkšana un nomešana) | Dashboard → FAQs → Settings → Behavior |
| Kategoriju filtrs | Rādīt tikai konkrētas kategorijas widgetā | Embed code data-categories atribūts |
| Custom Container | Renderēt widgetu jūsu elementā, nevis noklusējuma chatreact-faq divā | Embed code data-container atribūts |
| Valoda | Pārslēgt widgeta valodu (noklusēti ņem <html lang> atribūtu no lapas, tad apmeklētāja pārlūkprogrammas valodu) | Embed code data-lang atribūts |
| Accordion Behavior | Atļaut vairākām FAQ vienlaikus būt atvērtām vai automātiski izvērst pirmo FAQ | Dashboard → FAQs → Settings → Behavior |
Kategoriju filtra piemērs
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Kad widget ir filtrēts uz vienu kategoriju, šīs kategorijas iekšējā kārtošana (iestatīta Dashboard → FAQs → Categories) aizstāj globālo kārtošanas iestatījumu.
Mobilā optimizācija
Tērzēšanas widget pilnībā optimizēts mobilajām ierīcēm:
- Pilna platuma izkārtojums uz mazākiem ekrāniem
- Slīdoša animācija atveroties
- iOS tastatūras apstrāde (widget pielāgojas uz ekrāna tastatūru)
- Safe-area atbalsts iPhone iegriezumam un sākuma indikatoram
- Lielāki pieskāriena mērķi ērtākai lietošanai
- Ievades fonta izmērs novērš iOS automātisko pietuvināšanu
Platformai specifiski ceļveži
WordPress
Ieteicams: Izmantojiet oficiālo ChatReact WordPress spraudni vienkāršākai integrācijai ar Gutenberg blokiem, Elementor widgetiem un īskodiem.
Alternatīva: Manuāla iegulšana, izmantojot "Header/Footer Scripts" spraudni:
- Instalējiet jebkuru "Header/Footer Scripts" spraudni
- Pievienojiet iegulšanas kodu footer sadaļā
- Saglabājiet un publicējiet
Shopify
Ieteicams: ChatReact Shopify App
Instalējiet ChatReact lietotni no Shopify App Store, lai visvienkāršāk integrētu:
- Instalējiet ChatReact lietotni savā Shopify admin vidē
- Ievadiet savu Chatbot ID lietotnes iestatījumos
- Tērzēšanas widget automātiski parādās jūsu veikala priekšskatā
- Pārvaldiet widget piesaistes pa lapām vai iespējojiet to visur
Lietotne arī atbalsta Form un FAQ widgetus kā App Blocks tēmu redaktorā.
Alternatīva: Manuāla iegulšana
- Dodieties uz Online Store → Themes → Edit Code
- Atveriet
theme.liquid - Pievienojiet kodu pirms
</body> - Saglabājiet
Webflow
- Dodieties uz Project Settings → Custom Code
- Pievienojiet Footer Code
- Publicējiet vietni
Next.js / React
Izmantojiet 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
Pievienojiet savā galvenajā App.vue vai izkārtojumā:
<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
Sadarbojieties ar widgetu programmatiski:
// 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();
Testēšana
Priekšskatījuma režīms
Pirms iegulšanas tiešraidē:
- Izmantojiet funkciju Priekšskats savā informācijas panelī
- Testējiet dažādus scenārijus
- Pārbaudiet, vai atbildes ir precīzas
Testējat vietējā izstrādes vietnē? Izmantojiet standarta iegulšanas kodu bez izmaiņām — tas darbojas arī localhost lapās.
Problēmu novēršana
Widget nav redzams
- Pārbaudiet pārlūkprogrammas konsoli, vai nav kļūdu
- Pārbaudiet, vai tērzēšanas robota ID ir pareizs
- Pārliecinieties, ka tērzēšanas robots ir aktīvs (nav atspējots)
- Pārbaudiet, vai reklāmu bloķētāji netraucē
- Pārbaudiet sava plāna izmantošanu — widget tiek apturēts, kad tiek sasniegts jūsu plāna mēneša limits
Kešošanas un optimizācijas spraudņi
Daži kešošanas vai skriptu optimizācijas spraudņi pārraksta skriptu URL, kas var apturēt widgeta ielādi. Ja tas notiek, pievienojiet skripta tagam skaidru 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>
Tas pats atribūts darbojas arī FAQ un form widgetu skriptos.
Stila konflikti
Ja jūsu vietnes CSS konfliktē:
- Widget ierobežo savus stilus savā konteinerī un izmanto augsta prioritātes noteikumus, lai pretotos konfliktiem
- Pārbaudiet elementu z-index vērtības, kas pārklāj widgetu
- Izvairieties no plašiem
!importantnoteikumiem savā vietnes CSS, kas mērķē uz vispārīgiem elementiem
Veiktspēja
Widget ir projektēts ar minimālu ietekmi:
- Ielādējas asinhroni — nekad nenokavē jūsu lapas attēlojumu
- Viegls: aptuveni 30 KB saspiests pārraidei
Nākamie soļi
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — iegult atsevišķas formas ar form widgetu