PradžiaDokumentacija

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

  1. Eikite į savo pokalbių roboto nustatymus
  2. Pereikite į Įterpti skirtuką
  3. 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

SettingDescriptionWhere to Configure
Colors & StylingPrimary, background and text colors, border radiusDashboard → FAQs → Settings
PlotisChoose between 100% (full width) or a custom pixel width (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderDisplay order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop)Dashboard → FAQs → Settings → Behavior
Kategorijų filtrasShow only specific categories in the widgetEmbed code data-categories attribute
Custom ContainerRender the widget inside your own element instead of the default chatreact-faq divEmbed code data-container attribute
KalbaOverride the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language)Embed code data-lang attribute
Accordion BehaviorAllow multiple FAQs open at once, or auto-expand the first FAQDashboard → 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į:

  1. Įdiekite bet kurį „Header/Footer Scripts“ papildinį
  2. Pridėkite įterpimo kodą į footer skyrių
  3. Išsaugokite ir publikuokite

Shopify

Rekomenduojama: ChatReact Shopify App

Įdiekite ChatReact programėlę iš Shopify App Store dėl paprasčiausios integracijos:

  1. Įdiekite ChatReact programėlę savo Shopify administracijoje
  2. Įveskite savo Chatbot ID programėlės nustatymuose
  3. Pokalbių valdiklis automatiškai pasirodo jūsų parduotuvės priekyje
  4. 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

  1. Eikite į Online Store → Themes → Edit Code
  2. Atidarykite theme.liquid
  3. Pridėkite kodą prieš </body>
  4. Išsaugokite

Webflow

  1. Eikite į Project Settings → Custom Code
  2. Pridėkite į Footer Code
  3. 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:

  1. Naudokitės Peržiūra funkcija savo prietaisų skydelyje
  2. Išbandykite įvairius scenarijus
  3. 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

  1. Patikrinkite naršyklės konsolę dėl klaidų
  2. Patikrinkite, ar pokalbių roboto ID yra teisingas
  3. Įsitikinkite, kad pokalbių robotas aktyvus (nepašalintas)
  4. Patikrinkite, ar ad blokeriai netrukdo
  5. 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ų !important taisyklių 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