# OpenCart

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

  <ShotPlaceholder
    src="/assets/integrations/opencart.png"
    name="opencart-connect"
    alt="Παράθυρο σύνδεσης OpenCart με URL καταστήματος, Όνομα χρήστη API, Κλειδί API και Διάλεκτο API"
    capture="Connect OpenCart dialog."
  />

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

Το OpenCart χρειάζεται επέκταση REST και χρήστη API. Με την προτεινόμενη επέκταση Dreamvention REST Admin:

1. Εγκαταστήστε την **Dreamvention REST Admin** και στη συνέχεια **Επεκτάσεις - Τροποποιήσεις - Ανανέωση**.
2. **Σύστημα - Χρήστες - API - Προσθήκη νέου**: όνομα χρήστη, π.χ. `voicelogica`, κατάσταση **Ενεργό**, **Δημιουργία** για το κλειδί API, **Αποθήκευση** και αντιγραφή του κλειδιού.
3. Στις **διευθύνσεις IP** του ίδιου χρήστη API, προσθέστε την IP του διακομιστή της Voice Logica. Η κενή λίστα ενδείκνυται μόνο για δοκιμές.
4. **Σύστημα - Χρήστες - Ομάδες χρηστών**: επιτρέψτε το `extension/dreamvention_rest_admin/*` και δώστε Access και Modify στα `catalog/product`, `catalog/manufacturer`, `customer/customer` και `sale/order`.

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

- **URL καταστήματος** (required) — Η ρίζα του καταστήματος με `https://`, χωρίς `/admin` και χωρίς κάθετο στο τέλος.
- **Όνομα χρήστη API** (required) — Το όνομα του χρήστη API.
- **Κλειδί API** (required) — Το κλειδί που δημιουργήθηκε για τον χρήστη.
- **Διάλεκτος API** — Η επέκταση REST του καταστήματος: `dreamvention` (προεπιλογή, προτείνεται), `journal` ή `native`.
- **Όνομα καταστήματος** — Όνομα εμφάνισης της σύνδεσης. Προαιρετικό.

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

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

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

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

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

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

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

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

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

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

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

Ο χρήστης API απορρίπτει το αίτημα, σχεδόν πάντα επειδή η IP του διακομιστή της Voice Logica δεν βρίσκεται στις **διευθύνσεις IP** του χρήστη. Ελέγξτε επίσης ότι ο χρήστης API είναι **Ενεργός** και ότι το κλειδί αποθηκεύτηκε μετά τη **Δημιουργία**.

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

Οι διαδρομές της επέκτασης REST δεν είναι ενεργές. Μεταβείτε στο **Επεκτάσεις - Τροποποιήσεις**, πατήστε **Ανανέωση** και δοκιμάστε ξανά. Ελέγξτε ότι το **URL καταστήματος** είναι η ρίζα του καταστήματος και όχι η διεύθυνση `/admin`, και ότι η **Διάλεκτος API** αντιστοιχεί στην εγκατεστημένη επέκταση.

**Πελάτες ή παραγγελίες επιστρέφουν κενά**

Η ομάδα του χρήστη API δεν έχει δικαιώματα στα `customer/customer` ή `sale/order`. Προσθέστε Access και Modify για αυτές τις διαδρομές στο **Σύστημα - Χρήστες - Ομάδες χρηστών** και πατήστε **Συγχρονισμός τώρα**.

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

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