API Permissions

Για να ξεκλειδώσετε το πλήρες δυναμικό του AI SmartTalk — όπως η αναζήτηση παραγγελιών, η ενημέρωση περιγραφών προϊόντων ή η διαχείριση πελατών — πρέπει να διαμορφώσετε ένα PrestaShop Webservice API token με τις σωστές άδειες.

info

Αυτό το βήμα είναι απαραίτητο αν θέλετε να χρησιμοποιήσετε AI Actions (SmartFlow). Χωρίς αυτό, ο AI βοηθός σας μπορεί να απαντήσει σε ερωτήσεις βασισμένες σε συγχρονισμένες γνώσεις, αλλά δεν θα μπορεί να έχει πρόσβαση σε δεδομένα καταστήματος σε πραγματικό χρόνο.

---

1. Ενεργοποίηση του Webservice

1. Μεταβείτε στις Προηγμένες Ρυθμίσεις > Webservice
2. Ενεργοποιήστε το webservice του PrestaShop
3. Κάντε κλικ στο Αποθήκευση

---

2. Δημιουργία ενός API key

1. Στη σελίδα Webservice, κάντε κλικ στο Προσθήκη νέου webservice key
2. Συμπληρώστε τη φόρμα:
   • Κλειδί: Κάντε κλικ στο Δημιουργία για να δημιουργήσετε ένα ασφαλές token, ή εισάγετε το δικό σας
   • Περιγραφή κλειδιού: AI SmartTalk
   • Κατάσταση: Ενεργοποιημένο
3. Ρυθμίστε τις άδειες όπως περιγράφεται παρακάτω
4. Κάντε κλικ στο Αποθήκευση

warning

Αντιγράψτε και αποθηκεύστε το API key — θα το χρειαστείτε κατά τη διαμόρφωση της ενσωμάτωσης στο AI SmartTalk.

---

3. Απαιτούμενες άδειες

Στην ενότητα αδειών του API key σας, ενεργοποιήστε τους παρακάτω πόρους:

Πόρος	GET	PUT	POST	Περιγραφή
products	Ναι	Ναι	—	Ανάγνωση λεπτομερειών προϊόντων, ενημέρωση περιγραφών και SEO
orders	Ναι	—	—	Αναζήτηση παραγγελιών με βάση την αναφορά ή τον πελάτη
order_details	Ναι	—	—	Προβολή προϊόντων εντός μιας παραγγελίας
order_states	Ναι	—	—	Ανάγνωση ετικετών κατάστασης παραγγελίας
order_histories	Ναι	—	Ναι	Ανάγνωση ιστορικού κατάστασης, προσθήκη αλλαγών κατάστασης
customers	Ναι	Ναι	—	Αναζήτηση και ενημέρωση πληροφοριών πελατών
languages	Ναι	—	—	Λίστα διαθέσιμων γλωσσών καταστήματος

tip

Ελέγξτε μόνο τις άδειες που αναφέρονται παραπάνω. Δεν χρειάζεται να παραχωρήσετε πρόσβαση σε άλλους πόρους.

---

4. Χρήσεις κάθε πόρου

Προϊόντα (ανάγνωση + εγγραφή)

• Ανάγνωση: Ανάκτηση λεπτομερειών προϊόντων — όνομα, περιγραφή, σύντομη περιγραφή, τιμή, αναφορά, απόθεμα, πεδία SEO (meta title, meta description, meta keywords)
• Εγγραφή: Ενημέρωση περιγραφών προϊόντων, σύντομων περιγραφών και πεδίων SEO με πλήρη υποστήριξη πολυγλωσσίας

Παραγγελίες (μόνο ανάγνωση)

• Αναζήτηση μιας παραγγελίας με βάση τον αριθμό αναφοράς της
• Λίστα παραγγελιών για έναν συγκεκριμένο πελάτη (με βάση το email)
• Λήψη της πιο πρόσφατης παραγγελίας για έναν πελάτη

Λεπτομέρειες Παραγγελίας (μόνο ανάγνωση)

• Προβολή των προϊόντων εντός μιας παραγγελίας: όνομα, αναφορά, ποσότητα, τιμή μονάδας

Καταστάσεις Παραγγελίας (μόνο ανάγνωση)

• Ανάκτηση της αναγνώσιμης από άνθρωπο ετικέτας για κάθε κατάσταση παραγγελίας (π.χ., "Η πληρωμή έγινε αποδεκτή", "Απεστάλη")

Ιστορικά Παραγγελιών (ανάγνωση + δημιουργία)

• Ανάγνωση: Προβολή του ιστορικού αλλαγών κατάστασης μιας παραγγελίας
• Δημιουργία: Προσθήκη νέας αλλαγής κατάστασης σε μια παραγγελία (π.χ., σήμανση ως αποσταλείσα), με προαιρετική ειδοποίηση μέσω email στον πελάτη

Πελάτες (ανάγνωση + εγγραφή)

• Ανάγνωση: Αναζήτηση ενός πελάτη με βάση το email ή το ID — ανάκτηση ονόματος, email, ημερομηνίας εγγραφής, κατάστασης newsletter, σημειώσεων
• Εγγραφή: Ενημέρωση πληροφοριών πελατών (όνομα, επώνυμο, email, σημειώσεις)

Γλώσσες (μόνο ανάγνωση)

• Λίστα όλων των γλωσσών που έχουν ρυθμιστεί στο κατάστημά σας (χρησιμοποιείται για πολυγλωσσικές ενημερώσεις προϊόντων)

---

5. Εισαγωγή του API key στο AI SmartTalk

Μόλις το Webservice key σας δημιουργηθεί και διαμορφωθεί:

1. Μεταβείτε στη διαμόρφωση του module AI SmartTalk στο PrestaShop
2. Το API key μεταδίδεται συνήθως κατά τη διάρκεια της σύνδεσης OAuth
3. Αν χρειαστεί να το ενημερώσετε, μεταβείτε στον πίνακα ελέγχου του AI SmartTalk > Ενσωμάτωση > PrestaShop και ενημερώστε το Webservice token

Για ρυθμίσεις πολλαπλών ιστότοπων, κάθε ιστότοπος μπορεί να έχει το δικό του Webservice API key διαμορφωμένο ανεξάρτητα.

---

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

• Συγχρονίστε τα δεδομένα του καταστήματός σας — Σπρώξτε τον κατάλογο προϊόντων σας στο AI
• Δείτε τι μπορεί να κάνει το AI — Πλήρης αναφορά διαθέσιμων ενεργειών