SākumsDokumentācija

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

  1. Dodieties uz sava tērzēšanas robota iestatījumiem
  2. Atveriet cilni Iegult
  3. 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

SettingDescriptionWhere to Configure
Colors & StylingPrimārā, fona un teksta krāsas, stūra noapaļojumsDashboard → FAQs → Settings
PlatumsIzvēle starp 100% (pilna platuma) vai pielāgotu pikseļu platumu (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderRā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 filtrsRādīt tikai konkrētas kategorijas widgetāEmbed code data-categories atribūts
Custom ContainerRenderēt widgetu jūsu elementā, nevis noklusējuma chatreact-faq divāEmbed code data-container atribūts
ValodaPā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 BehaviorAtļaut vairākām FAQ vienlaikus būt atvērtām vai automātiski izvērst pirmo FAQDashboard → 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:

  1. Instalējiet jebkuru "Header/Footer Scripts" spraudni
  2. Pievienojiet iegulšanas kodu footer sadaļā
  3. Saglabājiet un publicējiet

Shopify

Ieteicams: ChatReact Shopify App

Instalējiet ChatReact lietotni no Shopify App Store, lai visvienkāršāk integrētu:

  1. Instalējiet ChatReact lietotni savā Shopify admin vidē
  2. Ievadiet savu Chatbot ID lietotnes iestatījumos
  3. Tērzēšanas widget automātiski parādās jūsu veikala priekšskatā
  4. 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

  1. Dodieties uz Online Store → Themes → Edit Code
  2. Atveriet theme.liquid
  3. Pievienojiet kodu pirms </body>
  4. Saglabājiet

Webflow

  1. Dodieties uz Project Settings → Custom Code
  2. Pievienojiet Footer Code
  3. 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ē:

  1. Izmantojiet funkciju Priekšskats savā informācijas panelī
  2. Testējiet dažādus scenārijus
  3. 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

  1. Pārbaudiet pārlūkprogrammas konsoli, vai nav kļūdu
  2. Pārbaudiet, vai tērzēšanas robota ID ir pareizs
  3. Pārliecinieties, ka tērzēšanas robots ir aktīvs (nav atspējots)
  4. Pārbaudiet, vai reklāmu bloķētāji netraucē
  5. 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 !important noteikumiem 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