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
- Mur fis-settings tal-chatbot tiegħek
- Naviga lejn it-tab Embed
- 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
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Kulur primarju, sfond u test, radius tal-bord | Dashboard → FAQs → Settings |
| Wisa' | Agħżel bejn 100% (wisa' sħiħ) jew wisa' personalizzat f'pixels (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Ordni tal-wiri: Data (l-iktar riċenti l-ewwel), Isem (alfabetiku), jew Custom (manwalment drag & drop) | Dashboard → FAQs → Settings → Behavior |
| Filtru tal-kategorija | Uri biss kategoriji speċifiċi fil-widget | Embed code data-categories attribute |
| Custom Container | Rendi l-widget ġewwa l-element tiegħek stess minflok id-div default chatreact-faq | Embed code data-container attribute |
| Lingwa | Skorja 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 FAQ | Dashboard → 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":
- Installa kwalunkwe plugin "Header/Footer Scripts"
- Żid l-embed code fis-sezzjoni tal-footer
- Issejvja u ippubblika
Shopify
Rakkomandat: ChatReact Shopify App
Installa l-app ChatReact mill-Shopify App Store għall-integrazzjoni l-iktar faċli:
- Installa l-app ChatReact fl-amministrazzjoni Shopify tiegħek
- Daħħal l-ID tal-Chatbot tiegħek fis-settings tal-app
- Il-chat widget jidhir awtomatikament fuq il-frontstore tiegħek
- Ġ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
- Mur f'Online Store → Themes → Edit Code
- Iftaħ
theme.liquid - Żid il-kodiċi qabel
</body> - Issejvja
Webflow
- Mur f'Project Settings → Custom Code
- Żid fil-Footer Code
- 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:
- Uża l-karatteristika Preview fid-dashboard tiegħek
- Ittesta scenarji differenti
- 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
- Iċċekkja l-konsola tal-browser għal żbalji
- Ivverifika li l-ID tal-chatbot hu korrett
- Kun żgur li l-chatbot huwa attiv (mhuwiex diżattivat)
- Iċċekkja jekk ad blockers qed jinterferixxu
- 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
!importantfil-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
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — embed forms awtonomi bil-form widget