# PrestaShop

Με τη σύνδεση PrestaShop, ο Ψηφιακός Βοηθός AI αναγνωρίζει τον πελάτη από τον αριθμό από τον οποίο καλεί, ενημερώνει για τις πρόσφατες παραγγελίες του, απαντά για προϊόντα με όνομα ή κωδικό αναφοράς και, εφόσον το επιτρέψετε, αλλάζει την κατάσταση μιας υπάρχουσας παραγγελίας (π.χ. από αναμονή πληρωμής σε αποδεκτή πληρωμή). Η διαδρομή **Ενσωματώσεις - Κατάλογος - PrestaShop - Σύνδεση** ανοίγει το παράθυρο σύνδεσης. Η σύνδεση είναι μία για ολόκληρη την εταιρεία και τη χρησιμοποιούν όλοι οι βοηθοί της.

  <ShotPlaceholder
    src="/assets/integrations/prestashop.png"
    name="prestashop-connect"
    alt="Παράθυρο σύνδεσης PrestaShop με URL καταστήματος, Webservice Κλειδί API, Όνομα καταστήματος και Προεπιλεγμένο id γλώσσας"
    capture="Connect PrestaShop dialog."
  />

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

Ένα κλειδί Webservice από το διαχειριστικό του PrestaShop:

1. **Advanced Parameters - Webservice** και ενεργοποίηση του webservice.
2. **Add new webservice key**. Δημιουργήστε το κλειδί και δώστε δικαιώματα στα `customers`, `addresses`, `products`, `orders`, `order_states` και `order_histories`. Η ανάγνωση αρκεί για τις αναζητήσεις· για αλλαγή κατάστασης ή δημιουργία παραγγελίας ο βοηθός χρειάζεται δικαίωμα εγγραφής στα `orders` και `order_histories`.
3. Αποθηκεύστε και αντιγράψτε το κλειδί.

## Τι συμπληρώνετε

- **URL καταστήματος** (required) — Η διεύθυνση του καταστήματος με `https://`, π.χ. `https://myshop.example`.
- **Webservice Κλειδί API** (required) — Το κλειδί που δημιουργήσατε.
- **Όνομα καταστήματος** — Όνομα εμφάνισης της σύνδεσης. Προαιρετικό.
- **Προεπιλεγμένο id γλώσσας** — Το id γλώσσας του PrestaShop για τα ονόματα προϊόντων. Συνήθως `1`, η βασική γλώσσα του καταστήματος.

## Πρώτη ρύθμιση

1. **Ενσωματώσεις - Κατάλογος - PrestaShop - Σύνδεση**, συμπληρώστε τα πεδία, πατήστε **Δοκιμή σύνδεσης** και μετά **Σύνδεση**. Το PrestaShop εμφανίζεται στα **Connected** και η αντιγραφή πελατών και προϊόντων ξεκινά στο παρασκήνιο.

2. Ανοίξτε **Οι Agents μου**, επιλέξτε τον βοηθό και μεταβείτε στο **Ικανότητες - Εργαλεία & ροές εργασίας**. Ενεργοποιήστε το **PrestaShop** και πατήστε **Διαμόρφωση**.

3. Επιλέξτε λειτουργίες. Η **Αναγνωρίστε τον καλούντα μέσω τηλεφώνου** είναι ενεργή εξ ορισμού. Προσθέστε **Λάβετε παραγγελίες ανά πελάτη** και **Αναζήτηση προϊόντων** για ερωτήσεις παραγγελιών και προϊόντων. Για να αλλάζει ο βοηθός την κατάσταση παραγγελιών, προσθέστε **Ενημέρωση κατάστασης παραγγελίας** μαζί με **Λίστα καταστάσεων παραγγελίας**, ώστε να επιλέγει μόνο καταστάσεις που υπάρχουν στο κατάστημα. Αφήστε ανενεργή τη **Δημιουργία παραγγελίας**, εκτός αν έχετε διαβάσει τον περιορισμό στην Αντιμετώπιση προβλημάτων.

4. Πατήστε **Αποθήκευση** στο παράθυρο ρυθμίσεων και στη συνέχεια **Αποθήκευση** στον βοηθό.

5. Καλέστε τον βοηθό από αριθμό που υπάρχει σε διεύθυνση πελάτη του PrestaShop (ή χρησιμοποιήστε τη **Δοκιμή agent**). Ρωτήστε «Τι γίνεται με την τελευταία μου παραγγελία;». Ο βοηθός πρέπει να σας απευθυνθεί με το όνομά σας και να αναφέρει την κατάσταση της παραγγελίας. Στη συνέχεια ζητήστε ένα προϊόν με το όνομά του.

## Τι μπορεί να κάνει ο βοηθός

