AI Agent API
Read-only API που δίνει στον AI agent σας το πλαίσιο των tickets
Το AI Agent API είναι ένα REST API με αυθεντικοποίηση token που επιτρέπει σε έναν εξωτερικό AI agent — το chatbot ή τον βοηθό υποστήριξης που ήδη χρησιμοποιείτε — να διαβάζει τα tickets του TicketFlow: να βρίσκει το ticket ενός πελάτη από email, αριθμό παραγγελίας ή τηλέφωνο και να διαβάζει τις σημειώσεις και το στάδιό του. Είναι αυστηρά read-only: διαβάζει, δεν γράφει ποτέ.
+€9/μήνα • Απαιτεί το TicketFlow (δωρεάν σε κάθε πλάνο)
Τι είναι — και τι δεν είναι
Τι κάνει
- Δίνει στον AI agent σας δομημένο πλαίσιο tickets μέσω τεσσάρων GET endpoints
- Βρίσκει το ticket ενός πελάτη από email, αριθμό παραγγελίας ή πλήρες τηλέφωνο
- Επιστρέφει στάδιο, κατάσταση, όνομα πελάτη και τις πιο πρόσφατες σημειώσεις με τον συντάκτη τους
- Εξηγεί τα δικά σας στάδια στο μοντέλο, με τις περιγραφές που έχετε γράψει εσείς
Τι δεν κάνει
- Δεν γράφει τίποτα: δεν απαντά σε πελάτη, δεν προσθέτει σημείωση, δεν αλλάζει στάδιο, δεν κλείνει ticket
- Δεν εκθέτει παραγγελίες, προϊόντα, απόθεμα, επιστροφές ή πωλήσεις — μόνο tickets
- Δεν κάνει περιήγηση στην ουρά: χρειάζεται πάντα ένα συγκεκριμένο αναγνωριστικό πελάτη
- Δεν στέλνει webhooks — ο agent ρωτά, δεν ειδοποιείται
Τα endpoints
Base URL: https://{το-κατάστημά-σας}.retailpilot.io/api/v1/agent — όλα τα endpoints είναι GET.
/whoamiΤαυτότητα του token: όνομα, δικαιώματα και τα ids των eshop στα οποία είναι περιορισμένο (null σημαίνει όλα). Χρήσιμο για έλεγχο σύνδεσης.
/ticket-statusesΤο γλωσσάρι σας: καταστάσεις (open/closed) και η λίστα των σταδίων σας με τις περιγραφές τους, ώστε το μοντέλο να καταλαβαίνει τι σημαίνει κάθε ελληνικό στάδιο.
/tickets/searchΑναζήτηση με email, order_id ή phone (προαιρετικά status=open|closed). Το order_id δέχεται και τη μορφή με #, ενώ το τηλέφωνο αγνοεί κενά και προθέματα — αρκεί να δίνετε πλήρη αριθμό. Σελιδοποίηση με page και per_page (προεπιλογή 20, έως 25).
/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"
}Αυθεντικοποίηση & ασφάλεια
- 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 σταματά.
Τιμή
Το AI Agent API κοστίζει +€9/μήνα σε οποιοδήποτε πλάνο RetailPilot και περιλαμβάνεται στο RetailPilot Complete (€119/μήνα). Απαιτεί το TicketFlow, που είναι δωρεάν σε κάθε πλάνο.
Συχνές ερωτήσεις
- Μπορεί ο AI agent να απαντήσει στον πελάτη μέσω του API;
- Όχι. Το API είναι αυστηρά read-only — δεν δημιουργεί tickets, δεν προσθέτει σχόλια και δεν αλλάζει καταστάσεις. Δίνει στον agent το πλαίσιο ώστε να απαντήσει εκεί όπου ήδη μιλάει με τον πελάτη (chat, email, όποιο κανάλι χρησιμοποιείτε).
- Τι δεδομένα βλέπει ο AI agent;
- Μόνο tickets: θέμα, κατάσταση, στάδιο, αριθμό παραγγελίας, όνομα πελάτη και τις πιο πρόσφατες σημειώσεις με τον συντάκτη τους. Δεν βλέπει παραγγελίες, προϊόντα, απόθεμα, επιστροφές ή πωλήσεις.
- Πώς εμποδίζεται η μαζική εξαγωγή δεδομένων πελατών;
- Η αναζήτηση απαιτεί πάντα ένα ισχυρό αναγνωριστικό — ακριβές email, αριθμό παραγγελίας ή πλήρες 10ψήφιο τηλέφωνο· φιλτράρισμα μόνο κατά κατάσταση απορρίπτεται. Τα tickets έχουν αδιαφανή αναγνωριστικά, ώστε να μην μπορεί κανείς να τα διατρέξει με τη σειρά.
- Ποια είναι τα όρια ρυθμού;
- 60 αιτήματα ανά λεπτό ανά token. Σε υπέρβαση επιστρέφεται 429 με τον χρόνο αναμονής.
- Υποστηρίζει webhooks ή MCP;
- Όχι προς το παρόν. Ο agent κάνει ερωτήματα όποτε χρειάζεται· δεν υπάρχουν εξερχόμενες ειδοποιήσεις ούτε MCP server.
- Χρειάζομαι το TicketFlow;
- Ναι. Το AI Agent API διαβάζει δεδομένα του TicketFlow, το οποίο περιλαμβάνεται δωρεάν σε κάθε πλάνο RetailPilot.
Συνδέστε τον AI agent σας στα tickets σας
Δωρεάν δοκιμή 14 ημερών, χωρίς πιστωτική κάρτα. Ακυρώνετε όποτε θέλετε.