AcasăDocumentație

Widget Embedding

Adăugați chatbotul AI pe orice site în câteva secunde cu codul nostru simplu de încorporare.

Quick Start

Adăugați acest cod înainte de tagul de închidere </body>:

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

Asta este tot! Chatbotul dvs. este acum activ pe site.

Finding Your Chatbot ID

  1. Accesați setările chatbotului dvs.
  2. Navigați la fila Încorporare
  3. Copiați codul de încorporare (include ID-ul dvs.)

ID-ul chatbotului din codul de încorporare nu este același cu numele din URL-ul panoului dvs. de control. Copiați întotdeauna ID-ul din fila Încorporare.

Customizing the Widget

Aspectul și comportamentul widgetului se configurează în panoul dvs. de control — nu în codul de încorporare. Accesați Panoul de control → Chatbots → [chatbotul dvs.] → Widget pentru a ajusta:

  • Position — jos-dreapta, jos-stânga sau inline
  • Colors — culori primare, de fundal și ale textului, plus raza colțurilor
  • Dimensiune — lățimea și înălțimea widgetului

Pentru a deschide automat chatul după o întârziere configurabilă, activați Deschidere automată în fila Comportament de pe aceeași pagină de setări. Pe planurile white-label, brandingul ChatReact este ascuns implicit — aceeași filă Comportament are un comutator Show "Powered by ChatReact" dacă doriți să îl afișați în footerul widgetului oricum.

Modificările se aplică automat pe site-ul dvs. — nu este necesar să actualizați codul de încorporare. Consultați ghidul Widget Customization pentru toate opțiunile disponibile.

Limba widgetului este detectată automat din browserul fiecărui vizitator, pe baza limbilor pe care le activați în fila Limbi a chatbotului dvs.

Alegeți poziția Inline pentru a încorpora chatul direct în pagină în locul unde este plasat tagul script. Widgetul este întotdeauna deschis, fără bulă sau buton de închidere — ideal pentru pagini dedicate de chat sau secțiuni de suport.

FAQ Widget

Afișați întrebările frecvente ca un acordeon pe orice pagină:

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

Widgetul FAQ afișează FAQ-urile publicate din chatbotul dvs. Culorile și stilizarea (culoare primară, fundal și text, raza colțurilor) se configurează în Tablou de bord → Întrebări frecvente → Setări.

FAQ Widget Options

SettingDescriptionWhere to Configure
Colors & StylingCulori primare, de fundal și ale textului, raza colțurilorPanoul de control → FAQs → Settings
LățimeAlegeți între 100% (lățime completă) sau o lățime custom în pixeli (400–1200px)Panoul de control → FAQs → Settings
FAQ Sort OrderOrdinea afișării: Date (cele mai noi primele), Name (alfabetic), sau Custom (tragere manuală)Panoul de control → FAQs → Settings → Behavior
Filtru de categorieAfișați doar categorii specifice în widgetAtributul data-categories din codul de încorporare
Custom ContainerRandarea widgetului în interiorul propriului element în loc de div-ul implicit chatreact-faqAtributul data-container din codul de încorporare
LimbăSuprascrie limba widgetului (implicit folosește atributul <html lang> al paginii, apoi limba browserului vizitatorului)Atributul data-lang din codul de încorporare
Accordion BehaviorPermite mai multe FAQ-uri deschise simultan sau auto-extinderea primei FAQPanoul de control → FAQs → Settings → Behavior

Category Filter Example

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

Când widgetul este filtrat pe o singură categorie, ordinea specifică acelei categorii (setată în Panoul de control → FAQs → Categories) înlocuiește setarea globală de sortare.

Mobile Optimization

Widgetul de chat este complet optimizat pentru dispozitive mobile:

  • Layout pe întreaga lățime pe ecrane mici
  • Animație slide-up la deschidere
  • Gestionare a tastaturii iOS (widgetul se ajustează la tastatura de pe ecran)
  • Suport pentru zona sigură (notch și indicatorul de start) pe iPhone
  • Ținte touch mai mari pentru o utilizare mai bună
  • Dimensiunea fontului input previne auto-zoom-ul iOS

Platform-Specific Guides

WordPress

Recomandat: Utilizați oficialul ChatReact WordPress Plugin pentru cea mai simplă integrare cu blocuri Gutenberg, widgeturi Elementor și shortcode-uri.

Alternativă: Încorporare manuală printr-un plugin „Header/Footer Scripts”:

  1. Instalați orice plugin „Header/Footer Scripts”
  2. Adăugați codul de încorporare în secțiunea footer
  3. Salvați și publicați

Shopify

Recommended: ChatReact Shopify App

Instalați aplicația ChatReact din Shopify App Store pentru cea mai simplă integrare:

  1. Instalați aplicația ChatReact în adminul Shopify
  2. Introduceți ID-ul Chatbotului în setările aplicației
  3. Widgetul de chat apare automat pe vitrina dvs.
  4. Gestionați atribuirea widgetului pe pagini sau activați-l peste tot

Aplicația suportă, de asemenea, widgeturi Form și FAQ ca App Blocks în Theme Editor.

Alternative: Manual Embed

  1. Accesați Online Store → Themes → Edit Code
  2. Deschideți theme.liquid
  3. Adăugați codul înainte de </body>
  4. Salvați

Webflow

  1. Accesați Project Settings → Custom Code
  2. Adăugați în Footer Code
  3. Publicați site-ul

Next.js / React

Utilizați componenta 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

Adăugați în fișierul principal App.vue sau în 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

Interacționați programatic cu widgetul:

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

Testing

Preview Mode

Înainte de a încorpora live:

  1. Folosiți funcționalitatea Previzualizare din panoul dvs. de control
  2. Testați diferite scenarii
  3. Verificați dacă răspunsurile sunt corecte

Testați pe un site de dezvoltare local? Folosiți codul standard de încorporare fără modificări — funcționează și pe pagini localhost.

Troubleshooting

Widget Not Appearing

  1. Verificați consola browserului pentru erori
  2. Verificați dacă ID-ul chatbotului este corect
  3. Asigurați-vă că chatbotul este activ (nu este dezactivat)
  4. Verificați dacă blocatoarele de reclame interferează
  5. Verificați utilizarea planului — widgetul se întrerupe când limita lunară a planului este atinsă

Caching & Optimization Plugins

Unele pluginuri de cache sau de optimizare a scripturilor rescriu URL-urile scripturilor, ceea ce poate opri încărcarea widgetului. Dacă se întâmplă asta, adăugați un URL API explicit în tagul 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>

Același atribut funcționează pentru scripturile widgeturilor FAQ și form.

Styling Conflicts

Dacă CSS-ul site-ului dvs. intră în conflict:

  • Widgetul își restrânge stilurile la propriul container și folosește reguli cu prioritate ridicată pentru a rezista conflictelor
  • Verificați valorile z-index ale elementelor care se suprapun peste widget
  • Evitați regulile largi !important în CSS-ul site-ului care vizează elemente generice

Performance

Widgetul este proiectat pentru impact minim:

  • Se încarcă asincron — nu blochează randarea paginii
  • Ușor: aproximativ 30 KB transferați comprimat

Next Steps