AvalehtDokumentatsioon

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

  1. Mine oma vestlusroboti seadistustesse
  2. Ava Manustamine vahekaart
  3. 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

SettingDescriptionWhere to Configure
Colors & StylingPõhivärv, taust- ja tekstivärvid, äärise raadiusDashboard → FAQs → Settings
LaiusVali 100% (täislaius) või kohandatud piksel-laius (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderKuvamise järjekord: Kuupäev (uusim ees), Nimi (alfabeet), või Kohandatud (manuaalne lohistamine)Dashboard → FAQs → Settings → Behavior
KategooriafilterKuvada ainult konkreetseid kategooriaid vidinasEmbed code data-categories atribuut
Custom ContainerRenderda vidin oma elemendi sees, mitte vaikimisi chatreact-faq div-isEmbed 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 BehaviorLuba mitme KKK samaaegne avamine või automaatne esimese KKK laiendamineDashboard → 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:

  1. Paigalda ükskõik milline "Header/Footer Scripts" plugin
  2. Lisa manustuskood jaluse sektsiooni
  3. Salvesta ja avalda

Shopify

Soovitatav: ChatReact Shopify App

Paigalda ChatReacti rakendus Shopify App Store'ist kõige lihtsamaks integreerimiseks:

  1. Paigalda ChatReacti rakendus oma Shopify administraatoris
  2. Sisesta vestlusroboti ID rakenduse seadetes
  3. Vestlusvidin ilmub automaatselt sinu e-poe esilehele
  4. 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

  1. Mine Online Store → Themes → Edit Code
  2. Ava theme.liquid
  3. Lisa kood enne </body>
  4. Salvesta

Webflow

  1. Mine Project Settings → Custom Code
  2. Lisa Footer Code ossa
  3. 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:

  1. Kasuta Eelvaade funktsiooni oma juhtpaneelil
  2. Testi erinevaid stsenaariume
  3. Kinnita, et vastused on õiged

Testid lokaalsel arendussaidil? Kasuta standardset manustuskoodi muutmata — see töötab ka localhost lehtedel.

Troubleshooting

Widget Not Appearing

  1. Kontrolli brauseri konsooli veaosade jaoks
  2. Veendu, et vestlusroboti ID on õige
  3. Veendu, et vestlusrobot on aktiivne (mitte keelatud)
  4. Kontrolli, kas reklaamiblokkerid segavad
  5. 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 !important reegleid 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