Zeni Chatbot – Οδηγίες API – XML γνωσιακής βάσης

Σύνδεσε OpenCart, WordPress, WooCommerce, WHMCS ή custom βάση δεδομένων με το chatbot σου δημοσιεύοντας ένα XML feed. Το chatbot διαβάζει το feed από την καρτέλα Knowledge Bases, το ευρετηριάζει σε συλλογή σημασιολογικής αναζήτησης και χρησιμοποιεί το περιεχόμενο για να απαντά στους επισκέπτες.

Πώς να Συνδέσεις μια Πλατφόρμα

1. Στον πίνακα διαχείρισης άνοιξε Knowledge Bases και κατέβασε το παράδειγμα script για την πλατφόρμα σου (WordPress, OpenCart, WHMCS Orders ή General).
2. Αντίγραψε το script στον server του καταστήματος ή του ιστότοπού σου (συνήθως στο root της πλατφόρμας). Κράτα το προσβάσιμο μέσω HTTPS.
3. Άνοιξε το URL του script στο browser και επιβεβαίωσε ότι επιστρέφει έγκυρο XML (ρίζα <items> με μία ή περισσότερες εγγραφές <item>).
4. Πίσω στο Knowledge Bases, πρόσθεσε νέα βάση γνώσης, επικόλλησε αυτό το HTTPS URL ως πηγή XML και όρισε συλλογή (π.χ. products, support ή orders).
5. Αποθήκευσε και μετά πάτησε Ευρετηρίαση. Ενεργοποίησε σταδιακές ενημερώσεις όταν το feed υποστηρίζει την παράμετρο modified, ώστε να επανευρετηριάζονται μόνο τα αλλαγμένα στοιχεία.

Η ενσωμάτωση στον ιστότοπο και το widget επισκέπτη είναι ξεχωριστά από αυτό το API. Αυτή η σελίδα καλύπτει μόνο το XML feed που συγχρονίζει κατάλογο, περιεχόμενο ή παραγγελίες στις συλλογές γνώσης σου.

Απαιτούμενη Δομή

Τοποθέτησε όλες τις εγγραφές μέσα σε <items> και χρησιμοποίησε ένα <item> ανά καταχώρηση:

Γίνονται επίσης δεκτές εναλλακτικές ετικέτες εγγραφής: <product>, <entry> ή <record> αντί για <item>.

Προδιαγραφές Πεδίων

• id: Μοναδικό, σταθερό αναγνωριστικό (αλφαριθμητικό ή αριθμός). Χρησιμοποιείται για παρακολούθηση ενημερώσεων και αποφυγή διπλοεγγραφών.
• title: Σύντομος τίτλος για το ευρετηριασμένο στοιχείο.
• description: Κύριο σώμα περιεχομένου. Το HTML γίνεται αποδεκτό (τα exporters πλατφορμών συχνά στέλνουν HTML). Διατηρούνται επικεφαλίδες και χρήσιμο κείμενο· οι εικόνες μέσα στο description μπορεί να εξαχθούν για απαντήσεις. Βάλε το ακριβές URL προϊόντος ή σελίδας που θέλεις να μοιράζεται ο βοηθός στο <url> και κράτα τα βασικά στοιχεία στο κείμενο.
• category: Προαιρετική ομαδοποίηση (π.χ. electronics, support, billing).
• price: Προαιρετική αριθμητική τιμή για προϊόντα ή σύνολα παραγγελιών.
• modified: Χρονική σήμανση σε μορφή YYYY-MM-DD HH:MM:SS. Επιτρέπει σταδιακό συγχρονισμό με ?modified=YYYYMMDDHHMMSS.
• keywords: Φράσεις χωρισμένες με κόμματα που βοηθούν στην αντιστοίχιση και στη δρομολόγηση προς τη σωστή συλλογή.
• url: Δημόσιο HTTPS URL για αυτό το στοιχείο. Το chatbot μπορεί να μοιραστεί αυτόν τον σύνδεσμο μόνο όταν εμφανίζεται στη γνώση που ανακτήθηκε για την τρέχουσα ερώτηση — χρησιμοποίησε το πραγματικό URL προϊόντος/σελίδας, όχι μαντεμένο path.

