# Magento

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

  <ShotPlaceholder
    src="/assets/integrations/magento.png"
    name="magento-connect"
    alt="Παράθυρο σύνδεσης Magento με URL καταστήματος, Κωδικό προβολής καταστήματος, Πιστοποίηση και τα τέσσερα κλειδιά OAuth"
    capture="Connect Magento dialog."
  />

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

Ένα Integration στο διαχειριστικό του Magento:

1. **System - Extensions - Integrations - Add New Integration**. Ονομάστε το `Voice Logica`.
2. Στην ενότητα **API**, δώστε πρόσβαση σε Customers, Sales και Catalog. Η καταχώρηση παραγγελιών γίνεται μέσω του καλαθιού του Magento, επομένως επιτρέψτε και την πρόσβαση στα καλάθια αν ο βοηθός θα δέχεται παραγγελίες.
3. **Save** και στη συνέχεια **Activate**. Το Magento εμφανίζει τέσσερις τιμές: Consumer Key, Consumer Secret, Access Token και Access Token Secret. Αντιγράψτε και τις τέσσερις.

Η μέθοδος OAuth 1.0a λειτουργεί σε όλες τις εκδόσεις Magento 2.4 και δεν λήγει. Γίνεται δεκτό και μεμονωμένο bearer / integration token, όμως το Magento 2.4.4 και νεότερες εκδόσεις το απορρίπτουν, εκτός αν το επιτρέπουν οι ρυθμίσεις OAuth του καταστήματος.

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

- **URL καταστήματος** (required) — Η βασική διεύθυνση του καταστήματος με `https://`, χωρίς κάθετο στο τέλος, π.χ. `https://myshop.example`.
- **Όνομα καταστήματος** — Όνομα εμφάνισης της σύνδεσης. Προαιρετικό.
- **Κωδικός προβολής καταστήματος** — Για εγκαταστάσεις με πολλά καταστήματα. Αφήστε το κενό για την προεπιλεγμένη προβολή.
- **Πιστοποίηση** (required) — **OAuth 1.0a (4 keys)** ή **Bearer / integration token**.
- **Κλειδί καταναλωτή** (required) — Μόνο για OAuth 1.0a.
- **Καταναλωτικό μυστικό** (required) — Μόνο για OAuth 1.0a.
- **Διακριτικό πρόσβασης** (required) — Μόνο για OAuth 1.0a.
- **Μυστικό διακριτικού πρόσβασης** (required) — Μόνο για OAuth 1.0a.
- **Διακριτικό φορέα / ενσωμάτωσης** (required) — Μόνο για Bearer / integration token.

Η **Σύνδεση** ελέγχει τα στοιχεία στο κατάστημα πριν τα αποθηκεύσει. Δεν υπάρχει ξεχωριστό κουμπί δοκιμής.

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

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

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

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

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

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

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

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

Πελάτες και προϊόντα ανανεώνονται καθημερινά.

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

**Η σύνδεση αποτυγχάνει με σφάλμα πιστοποίησης**

Ελέγξτε ότι το Integration είναι **Active** στο Magento και ότι οι τέσσερις τιμές προέρχονται από το ίδιο Integration. Αν επιλέξατε **Bearer / integration token** σε Magento 2.4.4 ή νεότερο, αλλάξτε σε **OAuth 1.0a (4 keys)**: αυτές οι εκδόσεις απορρίπτουν εξ ορισμού τα integration tokens ως bearer.

**Ο βοηθός αναφέρει ότι δεν υπάρχει διαθέσιμη μέθοδος αποστολής ή πληρωμής**

Το Magento δεν επέστρεψε μέθοδο αποστολής για τη διεύθυνση του καλούντος ή μέθοδο πληρωμής για την παραγγελία. Ελέγξτε τις ενεργές μεθόδους αποστολής και πληρωμής της συγκεκριμένης προβολής καταστήματος, καθώς και ότι ο βοηθός συγκέντρωσε πλήρη διεύθυνση αποστολής.

**Ο βοηθός δεν μπορεί να καταχωρήσει παραγγελία για προϊόν που βρήκε**

Οι παραγγελίες καταχωρούνται με βάση το SKU. Όταν ένα είδος δεν αντιστοιχίζεται σε SKU, η παραγγελία απορρίπτεται. Βεβαιωθείτε ότι το προϊόν έχει SKU και ότι είναι επιλεγμένη η **Αναζήτηση προϊόντων**, ώστε ο βοηθός να επιλέγει το είδος από τον κατάλογο και όχι από τη διατύπωση του καλούντος.

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

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