Paġna ewlenijaDokumentazzjoni

Widget Embedding

Żid il-chatbot AI tiegħek ma' kwalunkwe websayt fi ftit sekondi bl-embed code sempliċi tagħna.

Rapid Start

Żid dan il-kodiċi qabel it-tag tal-</body> jagħlaq:

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

Dak hu! Il-chatbot tiegħek issa huwa live fuq il-websajt tiegħek.

Kif Issib l-ID tal-Chatbot Tiegħek

  1. Mur fis-settings tal-chatbot tiegħek
  2. Naviga lejn it-tab Embed
  3. Kopja l-embed code (jinkludi l-ID tiegħek)

L-ID tal-chatbot fl-embed code mhuwiex l-istess bħan-ness fl-URL tad-dashboard tiegħek. Kopja dejjem l-ID mit-tab Embed.

Personalizzazzjoni tal-Widget

Il-wiċċ u l-imġieba tal-widget jiġu kkonfigurati fid-dashboard tiegħek — mhux fl-embed code. Mur f Dashboard → Chatbots → [your chatbot] → Widget biex taġġusta:

  • Position — t’isfel lemin, t’isfel xellug, jew inline
  • Colors — kulur primarju, sfond u test, plus radius tal-bord
  • Daqs — wisa' u għoli tal-widget

Biex tiftaħ il-chat awtomatikament wara dewmien konfigurabbli, ippermetti Jiftaħ Awtomatiku fit-tab Kondotta tal-istess paġna tas-settings. Fuq il-pjanijiet white-label, il-branding ta' ChatReact huwa moħbi b'default — l-istess tab Kondotta għandu toggle Show "Powered by ChatReact" jekk tixtieq turiha fil-footer tal-widget xorta waħda.

Iż-żmien tal-bidliet japplikaw awtomatikament għall-websajt tiegħek — m’hemmx bżonn taġġorna l-embed code. Ara l-gwida Widget Customization għat-testi kollha disponibbli.

Il-lingwa tal-widget tiġi skoperta awtomatikament mix-xibka tal-viżitatur, ibbażata fuq il-lingwi li tagħżel fit-tab Lingwi tal-chatbot tiegħek.

Agħżel il-pożizzjoni Inline biex tiddaħħal il-chat direttament fil-paġna fis-post fejn tinsab it-tag tas-script. Il-widget dejjem jkun miftuħ, mingħajr bubble jew buttuna ta' għalaq — ideali għal paġni ddedikat jew sezzjonijiet ta' appoġġ.

Widget tal-FAQ

Uri l-FAQs bħala accordion fuq kwalunkwe paġna:

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

Il-widget tal-FAQ juri l-FAQs ippubblikati mill-chatbot tiegħek. Kuluri u stil (primarju, sfond u test, radius tal-bord) jiġu kkonfigurati f'Dashboard → FAQs → Settings.

Għażliet tal-Widget tal-FAQ

