# GonnaOrder

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

  <ShotPlaceholder
    src="/assets/integrations/gonnaorder.png"
    name="gonnaorder-connect"
    alt="Παράθυρο σύνδεσης GonnaOrder με Alias καταστήματος, Όνομα χρήστη και Κωδικό"
    capture="Connect GonnaOrder dialog."
  />

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

- Τα **στοιχεία σύνδεσης του ιδιοκτήτη** του καταστήματος στο GonnaOrder (email και κωδικός). Χρησιμοποιούνται μία φορά για τη δημιουργία κλειδιού API για τη Voice Logica και δεν αποθηκεύονται. Αν διαθέτετε ήδη κλειδί API του GonnaOrder, μπορείτε να το χρησιμοποιήσετε αντί αυτών.
- Το **alias του καταστήματος**: το subdomain της σελίδας παραγγελιών σας. Για το `myshop.point2order.gr` το alias είναι `myshop`.

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

Το παράθυρο χρειάζεται το κατάστημα (**Alias καταστήματος** ή **Store id**) και τρόπο πρόσβασης (**Όνομα χρήστη** και **Κωδικός**, ή **API key**).

- **Alias καταστήματος** — Το subdomain του καταστήματος. Απαιτείται, εκτός αν δώσετε **Store id**.
- **Όνομα χρήστη** — Το email του ιδιοκτήτη στο GonnaOrder. Απαιτείται, εκτός αν δώσετε **API key**.
- **Κωδικός** — Χρησιμοποιείται μία φορά για τη δημιουργία του κλειδιού API και στη συνέχεια απορρίπτεται.

Στις **Προχωρημένες ρυθμίσεις** (όλα προαιρετικά):

- **API key (instead of username / password)** — Υπάρχον κλειδί API του GonnaOrder.
- **Store id** — Μόνο αν δεν υπάρχει alias. Αγνοείται όταν το alias εντοπιστεί.
- **Περιβάλλον** — **Production** για καταστήματα σε λειτουργία. Το **Development** αφορά δοκιμαστικά καταστήματα του GonnaOrder.
- **Admin host override** — Αφήστε το κενό. Στο Production δοκιμάζεται αυτόματα ο host του GonnaOrder και στη συνέχεια ο ελληνικός host του point2order.
- **Default delivery method for phone orders** — **Delivery to an address**, **Pickup** ή **In-store (table / room)**.
- **Default payment category** — `LATER_CASH` (αντικαταβολή μετρητοίς), εκτός αν ορίσετε άλλη κατηγορία πληρωμής του GonnaOrder.
- **Payment return URL** — Η σελίδα στην οποία καταλήγει ο καλών μετά την πληρωμή με σύνδεσμο. Κενό σημαίνει την αρχική σελίδα του καταστήματος.

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

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

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

3. Επιλέξτε λειτουργίες. Το **Search menu** είναι ενεργό εξ ορισμού. Για παραγγελίες διανομής προσθέστε **Check delivery address**, **Delivery / pickup times** και **Place order**. Προσθέστε **Identify caller by phone** και **Customer's past orders** ώστε οι τακτικοί πελάτες να επαναλαμβάνουν παραγγελία, και **Order status** για κλήσεις του τύπου «πού είναι η παραγγελία μου». Προσθέστε **Book a table** αν δέχεστε κρατήσεις.

4. Για πληρωμή με κάρτα, προσθέστε **Send payment link** και ενεργοποιήστε επίσης την **Αποστολή SMS** στον ίδιο βοηθό: ο σύνδεσμος αποστέλλεται με SMS. Ο βοηθός δεν ζητά ποτέ στοιχεία κάρτας στην κλήση.

5. Προαιρετικά ορίστε **Max order lines**. Αφήστε το κενό για χωρίς όριο.

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

