Μετάβαση στο περιεχόμενο

AI Agent API

Read-only API που δίνει στον AI agent σας το πλαίσιο των tickets

Το AI Agent API είναι REST API μόνο για ανάγνωση: ο AI agent σας βρίσκει το ticket ενός πελάτη με email, αριθμό παραγγελίας ή τηλέφωνο. Το chatbot ή ο βοηθός υποστήριξης που ήδη χρησιμοποιείτε διαβάζει από το TicketFlow το στάδιο και τις πιο πρόσφατες σημειώσεις του ticket, χωρίς να γράφει ποτέ τίποτα.

+€9/μήνα • Απαιτεί το TicketFlow (δωρεάν σε κάθε πλάνο) • Δωρεάν δοκιμή με πρόσκληση

Τι είναι — και τι δεν είναι

Τι κάνει

  • Δίνει στον AI agent σας δομημένο πλαίσιο tickets μέσω τεσσάρων GET endpoints
  • Βρίσκει το ticket ενός πελάτη από email, αριθμό παραγγελίας ή πλήρες τηλέφωνο
  • Επιστρέφει στάδιο, κατάσταση, όνομα πελάτη και τις πιο πρόσφατες σημειώσεις με τον συντάκτη τους
  • Εξηγεί τα δικά σας στάδια στο μοντέλο, με τις περιγραφές που έχετε γράψει εσείς

Τι δεν κάνει

  • Δεν γράφει τίποτα: δεν απαντά σε πελάτη, δεν προσθέτει σημείωση, δεν αλλάζει στάδιο, δεν κλείνει ticket
  • Δεν εκθέτει παραγγελίες, προϊόντα, απόθεμα, επιστροφές ή πωλήσεις — μόνο tickets
  • Δεν κάνει περιήγηση στην ουρά: χρειάζεται πάντα ένα συγκεκριμένο αναγνωριστικό πελάτη
  • Δεν στέλνει webhooks — ο agent ρωτά, δεν ειδοποιείται

Πώς το χρησιμοποιεί ένας AI agent υποστήριξης

  1. 1

    Ένας διαχειριστής φτιάχνει ένα token με όνομα μέσα από το πάνελ. Φαίνεται μία φορά και αποθηκεύεται μόνο ως hash.

  2. 2

    Ο agent σας ελέγχει τη σύνδεση με το GET /whoami.

  3. 3

    Όταν ένας πελάτης επικοινωνήσει μαζί σας, ο agent βρίσκει το ticket του με το GET /tickets/search, με email, αριθμό παραγγελίας (order_id) ή πλήρες τηλέφωνο.

  4. 4

    Διαβάζει στάδιο, κατάσταση και τις πιο πρόσφατες σημειώσεις και απαντά εκεί που ήδη μιλάει με τον πελάτη. Στο TicketFlow δεν γράφεται τίποτα.

Τα endpoints

Base URL: https://{το-κατάστημά-σας}.retailpilot.io/api/v1/agent — όλα τα endpoints είναι GET.

GET /whoami

Ταυτότητα του token: όνομα, δικαιώματα και τα ids των eshop στα οποία είναι περιορισμένο (null σημαίνει όλα). Χρήσιμο για έλεγχο σύνδεσης.

GET /ticket-statuses

Το γλωσσάρι σας: καταστάσεις (open/closed) και η λίστα των σταδίων σας με τις περιγραφές τους, ώστε το μοντέλο να καταλαβαίνει τι σημαίνει κάθε ελληνικό στάδιο.

GET /tickets/search

Αναζήτηση με email, order_id ή phone (προαιρετικά status=open|closed). Το order_id δέχεται και τη μορφή με #, ενώ το τηλέφωνο αγνοεί κενά και προθέματα — αρκεί να δίνετε πλήρη αριθμό. Σελιδοποίηση με page και per_page (προεπιλογή 20, έως 25).

