ΑρχικήΤεκμηρίωση

Widget Embedding

Προσθέστε το AI chatbot σας σε οποιονδήποτε ιστότοπο σε δευτερόλεπτα με τον απλό κώδικα ενσωμάτωσης.

Quick Start

Προσθέστε αυτόν τον κώδικα πριν το κλείσιμο του </body> tag:

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

Αυτό είναι! Το chatbot σας είναι πλέον ενεργό στον ιστότοπό σας.

Finding Your Chatbot ID

  1. Μεταβείτε στις ρυθμίσεις του chatbot σας
  2. Πλοηγηθείτε στην καρτέλα Ενσωμάτωση
  3. Αντιγράψτε τον κώδικα ενσωμάτωσης (περιλαμβάνει το ID σας)

Το ID του chatbot στον κώδικα ενσωμάτωσης δεν είναι το ίδιο με το όνομα στο URL του πίνακα ελέγχου σας. Πάντα αντιγράφετε το ID από την καρτέλα Ενσωμάτωση.

Customizing the Widget

Η εμφάνιση και η συμπεριφορά του widget ρυθμίζονται στον πίνακα ελέγχου σας — όχι στον κώδικα ενσωμάτωσης. Μεταβείτε στο Dashboard → Chatbots → [your chatbot] → Widget για να προσαρμόσετε:

  • Position — κάτω δεξιά, κάτω αριστερά ή inline
  • Colors — κύρια, φόντο και χρώματα κειμένου, καθώς και ακτίνα περιγράμματος
  • Μέγεθος — πλάτος και ύψος του widget

Για να ανοίγει το chat αυτόματα μετά από καθορισμένη καθυστέρηση, ενεργοποιήστε το Αυτόματο Άνοιγμα στην καρτέλα Συμπεριφορά της ίδιας σελίδας ρυθμίσεων. Σε white-label πλάνα, το branding του ChatReact είναι κρυφό από προεπιλογή — η ίδια καρτέλα Συμπεριφορά διαθέτει toggle Show "Powered by ChatReact" αν θέλετε να το εμφανίσετε στο υποσέλιδο του widget ούτως ή άλλως.

Οι αλλαγές εφαρμόζονται αυτόματα στον ιστότοπό σας — δεν χρειάζεται να ενημερώσετε τον κώδικα ενσωμάτωσης. Δείτε τον οδηγό Widget Customization για όλες τις διαθέσιμες επιλογές.

Η γλώσσα του widget ανιχνεύεται αυτόματα από το πρόγραμμα περιήγησης κάθε επισκέπτη, με βάση τις γλώσσες που ενεργοποιείτε στην καρτέλα Γλώσσες του chatbot σας.

Επιλέξτε τη θέση Inline για να ενσωματώσετε το chat απευθείας στη σελίδα στο σημείο όπου τοποθετείται το tag του script. Το widget είναι πάντα ανοιχτό, χωρίς bubble ή κουμπί κλεισίματος — ιδανικό για αφιερωμένες σελίδες συνομιλίας ή ενότητες υποστήριξης.

FAQ Widget

Εμφανίστε Συχνές Ερωτήσεις ως accordion σε οποιαδήποτε σελίδα:

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

Το FAQ widget εμφανίζει τις δημοσιευμένες FAQs από το chatbot σας. Τα χρώματα και το στυλ (κύριο, φόντο και χρώματα κειμένου, ακτίνα περιγράμματος) ρυθμίζονται στο Πίνακας ελέγχου → Συχνές Ερωτήσεις → Ρυθμίσεις.

FAQ Widget Options

