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
- Μεταβείτε στις ρυθμίσεις του chatbot σας
- Πλοηγηθείτε στην καρτέλα Ενσωμάτωση
- Αντιγράψτε τον κώδικα ενσωμάτωσης (περιλαμβάνει το 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
| Setting | Description | Where 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 |
| Φίλτρο κατηγορίας | Εμφάνιση μόνο συγκεκριμένων κατηγοριών στο widget | Embed code data-categories attribute |
| Custom Container | Αποδοχή του widget μέσα σε δικό σας στοιχείο αντί για το προεπιλεγμένο div chatreact-faq | Embed code data-container attribute |
| Γλώσσα | Παράκαμψη της γλώσσας του widget (προεπιλογή στο <html lang> attribute της σελίδας σας, μετά στη γλώσσα του προγράμματος περιήγησης του επισκέπτη) | Embed code data-lang attribute |
| Accordion Behavior | Να επιτρέπεται το άνοιγμα πολλαπλών FAQs ταυτόχρονα, ή αυτόματη επέκταση της πρώτης FAQ | Dashboard → 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»:
- Εγκαταστήστε οποιοδήποτε plugin «Header/Footer Scripts»
- Προσθέστε τον κώδικα ενσωμάτωσης στο footer
- Αποθηκεύστε και δημοσιεύστε
Shopify
Recommended: ChatReact Shopify App
Εγκαταστήστε την εφαρμογή ChatReact από το Shopify App Store για την ευκολότερη ενσωμάτωση:
- Εγκαταστήστε την εφαρμογή ChatReact στο Shopify admin σας
- Εισάγετε το Chatbot ID σας στις ρυθμίσεις της εφαρμογής
- Το chat widget εμφανίζεται αυτόματα στο storefront σας
- Διαχειριστείτε τις αναθέσεις widget ανά σελίδα, ή ενεργοποιήστε το παντού
Η εφαρμογή υποστηρίζει επίσης Form και FAQ widgets ως App Blocks στον Theme Editor.
Alternative: Manual Embed
- Μεταβείτε σε Online Store → Themes → Edit Code
- Ανοίξτε
theme.liquid - Προσθέστε κώδικα πριν το
</body> - Αποθηκεύστε
Webflow
- Μεταβείτε σε Project Settings → Custom Code
- Προσθέστε στο Footer Code
- Δημοσιεύστε τον ιστότοπο
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
Πριν την ζωντανή ενσωμάτωση:
- Χρησιμοποιήστε τη λειτουργία Προεπισκόπηση στον πίνακα ελέγχου σας
- Δοκιμάστε διάφορα σενάρια
- Επαληθεύστε ότι οι απαντήσεις είναι ακριβείς
Δοκιμάζετε σε τοπικό development site; Χρησιμοποιήστε τον τυπικό κώδικα ενσωμάτωσης χωρίς αλλαγές — λειτουργεί και σε localhost σελίδες.
Troubleshooting
Widget Not Appearing
- Ελέγξτε την κονσόλα του προγράμματος περιήγησης για σφάλματα
- Επιβεβαιώστε ότι το chatbot ID είναι σωστό
- Βεβαιωθείτε ότι το chatbot είναι ενεργό (όχι απενεργοποιημένο)
- Ελέγξτε αν μπλοκάρουν διαφημίσεις (ad blockers)
- Ελέγξτε τη χρήση του πλάνου σας — το 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
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — ενσωμάτωση ανεξάρτητων φορμών με το form widget