GET /tickets/{id}

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

Παράδειγμα κλήσης

Αίτημα

curl -H "Authorization: Bearer agent_xxxxxxxx" \
  "https://your-store.retailpilot.io/api/v1/agent/tickets/search?order_id=1042"

Απάντηση

{
  "results": [
    {
      "id": "01J9F2K7X3QH4VB8ZC1M6PWT0A",
      "subject": "Λάθος μέγεθος στην παραγγελία",
      "order_number": "1042",
      "status": "open",
      "stage": "In Progress",
      "updated_at": "2026-07-24T09:12:44+00:00"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 1,
    "last_page": 1
  }
}

Λεπτομέρεια ticket

{
  "id": "01J9F2K7X3QH4VB8ZC1M6PWT0A",
  "subject": "Λάθος μέγεθος στην παραγγελία",
  "order_number": "1042",
  "status": "open",
  "stage": "In Progress",
  "customer_name": "Μαρία Π.",
  "notes": [
    {
      "summary": "Ο πελάτης ζήτησε αλλαγή σε M. Στάλθηκε κουπόνι πίστωσης...",
      "author": "Γιώργος",
      "at": "2026-07-24T09:12:44+00:00"
    }
  ],
  "notes_total": 4,
  "updated_at": "2026-07-24T09:12:44+00:00"
}

Τα στάδια επιστρέφονται όπως τα έχετε ονομάσει στο TicketFlow· το /ticket-statuses δίνει στον agent την περιγραφή που γράψατε για το καθένα.

Έλεγχος ταυτότητας και ασφάλεια

Tokens που φτιάχνετε εσείς
Δημιουργείτε ονομαστικά tokens μέσα από το πάνελ (μόνο διαχειριστής). Το token εμφανίζεται μία φορά και αποθηκεύεται μόνο ως hash (SHA-256) — δεν ανακτάται ποτέ. Μπορείτε να το απενεργοποιήσετε ή να το διαγράψετε ανά πάσα στιγμή.
Περιορισμός ανά eshop
Αν έχετε πολλά συνδεδεμένα WooCommerce sites, κάθε token μπορεί να περιοριστεί σε συγκεκριμένα — τα υπόλοιπα tickets απλώς δεν υπάρχουν για αυτό.
Προστασία από σάρωση δεδομένων
Τα tickets έχουν αδιαφανή αναγνωριστικά (ποτέ αύξοντες αριθμούς) και η αναζήτηση απαιτεί ακριβές email, αριθμό παραγγελίας ή πλήρες 10ψήφιο τηλέφωνο. Κανείς δεν μπορεί να «κατεβάσει» τη βάση πελατών σας.
Όρια ρυθμού
60 αιτήματα ανά λεπτό ανά token — σε υπέρβαση επιστρέφεται 429 με το πεδίο retry_after (δευτερόλεπτα) στο σώμα της απάντησης. Υπάρχει και ένα γενικότερο όριο 120 αιτημάτων ανά λεπτό ανά IP, οπότε προσοχή αν τρέχετε πολλά tokens από τον ίδιο διακομιστή.
Πλήρες ιστορικό προσβάσεων
Κάθε αναζήτηση και κάθε ανάγνωση ticket καταγράφεται με ώρα, IP και αποτέλεσμα — και το βλέπετε μέσα στο πάνελ, ανά token. Οι εγγραφές διατηρούνται 90 ημέρες από προεπιλογή.

Τεχνικοί περιορισμοί

  • Server-to-server: δεν στέλνονται CORS headers, οπότε η κλήση γίνεται από τον διακομιστή σας, όχι από τον browser.
  • Οι σημειώσεις επιστρέφονται συνοπτικά: οι 5 πιο πρόσφατες, με περικοπή στους 200 χαρακτήρες, συν το συνολικό πλήθος.
  • Η απάντηση περιέχει το όνομα του πελάτη — όχι email ή τηλέφωνο.
  • Τα tokens δεν λήγουν αυτόματα· η ανάκληση γίνεται χειροκίνητα.
  • Απαιτεί ενεργό το TicketFlow· όσο το API είναι ενεργό, το TicketFlow δεν απενεργοποιείται.

Τιμή

Το AI Agent API κοστίζει +€9/μήνα σε οποιοδήποτε πλάνο RetailPilot. Απαιτεί το TicketFlow, που είναι δωρεάν σε κάθε πλάνο.

Συχνές ερωτήσεις

Μπορεί ο AI agent να απαντήσει στον πελάτη μέσω του API;
Όχι. Το API είναι αυστηρά read-only — δεν δημιουργεί tickets, δεν προσθέτει σημειώσεις και δεν αλλάζει καταστάσεις. Δίνει στον agent το πλαίσιο ώστε να απαντήσει εκεί όπου ήδη μιλάει με τον πελάτη (chat, email, όποιο κανάλι χρησιμοποιείτε).
Τι δεδομένα βλέπει ο AI agent;
Μόνο tickets: θέμα, κατάσταση, στάδιο, αριθμό παραγγελίας, όνομα πελάτη και τις πιο πρόσφατες σημειώσεις με τον συντάκτη τους. Δεν βλέπει παραγγελίες, προϊόντα, απόθεμα, επιστροφές ή πωλήσεις.
Επιστρέφει το email ή το τηλέφωνο του πελάτη;
Όχι. Η απάντηση περιέχει μόνο το όνομα του πελάτη, ποτέ email ή τηλέφωνο.
Πώς το καλεί ο agent μου;
Από τον διακομιστή σας, με bearer token στην κεφαλίδα Authorization. Δεν στέλνονται CORS headers, οπότε η κλήση γίνεται από τον διακομιστή σας και όχι από browser.
Πώς φτιάχνω token;
Μέσα από το πάνελ, μόνο ως διαχειριστής. Κάθε token έχει όνομα, φαίνεται μία φορά και αποθηκεύεται μόνο ως hash (SHA-256). Το απενεργοποιείτε ή το σβήνετε όποτε θέλετε.
Πώς εμποδίζεται η μαζική εξαγωγή δεδομένων πελατών;
Η αναζήτηση απαιτεί πάντα ένα ισχυρό αναγνωριστικό — ακριβές email, αριθμό παραγγελίας ή πλήρες 10ψήφιο τηλέφωνο· φιλτράρισμα μόνο κατά κατάσταση απορρίπτεται. Τα tickets έχουν αδιαφανή αναγνωριστικά, ώστε να μην μπορεί κανείς να τα διατρέξει με τη σειρά.
Ποια είναι τα όρια ρυθμού;
60 αιτήματα το λεπτό ανά token· σε υπέρβαση επιστρέφεται 429 με το πεδίο retry_after (σε δευτερόλεπτα). Ισχύει και ένα γενικότερο όριο 120 αιτημάτων το λεπτό ανά IP.
Υποστηρίζει webhooks ή MCP;
Όχι προς το παρόν. Ο agent κάνει ερωτήματα όποτε χρειάζεται· δεν υπάρχουν εξερχόμενες ειδοποιήσεις ούτε MCP server.
Χρειάζομαι το TicketFlow;
Ναι. Το AI Agent API διαβάζει δεδομένα του TicketFlow, το οποίο περιλαμβάνεται δωρεάν σε κάθε πλάνο RetailPilot.
Πόσο κοστίζει;
+€9/μήνα σε οποιοδήποτε πλάνο RetailPilot. Απαιτεί το TicketFlow, που είναι δωρεάν σε κάθε πλάνο.

Συνδέστε τον AI agent σας στα tickets σας

Δωρεάν δοκιμή 14 ημερών, χωρίς πιστωτική κάρτα. Ακυρώνετε όποτε θέλετε.