Ionsú Widget
Cuir do chatbot AI ar aon suíomh Gréasáin i gceann soicindí le ár gcód ionsúcháin simplí.
Tús Tapa
Cuir an cód seo leis roimh an lipéad dúnta </body>:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Sin é! Tá bhur chatbot anois beo ar bhur láithreán gréasáin.
Ag Aimsiú ID do Chatbot
- Téigh chuig socruithe bhur chatbot
- Téigh chuig an cluaisín Embed
- Cóipeáil an cód embed (a chuimsíonn bhur ID)
Nó faigh an ID i URL bhur dashboard:
/dashboard/company/chatbots/[CHATBOT_ID]
Roghanna Widget
Saincheap an widget trí data attributes:
Roghanna Bunúsacha
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-position="bottom-right"
data-language="en"
async
></script>
| Airíonna | Luachanna | Réamhshocrú |
|---|---|---|
data-position | bottom-right, bottom-left, inline | bottom-right |
data-language | Aon chód teanga | Aithint uathoibríoch |
data-open | true, false | false |
Úsáid data-position="inline" chun an widget comhrá a leabú go díreach sa leathanach san áit a gcuirtear an script. Beidh an widget oscailte i gcónaí, gan boilgeog ná cnaipe dúnta — oiriúnach do leathanaigh comhrá tiomnaithe nó rannanna tacaíochta.
Sáruithe Datha
Sárú socruithe an dashboard le dathanna inlíne:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-primary-color="#8B5CF6"
data-background-color="#0F172A"
data-text-color="#F1F5F9"
data-border-radius="24"
async
></script>
FAQ Widget
Taispeáin FAQs mar accordion ar aon leathanach:
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-primary-color="#8B5CF6"
data-background-color="#0F172A"
data-text-color="#F1F5F9"
data-border-radius="24"
async
></script>
Taispeánann an FAQ widget FAQs foilsithe ó do chatbot.
Roghanna FAQ Widget
| Socrú | Cur Síos | Cá hAit le Cumrú |
|---|---|---|
| Width | Roghnaigh idir 100% (leithead iomlán) nó leithead picteilín saincheaptha (400–1200px) | Dashboard → FAQs → Settings |
| Sort Order | Ord taispeána: Dáta (is nuaí ar dtús), Ainm (aibítreach), nó Saincheaptha (tarraing & scaoil de láimh) | Dashboard → FAQs → Settings → Behavior |
| Category Filter | Taispeáin catagóirí ar leith amháin sa widget | Tréith data-categories i gcód embed |
Sampla Scagaire Catagóire
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Optamú Soghluaiste
Tá an widget comhrá optamaithe go hiomlán do ghléasanna soghluaiste:
- Leagan amach lánleithead ar scáileáin bheaga
- Beochan sleamhnáin suas nuair a osclaítear
- Láimhseáil méarchlár iOS (coigeartaíonn an widget don mhéarchlár ar an scáileán)
- Tacaíocht safe-area do ghearrán agus táscaire baile iPhone
- Spriocanna tadhaill níos mó le haghaidh inúsáidteachta níos fearr
- Méid clófhoinn ionchur a choiscíonn uathmhéadú iOS
Treoracha Sonracha don Ardán
WordPress
Molta: Bain úsáid as an Breiseán WordPress ChatReact oifigiúil le haghaidh an chomhtháthaithe is éasca le bloic Gutenberg, giuirléidí Elementor, agus giorrchóid.
Malartach: Ionsú láimhe trí bhreiseán "Header/Footer Scripts":
- Suiteáil aon bhreiseán "Header/Footer Scripts"
- Cuir an embed code sa rannóg footer
- Sábháil agus foilseachain
Shopify
Molta: Aip Shopify ChatReact
Suiteáil an aip ChatReact ó Shopify App Store le haghaidh an chomhtháthaithe is éasca:
- Suiteáil an aip ChatReact in do admin Shopify
- Cuir isteach do Chatbot ID i socruithe na haipe
- Taispeánann an widget comhrá go huathoibríoch ar do storáil
- Bainistigh sannadh widget in aghaidh gach leathanaigh, nó cumasaigh é i ngach áit
Tacaíonn an aip freisin le Giuirléidí Foirme agus FAQ mar Bhloic Aipe san Eagarthóir Téama.
Malartach: Ionsú Láimhe
- Téigh chuig Online Store → Themes → Edit Code
- Oscail
theme.liquid - Cuir an cód roimh
</body> - Sábháil
Webflow
- Téigh chuig Project Settings → Custom Code
- Cuir é sa Footer Code
- Foilsigh an suíomh
Next.js / React
Bain úsáid as an Script component:
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
Cuir é i bhur príomh-App.vue nó i bhur leagan amach:
<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
Idirghníomhaigh leis an widget go cláraitheach:
// Open the chat
ChatReact.open();
// Close the chat
ChatReact.close();
// Toggle open/closed
ChatReact.toggle();
// Send a message
ChatReact.sendMessage('Hello!');
// Set user data
ChatReact.setUser({
name: 'John Doe',
email: '[email protected]'
});
Tástáil
Preview Mode
Sula gcuirfear isteach beo:
- Bain úsáid as an ghné Preview i bhur dashboard
- Déan tástáil ar shcéalanna éagsúla
- Deimhnigh go bhfuil na freagraí cruinn
Local Development
Le haghaidh tástála áitiúil, bain úsáid as URLs localhost:
<script
src="http://localhost:3000/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Réiteach Fadhbanna
Ní Léirítear an Widget
- Seiceáil consól an brabhsálaí le haghaidh earráidí
- Déan a chinntiú go bhfuil an chatbot ID ceart
- Cinntigh go bhfuil an chatbot gníomhach (níl sé faoi mhíchumas)
- Seiceáil an bhfuil ad blockers ag cur isteach
Coinbhleachtaí Stíle
Má tá CSS do shuíomh ag teacht i gcoinne:
- Úsáideann an Widget shadow DOM chun ailtireacht a leithlisiú
- Seiceáil luachanna z-index
- Cinntigh nach bhfuil aon
!importantag déanamh overrides
Feidhmíocht
Tá an widget deartha le tionchar íosta:
- Lazy loaded
- < 50KB total size
- Non-blocking
- Cached aggressively