SettingDescriptionWhere to Configure
Colors & StylingKulur primarju, sfond u test, radius tal-bordDashboard → FAQs → Settings
Wisa'Agħżel bejn 100% (wisa' sħiħ) jew wisa' personalizzat f'pixels (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderOrdni tal-wiri: Data (l-iktar riċenti l-ewwel), Isem (alfabetiku), jew Custom (manwalment drag & drop)Dashboard → FAQs → Settings → Behavior
Filtru tal-kategorijaUri biss kategoriji speċifiċi fil-widgetEmbed code data-categories attribute
Custom ContainerRendi l-widget ġewwa l-element tiegħek stess minflok id-div default chatreact-faqEmbed code data-container attribute
LingwaSkorja l-lingwa tal-widget (default għall-<html lang> attribute tal-paġna tiegħek, imbagħad il-lingwa tal-browser tal-viżitatur)Embed code data-lang attribute
Accordion BehaviorĦalli bosta FAQs miftuħa fl-istess ħin, jew awto-espandi l-ewwel FAQDashboard → FAQs → Settings → Behavior

Eżempju ta' Filter tal-Kategorija

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

Meta l-widget ikun filtrat għal kategorija waħda biss, l-ordni tas-sorting tal-kategorija tagħha (issettjat f'Dashboard → FAQs → Categories) jegħleb l-issettjar globali tas-sorting.

Ottimizzazzjoni għall-Mobile

Il-chat widget huwa ottimizzat kompletament għal apparati mobbli:

  • Layout b’wisa' sħiħa fuq skrins żgħar
  • Animasjoni ta' slide-up meta jinfetaħ
  • Ġestjoni tal-keyboard fuq iOS (il-widget jaġġusta għall-keyboard fuq l-iskrin)
  • Appoġġ għall-safe-area għall-notch u l-home indicator tal-iPhone
  • Miri ta' touch akbar għal aħjar użu
  • Daqs tal-font tal-input li jipprevjeni l-auto-zoom fuq iOS

Gwidi Skont il-Pjattaforma

WordPress

Rakkomandat: Uża l-ChatReact WordPress Plugin uffiċjali għall-integrazzjoni l-iktar faċli ma' Gutenberg blocks, Elementor widgets, u shortcodes.

Alternattiva: Embed manwali permezz ta' plugin "Header/Footer Scripts":

  1. Installa kwalunkwe plugin "Header/Footer Scripts"
  2. Żid l-embed code fis-sezzjoni tal-footer
  3. Issejvja u ippubblika

Shopify

Rakkomandat: ChatReact Shopify App

Installa l-app ChatReact mill-Shopify App Store għall-integrazzjoni l-iktar faċli:

  1. Installa l-app ChatReact fl-amministrazzjoni Shopify tiegħek
  2. Daħħal l-ID tal-Chatbot tiegħek fis-settings tal-app
  3. Il-chat widget jidhir awtomatikament fuq il-frontstore tiegħek
  4. Ġestixxi assegnazzjonijiet tal-widget għal kull paġna, jew ippermettiha kullimkien

L-app tappoġġja wkoll il-Form u l-FAQ widgets bħala App Blocks fil-Theme Editor.

Alternattiva: Embed Manwali

  1. Mur f'Online Store → Themes → Edit Code
  2. Iftaħ theme.liquid
  3. Żid il-kodiċi qabel </body>
  4. Issejvja

Webflow

  1. Mur f'Project Settings → Custom Code
  2. Żid fil-Footer Code
  3. Ippubblika s-sit

Next.js / React

Uża l-komponent 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

Żid fil-App.vue main tiegħek jew fil-layout:

<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

Interact mal-widget programmatikament:

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

Testjar

Modalità Preview

Qabel ma tniżżel live:

  1. Uża l-karatteristika Preview fid-dashboard tiegħek
  2. Ittesta scenarji differenti
  3. Ivverifika li r-risposti huma preċiżi

Qed tittestja fuq sit lokali ta' żvilupp? Uża l-embed code standard mingħajr bidla — jaħdem ukoll fuq paġni localhost.

Soluzzjonar tal-Problemi

Il-Widget Ma Jidhirx

  1. Iċċekkja l-konsola tal-browser għal żbalji
  2. Ivverifika li l-ID tal-chatbot hu korrett
  3. Kun żgur li l-chatbot huwa attiv (mhuwiex diżattivat)
  4. Iċċekkja jekk ad blockers qed jinterferixxu
  5. Iċċekkja l-użu tal-pjan tiegħek — il-widget jinqata' meta l-limitu mensili tal-pjan tiegħek jintlaħaq

Plugins ta' Caching & Ottimizzazzjoni

Xi plugins ta' caching jew ta' ottimizzazzjoni tal-scripts jibdlu l-URLs tas-script, li jistgħu jieqfu l-widget milli jitlesta. Jekk jiġri dan, żid URL API espliċitu fit-tag tas-script:

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

L-istess attribut jaħdem fuq il-scripts tal-FAQ u tal-form widget.

Kunflitti tal-Stil

Jekk il-CSS tas-sit tiegħek jikkonflitta:

  • Il-widget jispeċifika l-istili tiegħu fil-kontenitur u juża regoli b’priorità għolja biex jiffaċilita kontra kunflitti
  • Iċċekkja l-valuri z-index ta' elementi li jokkupaw il-widget
  • Evita regoli ġeneriċi !important fil-CSS tas-sit tiegħek li jimmiraw elementi ġeneriċi

Prestazzjoni

Il-widget ġie ddisinjat għal impatt minimali:

  • Jiġi jżomm asinkronament — qatt ma jimblokka r-rendering tal-paġna tiegħek
  • Lightweight: madwar 30 KB trasferiment kompress

Passi Li Jmiss