Μετάβαση στο περιεχόμενο
ΕΛ
Άνοιγμα εφαρμογής

Ροή προϊόντων XML

6 λεπτά ανάγνωσης
Αντιγραφή ως Markdown
Προβολή ως MarkdownΆνοιγμα του αρχείου .md.md

Η ροή προϊόντων XML δίνει στον Ψηφιακό Βοηθό AI τον κατάλογό σας όταν το κατάστημα λειτουργεί σε πλατφόρμα χωρίς έτοιμη σύνδεση ή όταν χρειάζεστε μόνο απαντήσεις για προϊόντα. Η Voice Logica διαβάζει την ίδια ροή XML που δημοσιεύετε για το Skroutz, την ανανεώνει σε τακτά διαστήματα, και ο βοηθός αναζητά σε αυτήν κατά την κλήση: ο καλών ζητά ένα προϊόν με δικά του λόγια και ο βοηθός αναφέρει το όνομα, μια σύντομη περιγραφή και αν είναι διαθέσιμο. Η ροή αφορά μόνο τον κατάλογο. Δεν αναγνωρίζει καλούντες, δεν διαβάζει και δεν καταχωρεί παραγγελίες· για αυτά χρησιμοποιήστε WooCommerce, Shopify, Magento, OpenCart ή PrestaShop.

Δεν υπάρχει κάρτα στον Κατάλογο ούτε σύνδεση στις Ενσωματώσεις. Η ροή ορίζεται στον ίδιο τον βοηθό: Οι Agents μου - βοηθός - Ικανότητες - Εργαλεία & ροές εργασίας - Eshop Integration (XML feed). Κάθε βοηθός που πρέπει να απαντά για προϊόντα έχει τις δικές του ρυθμίσεις ροής.

Μια διεύθυνση ροής προϊόντων σε μορφή XML του Skroutz (developer.skroutz.gr/el/feedspec/) ή του Google Merchant. Οι περισσότερες ελληνικές πλατφόρμες καταστημάτων και τα plugins για το Skroutz ή το Google Shopping την παράγουν ήδη. Η διεύθυνση πρέπει να είναι προσβάσιμη από το διαδίκτυο χωρίς σύνδεση χρήστη ή περιορισμό IP και να επιστρέφει XML (επιτρέπεται συμπίεση gzip ή zip), όχι σελίδα JSON ή HTML.

ΔομήΠαράδειγμα
Skroutz, με οποιοδήποτε όνομα ρίζας<mywebstore><products><product> (επίσης webstore, store, storedata ή οποιαδήποτε άλλη ρίζα)
Λίστα προϊόντων στη ρίζα<products><product>
Προϊόντα απευθείας κάτω από τη ρίζα<catalog><product> ή ένα μεμονωμένο <product>
Google Merchant (RSS)<rss><channel><item> με πεδία g:, όπως <g:id>, <g:price>
Atom<feed><entry>

Τα πεδία που χρησιμοποιεί ο βοηθός ανά προϊόν. Σε παρένθεση η αποδεκτή εναλλακτική ονομασία· τα πεδία g: του Google γίνονται δεκτά ως έχουν:

ΠεδίοΧρήση
id (g:id)Ταυτοποίηση του προϊόντος μεταξύ ανανεώσεων
name (title)Η ονομασία που εκφωνεί ο βοηθός
linkΗ σελίδα του προϊόντος
price_with_vat (price)Η τιμή
availability (instock Y/N, quantity)Η διαθεσιμότητα
descriptionΑντιστοίχιση αιτημάτων που διατυπώνονται ελεύθερα
category (product_type)Περιορισμός της αναζήτησης
manufacturer (brand)Ερωτήσεις για τον κατασκευαστή
mpn, ean (gtin), skuΚωδικοί που εκφωνούν οι καλούντες, βλ. Πεδίο αναγνωριστικού προϊόντος
image (image_link)Η εικόνα του προϊόντος

Τυχόν πρόσθετα πεδία ενός προϊόντος διατηρούνται ως επιπλέον στοιχεία του.

