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

Η ροή προϊόντων XML δίνει στον Ψηφιακό Βοηθό AI τον κατάλογό σας όταν το κατάστημα λειτουργεί σε πλατφόρμα χωρίς έτοιμη σύνδεση ή όταν χρειάζεστε μόνο απαντήσεις για προϊόντα. Η Voice Logica διαβάζει την ίδια ροή XML που δημοσιεύετε για το Skroutz, την ανανεώνει σε τακτά διαστήματα, και ο βοηθός αναζητά σε αυτήν κατά την κλήση: ο καλών ζητά ένα προϊόν με δικά του λόγια και ο βοηθός αναφέρει το όνομα, μια σύντομη περιγραφή και αν είναι διαθέσιμο. Η ροή αφορά μόνο τον κατάλογο. Δεν αναγνωρίζει καλούντες, δεν διαβάζει και δεν καταχωρεί παραγγελίες· για αυτά χρησιμοποιήστε [WooCommerce](https://docs.voicelogica.ai/el/integrations/eshops/woocommerce/), [Shopify](https://docs.voicelogica.ai/el/integrations/eshops/shopify/), [Magento](https://docs.voicelogica.ai/el/integrations/eshops/magento/), [OpenCart](https://docs.voicelogica.ai/el/integrations/eshops/opencart/) ή [PrestaShop](https://docs.voicelogica.ai/el/integrations/eshops/prestashop/).

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

  <ShotPlaceholder
    src="/assets/integrations/xml-feed.png"
    name="xml-feed-connect"
    alt="Ρυθμίσεις Eshop Integration (XML feed) με URL ροής, Διάστημα ανανέωσης και Πεδίο αναγνωριστικού προϊόντος"
    capture="Eshop Integration (XML feed) settings on the agent."
  />

## Τι χρειάζεστε πριν ξεκινήσετε

Μια διεύθυνση ροής προϊόντων σε μορφή 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 ροής** (required) — Η πλήρης διεύθυνση της ροής 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** διατηρεί γράμματα και παύλες.

## Επόμενα βήματα

[Ενεργοποίηση integration](https://docs.voicelogica.ai/el/integrations/) - πώς συνδυάζονται οι συνδέσεις εταιρείας και τα εργαλεία του βοηθού.  
[Εργαλεία & ροές εργασίας](https://docs.voicelogica.ai/el/agent-configuration/built-in-tools/) - εκεί βρίσκεται αυτό το εργαλείο.  
[WooCommerce](https://docs.voicelogica.ai/el/integrations/eshops/woocommerce/) - [Shopify](https://docs.voicelogica.ai/el/integrations/eshops/shopify/) - όταν χρειάζεστε και αναγνώριση καλούντος και παραγγελίες.