Οδηγίες Υλοποίησης

• Πρωτόκολλο: Εξυπηρέτηση μέσω HTTPS με Content-Type: application/xml (ή text/xml) και κωδικοποίηση UTF-8.
• Αντιστοίχιση συλλογής: Κάθε XML feed συνδέεται με συλλογή στην καρτέλα Knowledge Bases. Χρησιμοποίησε ξεχωριστές συλλογές για προϊόντα, πολιτικές και παραγγελίες όταν γίνεται.
• Σταδιακός συγχρονισμός: Πρόσθεσε ?modified=YYYYMMDDHHMMSS ώστε να επιστρέφονται μόνο τα items που άλλαξαν μετά από αυτή τη σήμανση. Τα παραδείγματα scripts υποστηρίζουν αυτό το φίλτρο.
• Κωδικοποίηση: Κάνε escape στους ειδικούς χαρακτήρες XML (&, <, >). Το CDATA είναι εντάξει για HTML descriptions.
• Πλήθος εγγραφών: Προαιρετικό count στο <items> βοηθά στην παρακολούθηση προόδου: <items count="123">.
• Λειτουργίες εξόδου: Τα παραδείγματα scripts μπορούν να στείλουν XML στην HTTP απάντηση (προτεινόμενο για το URL της βάσης γνώσης) ή να γράψουν τοπικό αρχείο.

Εξαγωγείς από Πλατφόρμες

Κατέβασέ τα από την καρτέλα Knowledge Bases. Φιλοξένησε κάθε script στην αντίστοιχη πλατφόρμα και επικόλλησε το δημόσιο URL του σε εγγραφή βάσης γνώσης.

• General: Πρότυπο για οποιαδήποτε βάση MySQL. Αντιστοίχισε τις στήλες SQL σε id, title, description και τα υπόλοιπα πεδία.
• WordPress (+ WooCommerce): Εξάγει posts, pages και προϊόντα WooCommerce όταν υπάρχει WooCommerce. Υποστηρίζει ?modified=YYYYMMDDHHMMSS και ?lang=xx (WPML / Polylang). Επεκτείνει shortcodes σε τελικό HTML όπου γίνεται.
• WordPress Orders (WooCommerce): Εξάγει παραγγελίες για συλλογές σχετικές με παραγγελίες.
• OpenCart: Εξάγει προϊόντα χρησιμοποιώντας τις ρυθμίσεις βάσης από το config.php του OpenCart όταν είναι διαθέσιμο.
• OpenCart Orders: Εξάγει παραγγελίες για συλλογές παραγγελιών.
• WHMCS Orders: Εξάγει δεδομένα παραγγελιών WHMCS για συλλογές χρέωσης/παραγγελιών.

Για προϊόντα ή κατάλογο, όρισε συλλογή τύπου eshop/products. Για εξαγωγές παραγγελιών, όρισε συλλογή orders και ρύθμισε αντίστοιχα την πρόθεση συλλογής στο Routing.

Ελάχιστο Παράδειγμα Feed

Λίστα Ελέγχου μετά τη Σύνδεση

• Άνοιξε το URL του script και επιβεβαίωσε ότι φορτώνει το XML χωρίς οθόνες σύνδεσης ή σελίδες σφάλματος HTML.
• Επιβεβαίωσε ότι κάθε item έχει σταθερό id, καθαρό title, χρήσιμο description και σωστό δημόσιο url όταν θέλεις ο βοηθός να μοιράζεται συνδέσμους.
• Ευρετηρίασε τη βάση γνώσης και μετά κάνε μερικές ρεαλιστικές ερωτήσεις προϊόντος ή πολιτικής στο widget ή στο ομαδικό chat.
• Αν οι απαντήσεις χάνουν ενημερώσεις, επανευρετηρίασε ή ενεργοποίησε αυτόματη ευρετηρίαση για αυτή την πηγή.