BaileDoiciméadú

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ú

  1. Téigh chuig socruithe do chatbot
  2. Seol chuig an táb Ionsáigh
  3. 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íosCá háit le Socrú
Dathanna & StíleáilDathanna príomhúla, cúlra agus téacs, leithead an bhfrithchróDashboard → FAQs → Settings
LeitheadRoghnaigh idir 100% (leithead iomlán) nó leithead picteilín saincheaptha (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderOrdú 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óireTaispeáin catagóirí shonracha amháin sa widgetEmbed code data-categories attribute
Coimeádán SaincheapthaRindreáil an widget laistigh de do eilimint féin seachas an div réamhshocraithe chatreact-faqEmbed code data-container attribute
TeangaRó-údarú teanga an widget (réamhshocraithe chuig airteagal <html lang> do leathanach, ansin teanga bhrabhsálaí an chuairteora)Embed code data-lang attribute
Iompar AccordionCeadaigh 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":

  1. Suiteáil aon plugin "Header/Footer Scripts"
  2. Cuir an cód ionchuir sa chuid footer
  3. 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:

  1. Suiteáil an aip ChatReact i do riarachán Shopify
  2. Cuir do Chatbot ID isteach i socruithe an aip
  3. Léireoidh an widget comhrá go huathoibríoch ar do siopa
  4. 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

  1. Téigh chuig Online Store → Themes → Edit Code
  2. Oscail theme.liquid
  3. Cuir cód roimh </body>
  4. Sábháil

Webflow

  1. Téigh chuig Project Settings → Custom Code
  2. Cuir le Footer Code
  3. 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:

  1. Bain úsáid as an ghné Réamhamharc i do dashboard
  2. Déan tástáil ar chásanna éagsúla
  3. 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

  1. Seiceáil consól an bhrabhsálaí le haghaidh earráidí
  2. Deimhnigh go bhfuil ID an chatbot ceart
  3. Cinntigh go bhfuil an chatbot gníomhach (níl díghníomhachtaithe)
  4. Seiceáil an bhfuil blocálaithe fógraí ag cur isteach
  5. 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 !important leathan 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