API Permissions
Για να ξεκλειδώσετε το πλήρες δυναμικό του AI SmartTalk — όπως η αναζήτηση παραγγελιών, η ενημέρωση περιγραφών προϊόντων ή η διαχείριση πελατών — πρέπει να διαμορφώσετε ένα PrestaShop Webservice API token με τις σωστές άδειες.
Αυτό το βήμα είναι απαραίτητο αν θέλετε να χρησιμοποιήσετε AI Actions (SmartFlow). Χωρίς αυτό, ο AI βοηθός σας μπορεί να απαντήσει σε ερωτήσεις βασισμένες σε συγχρονισμένες γνώσεις, αλλά δεν θα μπορεί να έχει πρόσβαση σε δεδομένα καταστήματος σε πραγματικό χρόνο.
1. Ενεργοποίηση του Webservice
- Μεταβείτε στις Προηγμένες Ρυθμίσεις > Webservice
- Ενεργοποιήστε το webservice του PrestaShop
- Κάντε κλικ στο Αποθήκευση
2. Δημιουργία ενός API key
- Στη σελίδα Webservice, κάντε κλικ στο Προσθήκη νέου webservice key
- Συμπληρώστε τη φόρμα:
- Κλειδί: Κάντε κλικ στο Δημιουργία για να δημιουργήσετε ένα ασφαλές token, ή εισάγετε το δικό σας
- Περιγραφή κλειδιού:
AI SmartTalk - Κατάσταση: Ενεργοποιημένο
- Ρυθμίστε τις άδειες όπως περιγράφεται παρακάτω
- Κάντε κλικ στο Αποθήκευση
Αντιγράψτε και αποθηκεύστε το API key — θα το χρειαστείτε κατά τη διαμόρφωση της ενσωμάτωσης στο AI SmartTalk.
3. Απαιτούμενες άδειες
Στην ενότητα αδειών του API key σας, ενεργοποιήστε τους παρακάτω πόρους:
| Πόρος | GET | PUT | POST | Περιγραφή |
|---|---|---|---|---|
| products | Ναι | Ναι | — | Ανάγνωση λεπτομερειών προϊόντων, ενημέρωση περιγραφών και SEO |
| orders | Ναι | — | — | Αναζήτηση παραγγελιών με βάση την αναφορά ή τον πελάτη |
| order_details | Ναι | — | — | Προβολή προϊόντων εντός μιας παραγγελίας |
| order_states | Ναι | — | — | Ανάγνωση ετικετών κατάστασης παραγγελίας |
| order_histories | Ναι | — | Ναι | Ανάγνωση ιστορικού κατάστασης, προσθήκη αλλαγών κατάστασης |
| customers | Ναι | Ναι | — | Αναζήτηση και ενημέρωση πληροφοριών πελατών |
| languages | Ναι | — | — | Λίστα διαθέσιμων γλωσσών καταστήματος |
Ελέγξτε μόνο τις άδειες που αναφέρονται παραπάνω. Δεν χρειάζεται να παραχωρήσετε πρόσβαση σε άλλους πόρους.
4. Χρήσεις κάθε πόρου
Προϊόντα (ανάγνωση + εγγραφή)
- Ανάγνωση: Ανάκτηση λεπτομερειών προϊόντων — όνομα, περιγραφή, σύντομη περιγραφή, τιμή, αναφορά, απόθεμα, πεδία SEO (meta title, meta description, meta keywords)
- Εγγραφή: Ενημέρωση περιγραφών προϊόντων, σύντομων περιγραφών και πεδίων SEO με πλήρη υποστήριξη πολυγλωσσίας
Παραγγελίες (μόνο ανάγνωση)
- Αναζήτηση μιας παραγγελίας με βάση τον αριθμό αναφοράς της
- Λίστα παραγγελιών για έναν συγκεκριμένο πελάτη (με βάση τ ο email)
- Λήψη της πιο πρόσφατης παραγγελίας για έναν πελάτη
Λεπτομέρειες Παραγγελίας (μόνο ανάγνωση)
- Προβολή των προϊόντων εντός μιας παραγγελίας: όνομα, αναφορά, ποσότητα, τιμή μονάδας
Καταστάσεις Παραγγελίας (μόνο ανάγνωση)
- Ανάκτηση της αναγνώσιμης από άνθρωπο ετικέτας για κάθε κατάσταση παραγγελίας (π.χ., "Η πληρωμή έγινε αποδεκτή", "Απεστάλη")
Ιστορικά Παραγγελιών (ανάγνωση + δημιουργία)
- Ανάγνωση: Προβολή του ιστορικού αλλαγών κατάστασης μιας παραγγελίας
- Δημιουργία: Προσθήκη νέας αλλαγής κατάστασης σε μια παραγγελία (π.χ., σήμανση ως αποσταλείσα), με προαιρετική ειδοποίηση μέσω email στον πελάτη
Πελάτες (ανάγνωση + εγγραφή)
- Ανάγνωση: Αναζήτηση ενός πελάτη με βάση το email ή το ID — ανάκτηση ονόματος, email, ημερομηνίας εγγραφής, κατάστασης newsletter, σημειώσεων
- Εγγραφή: Ενημέρωση πληροφοριών πελατών (όνομα, επώνυμο, email, σημειώσεις)
Γλώσσες (μόνο ανάγνωση)
- Λίστα όλων των γλωσσών που έχουν ρυθμιστεί στο κατάστημά σας (χρησιμοποιείται για πολυγλωσσικές ενημερώσεις προϊόντων)
5. Εισαγωγή του API key στο AI SmartTalk
Μόλις το Webservice key σας δημιουργηθεί και διαμορφωθεί:
- Μεταβείτε στη διαμόρφωση του module AI SmartTalk στο PrestaShop
- Το API key μεταδίδεται συνήθως κατά τη διάρκεια της σύνδεσης OAuth
- Αν χρειαστεί να το ενημερώσετε, μεταβείτε στον πίνακα ελέγχου του AI SmartTalk > Ενσωμάτωση > PrestaShop και ενημερώστε το Webservice token
Για ρυθμίσεις πολλαπλών ιστότοπων, κάθε ιστότοπος μπορεί να έχει το δικό του Webservice API key διαμορφωμένο ανεξάρτητα.
Επόμενα βήματα
- Συγχρονίστε τα δεδομένα του καταστήματός σας — Σπρώξτε τον κατάλογο προϊόντων σας στο AI
- Δείτε τι μπορεί να κάνει το AI — Πλήρης αναφορά διαθέσιμων ενεργειών