| Εργασία | Τι γίνεται στην κλήση |
|---------|------------------------|
| Αναγνώριση καλούντος | Αντιστοιχίζει τον αριθμό με πελάτη του PrestaShop. Μπορεί επίσης να βρει πελάτη με όνομα ή email και να κρατήσει τον αριθμό για την επόμενη κλήση. |
| Ερωτήσεις παραγγελιών | Ενημερώνει για τις πρόσφατες παραγγελίες ή για μία παραγγελία: κατάσταση, σύνολα, είδη. Η **Λήψη πρόσφατων παραγγελιών κατά την έναρξη κλήσης** φορτώνει τις 10 τελευταίες παραγγελίες πριν μιλήσει ο βοηθός. |
| Αλλαγή κατάστασης | Διαβάζει τη λίστα καταστάσεων του καταστήματος και μεταφέρει μια παραγγελία σε μία από αυτές. |
| Ερωτήσεις προϊόντων | Αναζητά με όνομα ή κωδικό αναφοράς και δίνει τα στοιχεία ενός προϊόντος. |
| Δημιουργία παραγγελίας | Περιορισμένη: το PrestaShop τη δέχεται μόνο για καλάθι που υπάρχει ήδη (βλ. Αντιμετώπιση προβλημάτων). Ισχύουν η **Μέγιστη αξία παραγγελίας**, οι **Μέγιστες γραμμές παραγγελιών** και τα **Χαρακτηριστικά προσαρμοσμένης παραγγελίας**. |

Πελάτες και προϊόντα ανανεώνονται καθημερινά. Ο **Συγχρονισμός τώρα** στην κάρτα PrestaShop της καρτέλας **Connected** τα ανανεώνει αμέσως.

## Αντιμετώπιση προβλημάτων

**Η Δοκιμή σύνδεσης αποτυγχάνει με 401 ή 403**

Το κλειδί απορρίφθηκε. Ελέγξτε ότι το webservice είναι ενεργό στο **Advanced Parameters - Webservice**, ότι το κλειδί είναι ενεργό και ότι το αντιγράψατε ολόκληρο. Το 403 μπορεί επίσης να σημαίνει ότι το κλειδί υπάρχει αλλά δεν έχει τα δικαιώματα που αναφέρονται παραπάνω.

**Τα ονόματα προϊόντων εμφανίζονται σε λάθος γλώσσα ή κενά**

Το **Προεπιλεγμένο id γλώσσας** δείχνει σε γλώσσα στην οποία δεν έχουν μεταφραστεί τα προϊόντα. Χρησιμοποιήστε το id της βασικής γλώσσας του καταστήματος (εμφανίζεται στο **International - Localization - Languages**). Για να το αλλάξετε, αποσυνδέστε το PrestaShop από τα **Connected** και συνδεθείτε ξανά με το σωστό id.

**Ο βοηθός δεν μπορεί να αλλάξει την κατάσταση παραγγελίας**

Η **Ενημέρωση κατάστασης παραγγελίας** απαιτεί δικαίωμα εγγραφής στο `order_histories` για το κλειδί webservice και λειτουργεί καλύτερα όταν είναι επιλεγμένη και η **Λίστα καταστάσεων παραγγελίας**, ώστε ο βοηθός να χρησιμοποιεί κατάσταση που υπάρχει στο κατάστημα.

**Η Δημιουργία παραγγελίας αποτυγχάνει**

Το PrestaShop δέχεται παραγγελία μέσω Webservice μόνο για καλάθι που υπάρχει ήδη, με ορισμένο μεταφορέα, νόμισμα και διευθύνσεις αποστολής και τιμολόγησης. Δεν τα υπολογίζει μόνο του και ο βοηθός δεν δημιουργεί καλάθια. Για τηλεφωνικές παραγγελίες σε PrestaShop, αναθέστε στον βοηθό να καταγράφει τα στοιχεία και να τα προωθεί στην ομάδα σας (π.χ. μέσω workflow), και αξιοποιήστε τη σύνδεση για αναγνώριση καλούντος, κατάσταση παραγγελιών και ερωτήσεις προϊόντων.

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

[Ενεργοποίηση integration](https://docs.voicelogica.ai/el/integrations/) - σύνδεση εταιρείας και εργαλείο βοηθού.  
[Εργαλεία & ροές εργασίας](https://docs.voicelogica.ai/el/agent-configuration/built-in-tools/) - εκεί ενεργοποιείται το εργαλείο PrestaShop.  
[OpenCart](https://docs.voicelogica.ai/el/integrations/eshops/opencart/) - [Ροή προϊόντων XML](https://docs.voicelogica.ai/el/integrations/eshops/xml-feed/) - για καταστήματα σε άλλες πλατφόρμες.