URL ροήςΥΠΟΧΡΕΩΤΙΚΟ
Η πλήρης διεύθυνση της ροής XML, με https:// ή http://, π.χ. https://myshop.example/feeds/products.xml.
Διάστημα ανανέωσης
Κάθε πότε διαβάζεται ξανά ο κατάλογος, από 30 λεπτά έως 7 ημέρες. Προεπιλογή 1 ημέρα.
Πεδίο αναγνωριστικού προϊόντος
Ο κωδικός προϊόντος που αντιστοιχίζει ο βοηθός όταν ο καλών εκφωνεί κωδικό: MPN (προεπιλογή), EAN, SKU, Skroutz ID, Group Code ή Κανένα. Επιλέξτε τον κωδικό που βλέπουν οι πελάτες σας.
Διανύσματα προϊόντων ενισχυμένα με AI
Ανενεργό εξ ορισμού. Όταν είναι ενεργό, ο βοηθός αντιστοιχίζει ελεύθερα διατυπωμένα αιτήματα με προϊόντα βάσει των περιγραφών τους. Το αποτέλεσμα εξαρτάται από την ποιότητα των περιγραφών.
Διανυσματικό πεδίο
Εμφανίζεται όταν η προηγούμενη επιλογή είναι ενεργή. Το πεδίο της ροής από το οποίο γίνεται η αντιστοίχιση.
Η ροή υποστηρίζει σταδιακό συγχρονισμό
Ενεργοποιήστε το μόνο αν η ροή δέχεται παράμετρο ?modifiedSince=. Διαφορετικά κάθε ανανέωση διαβάζει ολόκληρο τον κατάλογο, που είναι και η ασφαλής επιλογή.
  1. Ανοίξτε Οι Agents μου, επιλέξτε τον βοηθό και μεταβείτε στο Ικανότητες - Εργαλεία & ροές εργασίας.

  2. Ενεργοποιήστε το Eshop Integration (XML feed) και πατήστε Διαμόρφωση.

  3. Επικολλήστε το URL ροής, επιλέξτε Διάστημα ανανέωσης και Πεδίο αναγνωριστικού προϊόντος και πατήστε Αποθήκευση στο παράθυρο ρυθμίσεων.

  4. Πατήστε Αποθήκευση στον βοηθό. Ο συγχρονισμός και η προβολή προϊόντων είναι διαθέσιμα μόνο αφού αποθηκευτεί ο βοηθός.

  5. Πατήστε Συγχρονισμός τώρα στην κάρτα για να διαβαστεί η ροή αμέσως, χωρίς αναμονή για την πρώτη προγραμματισμένη ανανέωση. Περιμένετε λίγα λεπτά και πατήστε View products για να επιβεβαιώσετε ότι τα προϊόντα σας υπάρχουν.

  6. Καλέστε τον βοηθό (ή χρησιμοποιήστε τη Δοκιμή agent) και ζητήστε ένα προϊόν όπως θα το ζητούσε ένας πελάτης, π.χ. «Έχετε έξυπνο βραστήρα;». Ο βοηθός πρέπει να αναφέρει αντίστοιχα προϊόντα από τη ροή σας και αν είναι διαθέσιμα.

ΕργασίαΤι γίνεται στην κλήση
Ερωτήσεις προϊόντωνΑναζητά στον κατάλογο μόλις ο καλών αναφέρει προϊόν ή εκφωνήσει κωδικό, δοκιμάζοντας ταυτόχρονα διάφορες γραφές και τον αγγλικό όρο, και αναφέρει όνομα, σύντομη περιγραφή και διαθεσιμότητα.
ΔιευκρινίσειςΑναζητά ξανά όταν ο καλών εξειδικεύει το αίτημα («να είναι έξυπνος», «σε μαύρο χρώμα»).
ΕναλλακτικέςΠροτείνει παρόμοια προϊόντα μόνο όταν ο καλών ζητήσει εναλλακτικές.
Ο Συγχρονισμός τώρα ή το View products ζητά να αποθηκευτεί πρώτα ο βοηθός

Οι ρυθμίσεις ροής αποθηκεύονται μαζί με τον βοηθό. Πατήστε Αποθήκευση στον βοηθό αφού συμπληρώσετε το URL ροής και στη συνέχεια χρησιμοποιήστε τον Συγχρονισμό τώρα ή το View products.

Το εργαλείο απενεργοποιήθηκε μόνο του και λάβαμε email για άρνηση πρόσβασης

Η ροή επέστρεψε 403 (απαγόρευση πρόσβασης), οπότε η Voice Logica απενεργοποίησε το εργαλείο στον συγκεκριμένο βοηθό και ενημέρωσε με email τις διευθύνσεις ειδοποιήσεων της εταιρείας σας. Η ροή προστατεύεται με σύνδεση χρήστη, περιορισμό IP ή κανόνα firewall. Κάντε τη δημόσια προσβάσιμη, ενεργοποιήστε ξανά το Eshop Integration (XML feed) και πατήστε Αποθήκευση.

Λάβαμε email «E-shop Sync Failed»

Κάθε αποτυχημένη ανανέωση στέλνει email με αρίθμηση έως 3. Μετά από 3 διαδοχικές αποτυχίες το εργαλείο απενεργοποιείται στον βοηθό. Ανοίξτε το URL ροής σε πρόγραμμα περιήγησης για να ελέγξετε ότι φορτώνει και είναι έγκυρο XML, διορθώστε τη ροή, ενεργοποιήστε ξανά το εργαλείο και πατήστε Αποθήκευση. Μια επιτυχημένη ανανέωση μηδενίζει την αρίθμηση.

Ο συγχρονισμός απέτυχε με το μήνυμα «No products found in the feed»

Η ροή φορτώθηκε, αλλά η δομή της δεν είναι από αυτές που υποστηρίζονται. Το μήνυμα αναφέρει τη ρίζα που εντοπίστηκε, π.χ. root found: <shopdata>. Προσαρμόστε τη ροή σε μία από τις υποστηριζόμενες μορφές, απλούστερα <products><product> μέσα σε οποιαδήποτε ρίζα, και πατήστε Συγχρονισμός τώρα.

Ο βοηθός δεν βρίσκει προϊόν όταν ο καλών εκφωνεί τον κωδικό του

Ο βοηθός αντιστοιχίζει τους εκφωνούμενους κωδικούς με το Πεδίο αναγνωριστικού προϊόντος. Ορίστε τον κωδικό που πραγματικά βλέπουν οι πελάτες σας (π.χ. SKU, αν αυτός εμφανίζεται στον ιστότοπο), πατήστε Αποθήκευση και Συγχρονισμός τώρα. Για MPN, EAN, Skroutz ID και Group Code διατηρούνται μόνο τα ψηφία· το SKU διατηρεί γράμματα και παύλες.