Ionchur Widget
Cuir do chatbot AI in áit ar bith ar shuíomh Gréasáin i gceann soicindí leis an gcód ionchuir simplí seo.
Tús gasta
Cuir an cód seo roimh an gcluasán </body>:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Sin uile é! Tá do chatbot beo anois ar do shuíomh Gréasáin.
Conas Do Chatbot ID a Aimsiú
- Téigh chuig socruithe do chatbot
- Seol chuig an táb Ionsáigh
- Cóipeáil an cód ionchuir (cuimsíonn sé do ID)
Níl an ID chatbot sa chód ionchuir mar an gcéanna leis an ainm sa URL do d'arraingaire. Cóipeáil an ID i gcónaí ón táb Ionsáigh.
Ag Saincheapadh an Widget
Socraítear cuma agus iompar an widget i do dashboard — ní sa chód ionchuir. Téigh go Dashboard → Chatbots → [your chatbot] → Widget chun a choigeartú:
- Position — bun-deas, bun-chlé, nó inline
- Colors — dathanna príomhúil, cúlra agus téacs, agus leithead an bhfrithchró
- Méid — leithead agus airde an widget
Chun an comhrá a oscailt go huathoibríoch tar éis moill inathraithe, cumasaigh Oscail Uathoibríoch sa táb Iompar ar an leathanach socruithe céanna. Ar phleananna white-label, tá branda ChatReact i bhfolach de réir réamhshocraithe — tá lasc Show "Powered by ChatReact" sa táb Iompar mura dteastaíonn uait é a thaispeáint fós i bhfráma an widget.
Cuirtear na hathruithe i bhfeidhm go huathoibríoch ar do shuíomh Gréasáin — ní gá an cód ionchuir a nuashonrú. Féach an treoir Widget Customization le haghaidh na roghanna go léir atá ar fáil.
Braitear teanga an widget go huathoibríoch bunaithe ar bhrabhsálaí gach cuairteora, bunaithe ar na teangacha a ghníomhachtaíonn sibh i dtáb Teangacha do chatbot.
Roghnaigh an suíomh Inline chun an comhrá a ionchur go díreach sa leathanach ag an áit a gcuirtear an script tag. Bíonn an widget i gcónaí oscailte, gan bubblóg ná cnaipe dúnadh — oiriúnach do leathanaigh tiomnaithe comhrá nó do chuid tacaíochta.
Widget FAQ
Taispeáin Ceisteanna Coitianta 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"
async
></script>
Taispeánann an widget FAQ na Ceisteanna Coitianta foilsithe ó do chatbot. Socraítear dathanna agus stíleanna (príomhúil, cúlra agus téacs, leithead an bhfrithchró) i Painéal → Ceisteanna Coitianta → Socruithe.
Roghanna an Widget FAQ
| Socrú | Cur síos | Cá háit le Socrú |
|---|---|---|
| Dathanna & Stíleáil | Dathanna príomhúla, cúlra agus téacs, leithead an bhfrithchró | Dashboard → FAQs → Settings |
| Leithead | Roghnaigh idir 100% (leithead iomlán) nó leithead picteilín saincheaptha (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Ordú taispeána: Dáta (nua is sine ar dtús), Ainm (aibítire), nó Saincheaptha (tarraingt agus titim láimhe) | Dashboard → FAQs → Settings → Behavior |
| Scagaire catagóire | Taispeáin catagóirí shonracha amháin sa widget | Embed code data-categories attribute |
| Coimeádán Saincheaptha | Rindreáil an widget laistigh de do eilimint féin seachas an div réamhshocraithe chatreact-faq | Embed code data-container attribute |
| Teanga | Ró-údarú teanga an widget (réamhshocraithe chuig airteagal <html lang> do leathanach, ansin teanga bhrabhsálaí an chuairteora) | Embed code data-lang attribute |
| Iompar Accordion | Ceadaigh go bhfuil il-FAQs oscailte ag an am céanna, nó uathoibriúchán chun an chéad FAQ a leathnú | Dashboard → FAQs → Settings → Behavior |
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>
Nuair atá an widget scagtha chuig catagóir amháin, tá ordú shonrach na catagóire sin (a leagadh síos i Dashboard → FAQs → Categories) níos tábhachtaí ná an socrú ordaithe domhanda.
Otiomáisiún Soghluaiste
Tá an widget comhrá lán-oiriúnaithe do ghléasanna soghluaiste:
- Dearadh le leithead iomlán ar scáileáin bheaga
- Beochan sleamhnaithe suas nuair a osclaítear
- Láimhseáil méarchláir iOS (réitíonn an widget don mhéarchlár ar an scáileán)
- Tacaíocht limistéir shábháilte do notch agus táscaire baile iPhone
- Spriocanna tadhaill níos mó le húsáid níos fearr
- Méid cló ionchuir a choscann uathoimriú-zúm iOS
Treoracha ar Leas-ardán Sonrach
WordPress
Moltar: Bain úsáid as an ChatReact WordPress Plugin oifigiúil chun an comhtháthú is éasca le bloic Gutenberg, widgets Elementor agus shortcodes a fháil.
Malairt: Ionchur láimhe trí plugin "Header/Footer Scripts":
- Suiteáil aon plugin "Header/Footer Scripts"
- Cuir an cód ionchuir sa chuid footer
- Sábháil agus foilsiú
Shopify
Moltar: ChatReact Shopify App
Suiteáil an aip ChatReact ón Shopify App Store chun an comhtháthú is éasca a fháil:
- Suiteáil an aip ChatReact i do riarachán Shopify
- Cuir do Chatbot ID isteach i socruithe an aip
- Léireoidh an widget comhrá go huathoibríoch ar do siopa
- Bainistigh tascanna widget in aghaidh leathanach, nó cumasaigh é gach áit
Tacaíonn an aip freisin le Form agus FAQ widgets mar App Blocks sa Theme Editor.
Malairt: Ionchur Láimhe
- Téigh chuig Online Store → Themes → Edit Code
- Oscail
theme.liquid - Cuir cód roimh
</body> - Sábháil
Webflow
- Téigh chuig Project Settings → Custom Code
- Cuir le Footer Code
- Foilsigh an láithreán
Next.js / React
Bain úsáid as an comhpháirt Script:
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 le do phríomh App.vue nó le do 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>
API JavaScript
Idirghníomhú leis an widget go cláraithe:
// 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();
Tástáil
Mód Réamhamhairc
Sula gcuirtear beo an ionchur:
- Bain úsáid as an ghné Réamhamharc i do dashboard
- Déan tástáil ar chásanna éagsúla
- Dearbhaigh go bhfuil na freagraí cruinn
Ag tástáil ar shuíomh forbartha áitiúil? Bain úsáid as an cód ionchuir caighdeánach gan aon athrú — oibríonn sé ar leathanacha localhost freisin.
Dé-aistriúcháin
Níl an Widget le Feiceáil
- Seiceáil consól an bhrabhsálaí le haghaidh earráidí
- Deimhnigh go bhfuil ID an chatbot ceart
- Cinntigh go bhfuil an chatbot gníomhach (níl díghníomhachtaithe)
- Seiceáil an bhfuil blocálaithe fógraí ag cur isteach
- Seiceáil an úsáid phlean — stadann an widget nuair a shroicheann teorainn mhíosúil do phlean
Cuir isteach Cuir & Plugins Optamaithe
Athscríobhann cuid de na plugins taisceála nó optamaithe scriptanna URLanna script, rud a d'fhéadfadh stop a chur leis an widget ó luchtú. Más rud é sin a tharlaíonn, cuir URL API sainráite don script tag:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-api-url="https://www.chatreact.ai"
async
></script>
Oibreoidh an tréith chéanna ar na scriptí widget FAQ agus foirm freisin.
Coinbhleachtaí Stíleála
Má bhíonn comhthiontú CSS ar do shuíomh:
- Rialaíonn an widget a stíleanna laistigh dá choimeádán féin agus úsáideann sé rialacha arda-tosaíochta chun aghaidh a thabhairt ar choinbhleachtaí
- Seiceáil luachanna z-index d'eilimintí a chlúdaíonn an widget
- Seachain rialacha
!importantleathan i do CSS láithreán a bhraitheann ar eilimintí ginearálta
Feidhmíocht
Tá an widget deartha le tionchar an-íseal:
- Luchtú asínchrónach — ní chuirtear bac ar léiriú an leathanaigh riamh
- Éadrom: thart ar 30 KB a tharchur i gcomhbhrú
Céimeanna Eile
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — ionchur foirmeacha neamhspleácha leis an widget foirme