# Shopify

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

  <ShotPlaceholder
    src="/assets/integrations/shopify.png"
    name="shopify-connect"
    alt="Παράθυρο σύνδεσης Shopify με Domain καταστήματος, Εγκατάσταση μέσω Shopify και τη φόρμα access token"
    capture="Connect Shopify dialog."
  />

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

Το παράθυρο προσφέρει δύο τρόπους σύνδεσης. Προτιμήστε τον πρώτο, εκτός αν υπάρχει λόγος για το αντίθετο.

- **Εγκατάσταση μέσω Shopify (προτείνεται).** Χρειάζεστε μόνο το domain `myshopify.com` του καταστήματος και λογαριασμό Shopify με δικαίωμα εγκατάστασης εφαρμογών. Το Shopify εμφανίζει τη δική του οθόνη έγκρισης· δεν απαιτείται καμία προετοιμασία στο κατάστημα.
- **Access token.** Για καταστήματα που προτιμούν προσαρμοσμένη εφαρμογή. Στο διαχειριστικό του καταστήματος ανοίξτε **Settings - Apps and sales channels - Develop apps**, πατήστε **Allow legacy custom app development** και μετά **Create an app** (με όνομα `Voice Logica`). Στο **Configuration - Admin API integration - Configure** ενεργοποιήστε `read_customers`, `write_customers`, `read_orders`, `write_orders`, `read_products`, `write_products` και `read_shipping` (απαιτείται όταν ο βοηθός δημιουργεί παραγγελίες με αποστολή) και πατήστε **Save**. Στην καρτέλα **API credentials** πατήστε **Install app** και αντιγράψτε το **Admin API access token** (`shpat_…`). Το Shopify εμφανίζει το token μόνο μία φορά.

Δημιουργήστε την εφαρμογή στο διαχειριστικό του καταστήματος και όχι στο Shopify Dev Dashboard ή στο Partners dashboard. Εκείνα δίνουν Client ID και μυστικό `shpss_…`, τα οποία η φόρμα token δεν δέχεται.

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

Για την **Εγκατάσταση μέσω Shopify**:

- **Domain καταστήματος** (required) — Π.χ. `myshop.myshopify.com`. Αρκεί και το τμήμα πριν από το `.myshopify.com`.
- **Αναγνωριστικό πελάτη** — Μόνο στην ενότητα **Χρήση δικών σας credentials Shopify**, εφόσον σας ζητήθηκε σύνδεση μέσω δικής σας εφαρμογής Shopify. Αφήστε το κενό για να χρησιμοποιηθεί η εφαρμογή της Voice Logica.
- **Μυστικό πελάτη** — Στην ίδια ενότητα. Συμπληρώνεται μαζί με το Αναγνωριστικό πελάτη ή καθόλου.

Για τη φόρμα access token:

- **Domain καταστήματος** (required) — Το domain `myshopify.com` που φαίνεται στη διεύθυνση του διαχειριστικού.
- **Διακριτικό πρόσβασης API διαχειριστή** (required) — Το token `shpat_…` από το **API credentials**.
- **Μυστικό κλειδί API** — Από την ίδια καρτέλα. Επιτρέπει στο Shopify να ειδοποιεί τη Voice Logica για αλλαγές στο κατάστημα· χωρίς αυτό ο προγραμματισμένος συγχρονισμός συνεχίζει κανονικά.
- **Έκδοση API** — Προσυμπληρωμένη. Αλλάξτε την μόνο αν το Shopify έχει αποσύρει αυτή την έκδοση.
- **Όνομα καταστήματος** — Όνομα εμφάνισης της σύνδεσης. Προαιρετικό.

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

1. **Ενσωματώσεις - Κατάλογος - Shopify - Σύνδεση**. Συμπληρώστε το **Domain καταστήματος** και πατήστε **Εγκατάσταση μέσω Shopify**. Εγκρίνετε την εφαρμογή στο παράθυρο του Shopify που ανοίγει. Αν χρησιμοποιείτε token, συμπληρώστε τη φόρμα, πατήστε **Δοκιμή σύνδεσης** και μετά **Σύνδεση**.

2. Το Shopify εμφανίζεται στα **Connected**. Η αντιγραφή πελατών και προϊόντων ξεκινά αμέσως στο παρασκήνιο.

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

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

5. Αν ο βοηθός δημιουργεί παραγγελίες, ορίστε **Μέγιστη αξία παραγγελίας** και **Μέγιστες γραμμές παραγγελιών**. Στα **Χαρακτηριστικά προσαρμοσμένης παραγγελίας** ορίζετε επιπλέον στοιχεία που πρέπει να συλλέξει ο βοηθός· εμφανίζονται στην παραγγελία του Shopify ως χαρακτηριστικά παραγγελίας.

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

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

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

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

Πελάτες και προϊόντα ανανεώνονται καθημερινά. Στην κάρτα Shopify της καρτέλας **Connected**, ο **Συγχρονισμός τώρα** τα ανανεώνει αμέσως και ο **Συγχρονισμός στο Skroutz** ξαναχτίζει τη λίστα προϊόντων στην οποία αναζητά ο βοηθός. Δεν δημοσιεύεται τίποτα στο marketplace του Skroutz.

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

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

Ελέγξτε ότι το token ξεκινά με `shpat_` και προέρχεται από εφαρμογή που δημιουργήθηκε στο διαχειριστικό του καταστήματος. Μια τιμή `shpss_…` είναι μυστικό εφαρμογής από το Dev Dashboard και δεν λειτουργεί εδώ. Ελέγξτε επίσης ότι το **Domain καταστήματος** είναι το domain `myshopify.com` του ίδιου καταστήματος.

**Η Εγκατάσταση μέσω Shopify δεν κάνει τίποτα ή το παράθυρο κλείνει χωρίς σύνδεση**

Η οθόνη έγκρισης ανοίγει σε νέο παράθυρο. Επιτρέψτε τα αναδυόμενα παράθυρα για την εφαρμογή Voice Logica και δοκιμάστε ξανά. Βεβαιωθείτε ότι συμπληρώσατε το domain `myshopify.com` και όχι τη δημόσια διεύθυνση του καταστήματος.

**Η κάρτα Shopify δείχνει Απαιτείται ενέργεια και Επανασύνδεση**

Η εφαρμογή Voice Logica απεγκαταστάθηκε από το κατάστημα ή ανακλήθηκε η πρόσβασή της. Πατήστε **Επανασύνδεση** και εγκρίνετε ξανά την εφαρμογή. Μέχρι τότε ο βοηθός δεν μπορεί να διαβάσει πελάτες ή παραγγελίες.

**Οι παραγγελίες του βοηθού δεν έχουν γραμμή αποστολής**

Το Shopify δεν προσθέτει μεταφορικά σε παραγγελίες που δημιουργούνται μέσω API. Ενεργοποιήστε τη **Λίστα επιλογών αποστολής** ή την **Προφορτώστε τις τιμές αποστολής στο σύστημα**. Με τη μέθοδο token, η εφαρμογή χρειάζεται επίσης το δικαίωμα `read_shipping`.

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

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