SettingDescriptionWhere to Configure
Colors & StylingΚύρια, φόντο και χρώματα κειμένου, ακτίνα περιγράμματοςDashboard → FAQs → Settings
ΠλάτοςΕπιλογή μεταξύ 100% (πλήρες πλάτος) ή προσαρμοσμένου pixel πλάτους (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderΣειρά εμφάνισης: Date (νέες πρώτες), Name (αλφαβητικά) ή Custom (χειροκίνητο drag & drop)Dashboard → FAQs → Settings → Behavior
Φίλτρο κατηγορίαςΕμφάνιση μόνο συγκεκριμένων κατηγοριών στο widgetEmbed code data-categories attribute
Custom ContainerΑποδοχή του widget μέσα σε δικό σας στοιχείο αντί για το προεπιλεγμένο div chatreact-faqEmbed code data-container attribute
ΓλώσσαΠαράκαμψη της γλώσσας του widget (προεπιλογή στο <html lang> attribute της σελίδας σας, μετά στη γλώσσα του προγράμματος περιήγησης του επισκέπτη)Embed code data-lang attribute
Accordion BehaviorΝα επιτρέπεται το άνοιγμα πολλαπλών FAQs ταυτόχρονα, ή αυτόματη επέκταση της πρώτης FAQDashboard → 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>

Όταν το widget φιλτράρεται σε μία κατηγορία, η σειρά αυτής της κατηγορίας (ορισμένη στο Dashboard → FAQs → Categories) υπερισχύει της παγκόσμιας ρύθμισης σειράς.

Mobile Optimization

Το chat widget είναι πλήρως βελτιστοποιημένο για κινητές συσκευές:

  • Διάταξη πλήρους πλάτους σε μικρές οθόνες
  • Σύνθλιψη με κινούμενη μετάβαση κατά το άνοιγμα
  • Χειρισμός πληκτρολογίου σε iOS (το widget προσαρμόζεται στο πληκτρολόγιο οθόνης)
  • Υποστήριξη safe-area για το notch και το home indicator του iPhone
  • Μεγαλύτεροι στόχοι αφής για καλύτερη χρηστικότητα
  • Το μέγεθος γραμματοσειράς εισαγωγής αποτρέπει το auto-zoom σε iOS

Platform-Specific Guides

WordPress

Recommended: Χρησιμοποιήστε το επίσημο ChatReact WordPress Plugin για την ευκολότερη ενσωμάτωση με Gutenberg blocks, Elementor widgets και shortcodes.

Alternative: Χειροκίνητη ενσωμάτωση μέσω plugin «Header/Footer Scripts»:

  1. Εγκαταστήστε οποιοδήποτε plugin «Header/Footer Scripts»
  2. Προσθέστε τον κώδικα ενσωμάτωσης στο footer
  3. Αποθηκεύστε και δημοσιεύστε

Shopify

Recommended: ChatReact Shopify App

Εγκαταστήστε την εφαρμογή ChatReact από το Shopify App Store για την ευκολότερη ενσωμάτωση:

  1. Εγκαταστήστε την εφαρμογή ChatReact στο Shopify admin σας
  2. Εισάγετε το Chatbot ID σας στις ρυθμίσεις της εφαρμογής
  3. Το chat widget εμφανίζεται αυτόματα στο storefront σας
  4. Διαχειριστείτε τις αναθέσεις widget ανά σελίδα, ή ενεργοποιήστε το παντού

Η εφαρμογή υποστηρίζει επίσης Form και FAQ widgets ως App Blocks στον Theme Editor.

Alternative: Manual Embed

  1. Μεταβείτε σε Online Store → Themes → Edit Code
  2. Ανοίξτε theme.liquid
  3. Προσθέστε κώδικα πριν το </body>
  4. Αποθηκεύστε

Webflow

  1. Μεταβείτε σε Project Settings → Custom Code
  2. Προσθέστε στο Footer Code
  3. Δημοσιεύστε τον ιστότοπο

Next.js / React

Χρησιμοποιήστε το Script component:

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

Προσθέστε στο κύριο App.vue ή στο 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

Αλληλεπιδράστε με το widget προγραμματικά:

// 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

Πριν την ζωντανή ενσωμάτωση:

  1. Χρησιμοποιήστε τη λειτουργία Προεπισκόπηση στον πίνακα ελέγχου σας
  2. Δοκιμάστε διάφορα σενάρια
  3. Επαληθεύστε ότι οι απαντήσεις είναι ακριβείς

Δοκιμάζετε σε τοπικό development site; Χρησιμοποιήστε τον τυπικό κώδικα ενσωμάτωσης χωρίς αλλαγές — λειτουργεί και σε localhost σελίδες.

Troubleshooting

Widget Not Appearing

  1. Ελέγξτε την κονσόλα του προγράμματος περιήγησης για σφάλματα
  2. Επιβεβαιώστε ότι το chatbot ID είναι σωστό
  3. Βεβαιωθείτε ότι το chatbot είναι ενεργό (όχι απενεργοποιημένο)
  4. Ελέγξτε αν μπλοκάρουν διαφημίσεις (ad blockers)
  5. Ελέγξτε τη χρήση του πλάνου σας — το widget διακόπτεται όταν φτάσετε το μηνιαίο όριο του πλάνου σας

Caching & Optimization Plugins

Ορισμένα plugins caching ή βελτιστοποίησης σεναρίων ξαναγράφουν τα URLs των script, κάτι που μπορεί να σταματήσει τη φόρτωση του widget. Αν συμβεί αυτό, προσθέστε ρητά ένα API URL στο tag του 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>

Το ίδιο attribute λειτουργεί και στα scripts του FAQ και του form widget.

Styling Conflicts

Αν το CSS του ιστότοπού σας συγκρούεται:

  • Το widget περιορίζει τα στυλ του στο δικό του container και χρησιμοποιεί κανόνες υψηλής προτεραιότητας για να αντισταθεί στις συγκρούσεις
  • Ελέγξτε τις τιμές z-index των στοιχείων που επικαλύπτουν το widget
  • Αποφύγετε ευρείς κανόνες !important στο CSS του site σας που στοχεύουν γενικά στοιχεία

Performance

Το widget έχει σχεδιαστεί για ελάχιστο αντίκτυπο:

  • Φορτώνει ασύγχρονα — δεν μπλοκάρει ποτέ το render της σελίδας
  • Ελαφρύ: περίπου 30 KB συμπιεσμένη μεταφορά

Next Steps