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
- Siirtykää chatbotinne asetuksiin
- Valitkaa Upota-välilehti
- 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
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primary, background and text colors, border radius | Dashboard → FAQs → Settings |
| Leveys | Choose between 100% (full width) or a custom pixel width (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Display order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop) | Dashboard → FAQs → Settings → Behavior |
| Luokkasuodatin | Show only specific categories in the widget | Embed code data-categories attribute |
| Custom Container | Render the widget inside your own element instead of the default chatreact-faq div | Embed code data-container attribute |
| Kieli | Override the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language) | Embed code data-lang attribute |
| Accordion Behavior | Allow multiple FAQs open at once, or auto-expand the first FAQ | Dashboard → 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:
- Asentakaa mikä tahansa "Header/Footer Scripts" -lisäosa
- Lisätkää upotuskoodi footer-osioon
- Tallettakaa ja julkaiskaa
Shopify
Suositeltu: ChatReact Shopify App
Asentakaa ChatReact-sovellus Shopify App Storesta helpoimpaa integraatiota varten:
- Asentakaa ChatReact-sovellus Shopify-hallintanne kautta
- Syöttäkää Chatbot ID sovelluksen asetuksiin
- Chat-widget ilmestyy automaattisesti kauppanne etusivulle
- 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
- Siirtykää Online Store → Themes → Edit Code
- Avaa
theme.liquid - Lisää koodi ennen
</body> - Tallenna
Webflow
- Siirtykää Project Settings → Custom Code
- Lisätkää Footer Code -kohtaan
- 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:
- Käyttäkää Esikatselu-ominaisuutta kojelaudassanne
- Testatkaa eri skenaarioita
- 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
- Tarkastakaa selaimen konsoli virheilmoitusten varalta
- Varmistakaa chatbotin tunnus on oikein
- Varmistakaa, että chatbot on aktiivinen (ei poissa käytöstä)
- Tarkastakaa, häiritsevätkö mainostenesto-ohjelmat
- 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
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — upottakaa erillisiä lomakkeita lomake-widgetillä