7. Καλέστε τον βοηθό (ή χρησιμοποιήστε τη **Δοκιμή agent**) και παραγγείλετε δύο είδη του μενού για διανομή σε διεύθυνση εντός ζώνης. Ο βοηθός πρέπει να επιβεβαιώσει τιμές, κόστος διανομής και ώρα, και να καταχωρήσει την παραγγελία. Ελέγξτε ότι εμφανίζεται στο GonnaOrder.

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

| Εργασία | Τι γίνεται στην κλήση |
|---------|------------------------|
| Ερωτήσεις μενού | Βρίσκει είδη με το όνομά τους και αναφέρει τιμή και διαθεσιμότητα. |
| Έλεγχος διανομής | Ενημερώνει αν η διεύθυνση ανήκει σε ζώνη διανομής, με κόστος και ελάχιστη παραγγελία, και προτείνει διαθέσιμες ώρες παράδοσης ή παραλαβής. |
| Καταχώρηση παραγγελίας | Συνθέτει και υποβάλλει την παραγγελία σε ένα βήμα, μαζί με τον έλεγχο ζώνης διανομής. |
| Πληρωμή | Δημιουργεί σύνδεσμο πληρωμής με κάρτα για την παραγγελία και τον στέλνει με SMS. |
| Τακτικοί πελάτες | Αναγνωρίζει τον καλούντα από το τηλέφωνο (ή με το όνομα), γνωρίζει την αποθηκευμένη διεύθυνση και μπορεί να επαναλάβει προηγούμενη παραγγελία. Το **Pre-fetch recent orders on call start** φορτώνει τις πρόσφατες παραγγελίες πριν μιλήσει ο βοηθός. |
| Μετά την παραγγελία | Ενημερώνει για την κατάσταση και το σύνολο μιας υπάρχουσας παραγγελίας. |
| Τραπέζια | Καταχωρεί κράτηση τραπεζιού στο κατάστημα. |

Το μενού ανανεώνεται κάθε 30 λεπτά, ώστε τα είδη που εξαντλήθηκαν και τα πιάτα ημέρας που απενεργοποιήθηκαν να ενημερώνουν τον βοηθό κατά τη διάρκεια της βάρδιας. Οι πελάτες ανανεώνονται καθημερινά. Ο **Συγχρονισμός τώρα** στην κάρτα GonnaOrder της καρτέλας **Connected** ανανεώνει και τα δύο αμέσως.

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

**Η σύνδεση ζητά κλειδί API ή όνομα χρήστη και κωδικό**

Το παράθυρο χρειάζεται είτε το email και τον κωδικό του ιδιοκτήτη είτε κλειδί API στις **Προχωρημένες ρυθμίσεις**. Χρειάζεται επίσης είτε το **Alias καταστήματος** είτε το **Store id**. Συμπληρώστε ένα από κάθε ζεύγος και δοκιμάστε ξανά.

**Η σύνδεση αποτυγχάνει επειδή δεν βρέθηκε κατάστημα με αυτό το alias**

Το alias πρέπει να είναι ακριβώς το subdomain της σελίδας παραγγελιών, χωρίς `https://` και χωρίς το domain. Αν το κατάστημα δεν έχει alias, αφήστε το πεδίο κενό και συμπληρώστε το αριθμητικό **Store id** στις **Προχωρημένες ρυθμίσεις**.

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

Το GonnaOrder απέρριψε τη σύνδεση ή το κλειδί API. Ελέγξτε το email και τον κωδικό του ιδιοκτήτη συνδεόμενοι απευθείας στο GonnaOrder, και βεβαιωθείτε ότι το **Περιβάλλον** είναι **Production** για κατάστημα σε λειτουργία.

**Ο καλών δεν λαμβάνει τον σύνδεσμο πληρωμής**

Το **Send payment link** δημιουργεί τον σύνδεσμο, αλλά το μήνυμα αποστέλλεται από το εργαλείο **Αποστολή SMS**. Ενεργοποιήστε την **Αποστολή SMS** στον βοηθό και πατήστε **Αποθήκευση**.

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

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