EtusivuDokumentaatio

Widgetin upotus

Lisää AI-chatbotinne mihin tahansa verkkosivuun sekunneissa yksinkertaisella upotuskoodillamme.

Pikakäynnistys

Lisää tämä koodi ennen sulkevaa </body>-tagia:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID" 
  async
></script>

Siinä kaikki! Chatbotinne on nyt käytössä verkkosivullanne.

Chatbotin tunnuksen löytäminen

  1. Siirtykää chatbotinne asetuksiin
  2. Valitkaa Upota-välilehti
  3. Kopioikaa upotuskoodi (sisältää tunnuksen)

Upotuskoodissa oleva chatbot-tunnus ei ole sama kuin nimi kojelaudan URL-osoitteessa. Kopioikaa aina tunnus Upota-välilehdeltä.

Widgetin mukauttaminen

Widgetin ulkoasu ja käyttäytyminen määritellään kojelaudassa — ei upotuskoodissa. Siirtykää kohtaan Dashboard → Chatbots → [your chatbot] → Widget säätääksenne:

  • Position — ala-oikea, ala-vasen tai inline
  • Colors — pääväri, tausta- ja tekstivärit sekä reunojen pyöristys
  • Koko — widgetin leveys ja korkeus

Avaa-chatti automaattisesti määriteltävän viiveen jälkeen ottakaa käyttöön Avaa automaattisesti saman asetussivun Käytös-välilehdellä. White-label-suunnitelmissa ChatReactin brändäys on oletuksena piilotettu — sama Käytös-välilehti sisältää Show "Powered by ChatReact"-kytkimen, jos haluatte näyttää brändäyksen widgetin alatunnisteessa.

Muutokset astuvat voimaan sivustollanne automaattisesti — upotuskoodia ei tarvitse päivittää. Katso kaikki saatavilla olevat vaihtoehdot Widget Customization -oppaasta.

Widget tunnistaa kielen automaattisesti jokaisen vierailijan selaimen asetusten perusteella, perustuen kieliin joita otatte käyttöön chatbotinne Kielet-välilehdellä.

Valitkaa Inline-sijainti upottaaksenne chatin suoraan sivulle siihen kohtaan, johon skriptitag on sijoitettu. Widget on aina avoinna ilman kuplaa tai sulkupainiketta — ihanteellinen omistetuille chattisivuille tai tukiosioille.

FAQ-widget

Näytätte usein kysytyt kysymykset harmonia-tyylisenä laajennoksena millä tahansa sivulla:

<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 näyttää chatbotin julkaistut FAQ:t. Värit ja tyylittely (pääväri, tausta- ja tekstivärit, reunojen pyöristys) määritellään kohdassa Kojelauta → FAQ:t → Asetukset.

FAQ-widgetin asetukset

SettingDescriptionWhere to Configure
Colors & StylingPrimary, background and text colors, border radiusDashboard → FAQs → Settings
LeveysChoose 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
LuokkasuodatinShow 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
KieliOverride 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

Kategoriasuodatin-esimerkki

<script
  src="https://www.chatreact.ai/embed/faq-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-categories="shipping,returns"
  async
></script>

Kun widget on suodatettu yhteen kategoriaan, kyseisen kategorian oma lajittelujärjestys (asetettu kohdassa Dashboard → FAQs → Categories) ohittaa globaalin lajitteluasetuksen.

Mobiilioptimointi

Chat-widget on täysin optimoitu mobiililaitteille:

  • Koko leveys pienillä näytöillä
  • Liukumisanimointi avatessa
  • iOS-näppäimistön käsittely (widget säätää itsensä näytöllä olevan näppäimistön mukaan)
  • Safe-area-tuki iPhonen lovelle ja kotipalkille
  • Suuremmat kosketustavoitteet parempaan käytettävyyteen
  • Syöttökentän fonttikoko estää iOS:n automaattisen zoomauksen

Alustakohtaiset ohjeet

WordPress

Suositeltu: Käyttäkää virallista ChatReact WordPress Plugin -lisäosaa helpoimpaan integraatioon Gutenberg-lohkojen, Elementor-widgettien ja lyhytkoodien kanssa.

Vaihtoehto: Manuaalinen upotus "Header/Footer Scripts" -lisäosan kautta:

  1. Asentakaa mikä tahansa "Header/Footer Scripts" -lisäosa
  2. Lisätkää upotuskoodi footer-osioon
  3. Tallettakaa ja julkaiskaa

Shopify

Suositeltu: ChatReact Shopify App

Asentakaa ChatReact-sovellus Shopify App Storesta helpoimpaa integraatiota varten:

  1. Asentakaa ChatReact-sovellus Shopify-hallintanne kautta
  2. Syöttäkää Chatbot ID sovelluksen asetuksiin
  3. Chat-widget ilmestyy automaattisesti kauppanne etusivulle
  4. Hallitkaa widgetin kohdistuksia sivukohtaisesti tai ottakaa se käyttöön kaikkialla

Sovellus tukee myös Lomake- ja FAQ-widgettejä App Blockseina Theme Editorissa.

Vaihtoehto: Manuaalinen upotus

  1. Siirtykää Online Store → Themes → Edit Code
  2. Avaa theme.liquid
  3. Lisää koodi ennen </body>
  4. Tallenna

Webflow

  1. Siirtykää Project Settings → Custom Code
  2. Lisätkää Footer Code -kohtaan
  3. Julkaiskaa sivusto

Next.js / React

Käyttäkää Script-komponenttia:

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

Lisätkää pää-App.vue:ään tai layoutiin:

<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

Käyttäkää widgettiä ohjelmallisesti:

// 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();

Testaus

Esikatselutila

Ennen live-upotusta:

  1. Käyttäkää Esikatselu-ominaisuutta kojelaudassanne
  2. Testatkaa eri skenaarioita
  3. Varmistakaa, että vastaukset ovat oikeita

Testaatteko paikallisella kehityssivulla? Käyttäkää vakio-upotuskoodia muuttamatta — se toimii myös localhost-sivuilla.

Vianetsintä

Widget ei näy

  1. Tarkastakaa selaimen konsoli virheilmoitusten varalta
  2. Varmistakaa chatbotin tunnus on oikein
  3. Varmistakaa, että chatbot on aktiivinen (ei poissa käytöstä)
  4. Tarkastakaa, häiritsevätkö mainostenesto-ohjelmat
  5. Tarkastakaa tilinne käyttö — widget keskeytyy, kun tilin kuukausittainen raja saavutetaan

Välimuisti- ja optimointilisäosat

Jotkin välimuisti- tai skriptin optimointilisäosat muokkaavat skripti-URL-osoitteita, mikä voi estää widgetin latautumisen. Jos näin tapahtuu, lisätkää eksplisiittinen API-URL skriptitagille:

<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 attribuutti toimii myös FAQ- ja lomake-widgetin skripteissä.

Tyylikonfliktit

Jos sivustonne CSS aiheuttaa ristiriitoja:

  • Widget rajoittaa tyylinsä omaan konttiinsa ja käyttää korkean prioriteetin sääntöjä konfliktien torjumiseksi
  • Tarkastakaa elementtien z-index-arvot, jotka saattavat peittää widgetin
  • Vältätte laajoja !important-sääntöjä sivustonne CSS:ssä, jotka kohdistuvat yleisiin elementteihin

Suorituskyky

Widget on suunniteltu minimoimaan vaikutus:

  • Latautuu asynkronisesti — ei koskaan estä sivun renderöintiä
  • Kevyt: noin 30 KB pakattuna siirtona

Seuraavat askeleet