For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/el/agent-configuration/website-widget.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
Website Widget
Το widget βάζει τον agent σας στον δικό σας ιστότοπο, ως φυσαλίδα συνομιλίας και φωνής. Οι επισκέπτες γράφουν ή μιλούν στον ίδιο agent που απαντά στο τηλέφωνό σας, με τις ίδιες οδηγίες, γνώσεις, εργαλεία και ροές. Παίρνετε επίσης έναν σύνδεσμο δοκιμής: μια σελίδα όπου οποιοσδήποτε μιλά με τον agent, πριν μπει το widget στον ιστότοπο.
Όλα γίνονται από την εφαρμογή ή από το Claude και το ChatGPT, χωρίς να ανοίξετε την εφαρμογή.
Πρώτη ρύθμιση
Ενότητα με τίτλο «Πρώτη ρύθμιση»-
Ενεργοποιήστε το widget
Ανοίξτε τον agent → Channels → Website Widget και ενεργοποιήστε τον διακόπτη. Όσο είναι ανενεργό, ο σύνδεσμος δοκιμής γράφει This assistant isn’t available right now και το widget δεν φορτώνει στον ιστότοπο.
-
Δοκιμάστε τον σύνδεσμο
Embed & share → Shareable page link → Open. Ο σύνδεσμος είναι
https://app.voicelogica.ai/w/<agent id>. Ρωτήστε τον agent ό,τι ρωτούν συνήθως οι πελάτες. Τον ίδιο σύνδεσμο μπορείτε να τον στείλετε σε πελάτες με email, SMS ή Viber. -
Βάλτε το στον ιστότοπο
Embed & share → Add to your website → Copy. Ο κώδικας είναι δύο γραμμές:
<voice-logica-agent agent-id="<agent id>"></voice-logica-agent><script src="https://api.voicelogica.ai/widget/embed.js" async type="text/javascript"></script>Επικολλήστε τον πριν το
</body>σε όλες τις σελίδες. Σε WordPress, με ένα plugin για header και footer, στο πεδίο του footer. Σε Wix, Shopify ή Joomla, στη ρύθμιση για custom code ή footer scripts. -
Κλειδώστε το στο domain σας
Allowed domains: προσθέστε το hostname του ιστότοπου, π.χ.
example.com. Αφήστε ενεργό το Also allow www. variant αν ο ιστότοπος απαντά και στοwww.. Με κενή λίστα, οποιοσδήποτε ιστότοπος μπορεί να βάλει τον agent σας και να χρησιμοποιεί τις συνομιλίες του πακέτου σας.Ο σύνδεσμος δοκιμής λειτουργεί πάντα, ό,τι κι αν γράφει η λίστα.
-
Ταιριάξτε την εμφάνιση
Στο Appearance ορίζετε μέγεθος, γωνία της οθόνης, χρώματα και εικόνα. Το Live preview δείχνει το αποτέλεσμα πριν την αποθήκευση.
-
Επιβεβαιώστε
Ανοίξτε τον ιστότοπο σε ιδιωτικό παράθυρο, ανοίξτε τη φυσαλίδα και κάντε μια πραγματική ερώτηση. Η συνομιλία εμφανίζεται στις Calls με το κείμενο και τα αποτελέσματά της.
Άλλη θέση σε κινητό
Ενότητα με τίτλο «Άλλη θέση σε κινητό»Στο κινητό η φυσαλίδα μπορεί να καλύπτει μια σταθερή μπάρα του ιστότοπου, π.χ. το κουμπί Book now. Μετακινήστε την μόνο στα κινητά, χωρίς να αλλάξει η θέση της στον υπολογιστή:
- Ανοίξτε τον agent → Channels → Website Widget → Appearance (Εμφάνιση) → Θέση σε κινητό (Position on phones).
- Απόσταση από κάτω/πάνω σε κινητό: πόσα pixel πάνω από την κάτω άκρη (ή κάτω από την πάνω) θα εμφανίζεται η φυσαλίδα. Μια σταθερή μπάρα έχει συνήθως ύψος 60–90 px, οπότε ξεκινήστε με το ύψος της μπάρας συν 10–20 px, π.χ.
90. - Προαιρετικά: Απόσταση από το πλάι σε κινητό (pixel από την αριστερή ή δεξιά άκρη) και Γωνία σε κινητό, για άλλη γωνία μόνο στα κινητά.
- Ενεργοποιήστε την Προεπισκόπηση σε κινητό για να το δείτε και πατήστε Save. Ανοίξτε τον ιστότοπο από κινητό (ή στην προβολή κινητού του browser) και ανανεώστε τη σελίδα.
Ισχύει σε οθόνες έως 767 px. Αν αφήσετε ένα πεδίο κενό (Όπως στον υπολογιστή), κρατά τη ρύθμιση του υπολογιστή.
Μετάβαση σε άλλη σελίδα
Ενότητα με τίτλο «Μετάβαση σε άλλη σελίδα»Μια γραπτή συνομιλία συνεχίζεται σε όλες τις σελίδες του ιστότοπου, με το ιστορικό της, μέχρι ο επισκέπτης να πατήσει End chat ή να μη γράψει τίποτα για περισσότερο από το Inactivity (τουλάχιστον 30 λεπτά). Στην επόμενη σελίδα το widget μένει όπως το άφησε ο επισκέπτης: κλειστό αν το είχε κλείσει, ανοιχτό αν ήταν ανοιχτό. Είναι η ίδια συνομιλία, άρα χρεώνεται ένα chat session και όχι ένα ανά σελίδα.
Δικά σας κουμπιά
Ενότητα με τίτλο «Δικά σας κουμπιά»Ένα κουμπί στη σελίδα σας μπορεί να ανοίξει το widget και να ρωτήσει κάτι τον agent, π.χ. Περίληψη του άρθρου σε ένα άρθρο του blog. Συνεχίζει τη συνομιλία του επισκέπτη αν υπάρχει ήδη και ξεκινά νέα μόνο αν δεν υπάρχει.
<button onclick="window.dispatchEvent(new CustomEvent('voicelogica:ask', { detail: { text: 'Κάνε μου περίληψη του άρθρου', url: location.href }}))">Ρωτήστε τον βοηθό</button>| Πεδίο | Τι κάνει |
|---|---|
text | Η ερώτηση. Εμφανίζεται ως μήνυμα του επισκέπτη. |
url | Προαιρετικό. Προστίθεται σε δική του γραμμή, ώστε ο agent να ξέρει για ποια σελίδα είναι η ερώτηση. |
send | Προαιρετικό. Με false απλώς συμπληρώνεται το πεδίο μηνύματος και ο επισκέπτης το διορθώνει και το στέλνει. Προεπιλογή true. |
agentId | Προαιρετικό. Χρειάζεται μόνο όταν η σελίδα έχει περισσότερα από ένα widget. |
Αν έχετε αναφορά στο στοιχείο, καλείτε το ίδιο απευθείας: document.querySelector('voice-logica-agent').ask({ text, url }). Υπάρχουν επίσης τα .open() και .close().
Αν είναι ενεργά το Caller verification ή οι Όροι, ο επισκέπτης τα συμπληρώνει πρώτα και η ερώτηση στέλνεται αμέσως μετά.
Σύνδεσμοι στις απαντήσεις του agent
Ενότητα με τίτλο «Σύνδεσμοι στις απαντήσεις του agent»Για λόγους ασφάλειας, ένας σύνδεσμος σε απάντηση είναι ενεργός μόνο αν ο τομέας του υπάρχει στη λίστα Τομείς ενεργών συνδέσμων (Website Widget → Interface). Οποιοσδήποτε άλλος σύνδεσμος εμφανίζεται διαγραμμένος και δεν πατιέται. Με κενή λίστα, που είναι η προεπιλογή, κανένας σύνδεσμος δεν είναι ενεργός.
- Προσθέστε κάθε τομέα στον οποίο μπορεί να παραπέμπει ο agent, π.χ.
example.comκαιhihello.com. Η αντιστοίχιση είναι ακριβής: τοexample.comδεν καλύπτει τοshop.example.com, οπότε προσθέστε και αυτό. - Το Επιτρέψτε επίσης το www. για αυτούς τους τομείς (ενεργό από προεπιλογή) κάνει το
example.comνα καλύπτει και τοwww.example.com. - Το Να επιτρέπονται και σύνδεσμοι http:// αφορά μόνο ιστότοπους χωρίς https. Δεν ενεργοποιεί κανέναν σύνδεσμο από μόνο του: ο τομέας πρέπει να είναι στη λίστα.
Από το Claude: update_agent_settings, section widget, { "interface": { "markdownAllowedDomains": ["example.com", "hihello.com"] } }.
Από το Claude ή το ChatGPT
Ενότητα με τίτλο «Από το Claude ή το ChatGPT»Με συνδεδεμένο το Voice Logica, ζητήστε απλά: «Ενεργοποίησε το chat στον ιστότοπο για τον agent μου και δώσε μου τον κώδικα.»
- Το
update_agent_settingsμε sectionwidgetκαι{ "enabled": true }το ενεργοποιεί. Αν δεν δώσετε domains, κλειδώνει στον ιστότοπο του προφίλ της εταιρείας. Η απάντηση περιέχει τον σύνδεσμο δοκιμής και τον κώδικα ενσωμάτωσης. - Το
get_agent_settingsμε sectionwidgetεπιστρέφει τον ίδιο σύνδεσμο και κώδικα, και τις τρέχουσες ρυθμίσεις. - Το
test_in_browserεπιστρέφει τον σύνδεσμο δοκιμής και τον κώδικα, και ενεργοποιεί το widget αν ήταν ανενεργό.
Domains, χρώματα, θέση και πεδία πριν τη συνομιλία αλλάζουν με τον ίδιο τρόπο, π.χ. { "allowedDomains": ["example.com"] } ή { "styling": { "placement": "bottom-left" } }.
Ταυτοποίηση επισκεπτών
Ενότητα με τίτλο «Ταυτοποίηση επισκεπτών»Το Caller verification ζητά email ή κινητό πριν ξεκινήσει η συνομιλία και μπορεί να το επιβεβαιώσει με κωδικό (ο κωδικός SMS λειτουργεί για ελληνικά και κυπριακά κινητά). Ενεργοποιήστε το Actions need a verified visitor όταν ο agent δημιουργεί παραγγελίες, ραντεβού ή αιτήματα: όσοι δεν επιβεβαιώθηκαν μπορούν μόνο να κάνουν ερωτήσεις.
Οι τιμές φτάνουν στον agent ως μεταβλητές, οπότε ένας υφιστάμενος πελάτης αναγνωρίζεται όπως και στο τηλέφωνο.
Μόνο γραπτό chat
Ενότητα με τίτλο «Μόνο γραπτό chat»Για συνομιλία μόνο με γραπτά, ανοίξτε τον agent → Widget → Συμπεριφορά, απενεργοποιήστε τη Φωνητική συνομιλία και πατήστε Αποθήκευση. Το κουμπί κλήσης και η «Νέα κλήση» δεν εμφανίζονται πια στο widget και στη σελίδα κοινής χρήσης, και η πλατφόρμα απορρίπτει φωνητικές συνεδρίες για αυτόν τον agent, ακόμη κι αν κάποιος καλέσει απευθείας τη διεύθυνση του widget.
Όσο ο agent ετοιμάζει απάντηση, η συνομιλία δείχνει ένα συννεφάκι με κινούμενες τελείες και το κείμενο της Ένδειξης πληκτρολόγησης. Το κείμενο αλλάζει στον agent → Widget → Κείμενα & ετικέτες → Ένδειξη πληκτρολόγησης.
Για agent που δεν πρέπει να δέχεται καθόλου κλήσεις, κλείστε και το PIN της γραμμής δοκιμών: Δοκιμή agent → αποεπιλέξτε το Κλήσεις με το PIN στη γραμμή δοκιμών → Αποθήκευση. Δείτε Ο πρώτος σας agent. Ένας agent δέχεται τηλεφωνικές κλήσεις μόνο από τους αριθμούς που του συνδέετε, οπότε ένας agent chat χωρίς αριθμό και χωρίς PIN απαντά μόνο στο widget.
Τηλέφωνο και συνομιλία στον ίδιο Βοηθό
Ενότητα με τίτλο «Τηλέφωνο και συνομιλία στον ίδιο Βοηθό»Ο ίδιος Βοηθός μπορεί να απαντά στο τηλέφωνο και στη συνομιλία της ιστοσελίδας με διαφορετικούς κανόνες σε κάθε περίπτωση. Ο Βοηθός ήδη γνωρίζει πότε η συνομιλία είναι γραπτή: εκεί δεν λαμβάνει τους κανόνες αναγνώρισης ομιλίας και προφορικού ύφους. Για δικούς σας κανόνες, χρησιμοποιήστε τη μεταβλητή {{serviceType}} στο prompt:
| Συνομιλία | {{serviceType}} |
|---|---|
| Γραπτή συνομιλία στην ιστοσελίδα, WhatsApp, Viber, Messenger, Instagram | message |
| Φωνή στην ιστοσελίδα (ομιλία μέσα από τη φυσαλίδα) | websocket |
| Τηλεφωνική κλήση | κενή |
Γράψτε τον κανόνα με απλά λόγια, για παράδειγμα:
Ο τύπος συνομιλίας είναι “
{{serviceType}}”. Αν είναι “message”, ο πελάτης γράφει: μη ζητάς να συλλαβίσει ή να επαναλάβει email, όνομα ή αριθμό που έχει ήδη γράψει, και στείλε συνδέσμους και στοιχεία μέσα στη συνομιλία αντί για SMS. Διαφορετικά ο πελάτης μιλά: επιβεβαίωσε το email διαβάζοντάς το, ή πρότεινε να του σταλεί SMS ώστε να το γράψει.
Στο WhatsApp, στο Viber, στο Messenger και στο Instagram κάθε σύνδεση έχει επίσης δικές της οδηγίες καναλιού, τις οποίες ο Βοηθός διαβάζει μόνο σε εκείνο το κανάλι.
Διαφορετικός χαιρετισμός στο chat
Ενότητα με τίτλο «Διαφορετικός χαιρετισμός στο chat»Οι γραπτές συνομιλίες ξεκινούν με τον χαιρετισμό του τηλεφώνου, εκτός αν τους δώσετε δικό τους. Αυτό μετράει όταν ο χαιρετισμός του τηλεφώνου έχει φράσεις που ταιριάζουν μόνο σε κλήση, όπως «Η κλήση ηχογραφείται». Ανοίξτε τον Βοηθό → Οδηγίες → Χαιρετισμός, πατήστε Προσθέστε χαιρετισμό για το chat, γράψτε το πρώτο μήνυμα για τις συνομιλίες και πατήστε Αποθήκευση. Στέλνεται όπως το γράψατε στη συνομιλία της ιστοσελίδας, στο WhatsApp, στο Viber, στο Messenger και στο Instagram· οι κλήσεις και η φωνή στην ιστοσελίδα κρατούν τον χαιρετισμό του τηλεφώνου. Αν τον αφαιρέσετε με το ×, οι συνομιλίες επιστρέφουν στον χαιρετισμό του τηλεφώνου.
Από το Claude ή το ChatGPT: «βάλε στον Βοηθό μου χαιρετισμό για το chat: Γεια σας, είμαι η Ιωάννα, η ψηφιακή βοηθός. Πώς μπορώ να βοηθήσω;»
Συνέχεια από άνθρωπο
Ενότητα με τίτλο «Συνέχεια από άνθρωπο»Όταν ο επισκέπτης ζητήσει άνθρωπο, ο agent μπορεί να δώσει την ίδια συνομιλία σε συνεργάτη. Χρειάζεται Transfer στον agent και Provide chat support στον συνεργάτη. Δείτε το Live Support.
Ένα chat session καλύπτει έναν επισκέπτη για 24 ώρες, ανεξάρτητα από τον αριθμό των μηνυμάτων, μαζί με τη μεταφορά σε συνεργάτη. Όταν τελειώσουν, οι νέες συνομιλίες απορρίπτονται μέχρι να αγοράσετε πακέτο chat sessions. Οι φωνητικές συνομιλίες στο widget χρεώνονται σε λεπτά ομιλίας, όπως μια τηλεφωνική κλήση, όχι σε chat sessions. Δείτε Πώς λειτουργούν οι χρεώσεις.
Γιατί ο σύνδεσμος δοκιμής του website widget λέει ότι ο βοηθός δεν είναι διαθέσιμος;
Το website widget είναι ανενεργό. Ενεργοποιήστε το στο Website Widget ή ζητήστε από το Claude να το ενεργοποιήσει.
Γιατί η φυσαλίδα του chat widget δεν εμφανίζεται στον ιστότοπό μου;
Ελέγξτε ότι το hostname του ιστότοπου είναι στα Allowed domains (ή ότι η λίστα είναι κενή), ότι ο κώδικας του widget υπάρχει στη σελίδα που βλέπετε και ότι κάποιο cache plugin δεν σερβίρει παλιό αντίγραφο της σελίδας.
Μπορώ να βάλω το chat widget του ίδιου βοηθού σε δύο ιστότοπους;
Ναι. Προσθέστε και τα δύο hostnames στα Allowed domains και βάλτε τον ίδιο κώδικα widget και στους δύο ιστότοπους.
Μπορεί η συνομιλία στον ιστότοπο να εμφανίσει φόρμα όταν ο επισκέπτης ζητά άνθρωπο και δεν υπάρχει διαθέσιμος συνεργάτης;
Δεν υπάρχει φόρμα μέσα στη συνομιλία. Όταν ο επισκέπτης ζητά άνθρωπο, το Live Support προσφέρει τη συνομιλία σε συνεργάτη που είναι συνδεδεμένος· αν κανείς δεν την αναλάβει, το AI το λέει και καταγράφει το μήνυμα στην ίδια συνομιλία, ρωτώντας ένα-ένα το όνομα, ένα email ή τηλέφωνο και το θέμα. Για να φτάνει κάθε τέτοιο μήνυμα στην ομάδα σας ως εργασία, ενεργοποιήστε το Auto-create tasks στα Call results· η εργασία περιέχει τα στοιχεία που έδωσε ο επισκέπτης.
Γιατί ένας σύνδεσμος στη συνομιλία του ιστότοπου εμφανίζεται διαγραμμένος και δεν πατιέται;
Ο τομέας του συνδέσμου δεν είναι στους Τομείς ενεργών συνδέσμων (Website Widget → Interface). Προσθέστε τον εκεί, π.χ. hihello.com, και αποθηκεύστε. Η ενεργοποίηση του Να επιτρέπονται και σύνδεσμοι http:// από μόνη της δεν αρκεί. Δείτε Σύνδεσμοι στις απαντήσεις του agent.
