WeTalk API

• οποιοδήποτε κλειδί

Οι γλώσσες στις οποίες μπορεί να διαμορφωθεί ένα VoiceAgent.

Επιστρέφονται μόνο πακέτα με κατάσταση complete. Ένα ελλιπές πακέτο καθιστά τη γλώσσα μη διαθέσιμη — δεν υπάρχει εναλλακτική χρήση της γλώσσας αναφοράς πουθενά στην πλατφόρμα, επομένως ένα ελλιπές πακέτο δεν πρέπει να προσφέρεται ούτε σε επιλογέα.

• 200
• 401
• 403
• 429

• οποιοδήποτε κλειδί

Η γλώσσα με την οποία ανοίγει ο οδηγός ενός νέου βοηθού, βάσει της χώρας του λογαριασμού.

Η χώρα του λογαριασμού (η απάντηση κατά την εγγραφή) και η κύρια γλώσσα της, όταν το πακέτο αυτής της γλώσσας είναι πλήρες. language_code είναι null όταν δεν είναι πλήρες ή όταν δεν αναφέρεται κύρια γλώσσα για τη χώρα: τότε ο οδηγός ρωτά, χωρίς προεπιλογή. Πρόταση, ποτέ εναλλακτική επιλογή — δεν υπάρχει αγγλική εναλλακτική πουθενά.

• 200
• 401
• 403
• 429

• οποιοδήποτε κλειδί

Τα πρότυπα βοηθών από τα οποία μπορεί να επιλέξει ένας πελάτης.

Επιστρέφονται μόνο πρότυπα με ένδειξη διαθέσιμου. Το σύνολο είναι περιορισμένο και χωρίς σελιδοποίηση.

ΤΡΟΠΟΠΟΙΗΣΗ 2026-10-09 (plan-015 INT-B): εκτός από data, αν μια κλήση μπορεί να προωθηθεί σε τηλέφωνο και τα δύο στοιχεία που αναφέρει το κείμενο προώθησης — οι τιμές που getVoiceAgent παρέχει — ώστε ο οδηγός Νέου βοηθού, που διαβάζει τα πρότυπα πριν υπάρξει βοηθός, να προσφέρει προώθηση μόλις ενεργοποιηθεί.

• 200
• 401
• 403
• 429

• οποιοδήποτε κλειδί

Οι διαθέσιμες προς πώληση βαθμίδες και τα όρια μονάδων καναλιού τους.

• 200
• 401
• 403
• 429

• οποιοδήποτε κλειδί

Οι φωνές που έχουν ελεγχθεί ακουστικά, με τις γλώσσες που μιλά καθεμία.

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

• 200
• 401
• 403
• 429

• οποιοδήποτε κλειδί

Ακούστε μια φωνή να λέει τον χαιρετισμό σας σε μία γλώσσα.

Η απάντηση είναι αρχείο WAV (16-bit mono PCM στον ρυθμό της ίδιας της φωνής) με τη φωνή να λέει text σε language_code, ακριβώς όπως θα την άκουγε ένας καλών. Ο χαιρετισμός μεταφέρεται στο σώμα: δεν εμφανίζεται ποτέ σε URL, γραμμή καταγραφής ή όνομα αποθηκευμένου αρχείου. Μπορεί να το ζητήσει οποιοδήποτε συνδεδεμένο μέλος και οποιοδήποτε κλειδί API του λογαριασμού.

Την πρώτη φορά που ακούγεται ένας χαιρετισμός, συντίθεται και αποθηκεύεται για τον οργανισμό σας· αν ακούσετε ξανά τον ίδιο χαιρετισμό με την ίδια φωνή και γλώσσα, γίνεται ανάγνωση του αποθηκευμένου αρχείου. Αν αλλάξετε τον χαιρετισμό και πατήσετε Αναπαραγωγή, συντίθεται το νέο κείμενο. Η WeTalk πληρώνει για την ομιλία· δεν χρεώνεται τίποτα.

404 voice_sample_unavailable — η φωνή δεν μιλά τη γλώσσα. Δεν συντίθεται τίποτα. 429 rate_limited — αυτό το άτομο έχει συνθέσει πολλούς νέους χαιρετισμούς την τελευταία ώρα· Retry-After αναφέρει πότε να δοκιμάσετε ξανά. Η επανάληψη ενός χαιρετισμού που έχει ήδη ακουστεί δεν περιορίζεται ποτέ. 503 voice_sample_unavailable — ο χαιρετισμός δεν μπορεί να παραχθεί αυτή τη στιγμή (ο συνθέτης ή ο χώρος αποθήκευσης δεν απάντησε). Δοκιμάστε αργότερα· δεν προσφέρεται άλλη φωνή ή γλώσσα ως εναλλακτική.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 429
• 503

• οποιοδήποτε κλειδί

Ακούστε μια φωνή να λέει μια σύντομη φράση δείγματος σε μία γλώσσα.

Η απάντηση είναι αρχείο WAV (16-bit mono PCM στον ρυθμό της ίδιας της φωνής) με τη φωνή να λέει τη φράση δείγματος της γλώσσας, ακριβώς όπως θα την άκουγε ένας καλών σε συνομιλία. Οποιοδήποτε συνδεδεμένο μέλος και οποιοδήποτε κλειδί API μπορεί να το ζητήσει, όπως μπορεί να διαβάσει τον κατάλογο· ο περιηγητής μπορεί να το αποθηκεύσει προσωρινά για μία ημέρα.

404 voice_sample_unavailable — η γλώσσα δεν έχει φράση δείγματος ή η φωνή δεν μιλά τη γλώσσα. Δεν υπάρχει εναλλακτική χρήση άλλης γλώσσας ή φωνής. 503 voice_sample_unavailable — το δείγμα υπάρχει κατ’ αρχήν, αλλά δεν μπορεί να παραχθεί αυτή τη στιγμή (ο συνθέτης ή ο χώρος αποθήκευσης δεν απάντησε). Δοκιμάστε αργότερα.

• 200
• 400
• 401
• 403
• 404
• 429
• 503

• agent:read

Κάθε VoiceAgent σε αυτόν τον λογαριασμό, με τα νεότερα πρώτα.

Χωρίς σελιδοποίηση, σκόπιμα. Το Design §5.1 ζητά cursors στις συλλογές με συχνές προσθήκες — συνομιλίες, καθολικό, αρχείο παραδόσεων — και τα VoiceAgents ενός χώρου εργασίας δεν ανήκουν σε αυτές: η οθόνη είναι μια σύντομη λίστα που διαβάζεται από πάνω προς τα κάτω και η καταμέτρηση από πάνω («N βοηθοί · M απαντούν τώρα») αφορά ολόκληρο το σύνολο, όχι μία σελίδα.

Μπορεί να το διαβάσει κάθε ρόλος μέλους, συμπεριλαμβανομένου του Viewer: η απόφαση προϊόντος Q10 δίνει στον Viewer πρόσβαση μόνο για ανάγνωση σε αναλύσεις και αποτελέσματα, και αυτό ακριβώς είναι. Ο Viewer δεν βλέπει τον αριθμό του καλούντος σε μια συνομιλία, κάτι που επιβάλλεται μέσω της προβολής της βάσης δεδομένων και όχι με περιορισμό αυτής της λίστας.

• 200
• 401
• 403
• 429

• agent:write

Δημιουργήστε ένα VoiceAgent και την πρώτη εργασία build του, που περιμένει τα έγγραφα.

Τέσσερις εγγραφές, σε μία συναλλαγή: voice_agent (κατάσταση building), agent_version v1 (κατάσταση building), build_job (κατάσταση queued) και τις έξι build_step εγγραφές του. ΔΕΝ προσθέτει στην ουρά build.start (plan-003, design §16.8): το build διαβάζει τα έγγραφα της έκδοσης, που υπάρχουν μόνο αφού ο οδηγός ανεβάσει και επιβεβαιώσει το καθένα (createAgentDocumentUpload, confirmAgentDocument). startVoiceAgentBuild τότε προσθέτει στην ουρά build.start, μία φορά, στη δική του συναλλαγή — εκεί βρίσκεται το συμβόλαιο outbox. Η εργασία build παραμένει queued μέχρι τότε.

Τρεις κανόνες ελέγχονται έναντι του καταλόγου της πλατφόρμας, επειδή μόνο εκεί ισχύουν: το πρότυπο πρέπει να είναι available, κάθε γλωσσικό πακέτο πρέπει να είναι complete, και η φωνή κάθε γλώσσας πρέπει να τη μιλά — voice_by_language ορίζει μία φωνή ανά γλώσσα, voice_id μία φωνή για κάθε γλώσσα (ακριβώς ένα από τα δύο· plan-015, 2026-10-09: ένα ζεύγος που αποτυγχάνει είναι 400 validation_failed στο voice_by_language.<language>, με αναφορά της γλώσσας). Η έκδοση 1 αποθηκεύει τον πίνακα αντιστοίχισης και, ως voice_id, τη φωνή της αρχικής γλώσσας. Ένας βοηθός διανομής (σχήμα αναφοράς pizzabot-menu-md-v1) μιλά προς το παρόν μία γλώσσα και απορρίπτεται αν έχει περισσότερες από μία. Το μήνυμα κάθε απόρριψης γράφεται για το άτομο που χρησιμοποιεί τον οδηγό· τα code και field δηλώνουν ποιος κανόνας ήταν.

Δέχεται Idempotency-Key. Ένας οδηγός του οποίου η απάντηση χάθηκε πρέπει να μπορεί να επαναλάβει το αίτημα χωρίς να δημιουργηθεί δεύτερο VoiceAgent.

«Έναρξη από κοινόχρηστη διαμόρφωση» (plan-014): με resource_share_id, ο νέος βοηθός αντιγράφει μια διαμόρφωση βοηθού που κοινοποίησε άλλος χώρος εργασίας και αποδέχθηκε αυτός (listSharedVoiceAgentConfigurations). Το είδος βοηθού, οι γλώσσες, η φωνή, ο χαιρετισμός, ο διακόπτης ηχογράφησης και η ταυτόχρονη εξυπηρέτηση συμπληρώνουν όσα παραλείπει το αίτημα· το είδος βοηθού δεν μπορεί να αλλάξει. Η αντιγραφή καταγράφεται ως προέλευση της κοινοποίησης στην ίδια συναλλαγή, μία φορά ανά χώρο εργασίας (409 conflict για δεύτερη αντιγραφή)· μια ανακληθείσα κοινοποίηση είναι 409 share_revoked, μια κοινοποίηση που δεν μπορεί να χρησιμοποιήσει αυτός ο χώρος εργασίας 404 share_unavailable. Το όριο βοηθών του οργανισμού εφαρμόζεται όπως σε κάθε δημιουργία (409 resource_limit_reached). Η αντιγραφή παίρνει επίσης τη ζώνη ώρας, τις ειδικές ημερομηνίες και τις επιλογές απάντησης της σταθερά ορισμένης έκδοσης, όπου παραλείπονται από το αίτημα.

Οι απαντήσεις για την εξυπηρέτηση (plan-015, 2026-10-09): η δική του, του VoiceAgent, time_zone (του χώρου εργασίας όταν παραλείπεται, γραμμένη στην έκδοση), οι special_date[], και τι γίνεται όταν είναι κλειστό ή απασχολημένο (after_hours_choice, busy_choice, longest_wait_minute, forward_to). Η προώθηση ελέγχεται πριν γραφτεί οτιδήποτε: 422 forward_unavailable όταν η προώθηση δεν είναι διαθέσιμη, 400 forward_destination_refused για αριθμό εκτός των ελεγμένων χωρών, αριθμό υψηλής χρέωσης, έκτακτης ανάγκης ή σύντομο αριθμό, ή αριθμό στον οποίο απαντά η WeTalk.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• agent:read

Ένα VoiceAgent, με τα στοιχεία της σημερινής ημέρας και του τρέχοντος μήνα.

Το VoiceAgent, με όσα εμφανίζει η σελίδα του (plan-015, 2026-10-09): τη φωνή κάθε γλώσσας, τις απαντήσεις εξυπηρέτησης της ενεργής έκδοσης (ζώνη ώρας, ειδικές ημερομηνίες, τι γίνεται όταν είναι κλειστό ή απασχολημένο και την πραγματική αναμονή των καλούντων), αν η online πληρωμή είναι μη διαθέσιμη για VoiceAgent που δέχεται μόνο online πληρωμές, και αν η προώθηση σε τηλέφωνο είναι διαθέσιμη με τα όρια κουδουνίσματος και διάρκειας.

• 200
• 401
• 403
• 404
• 429

• agent:write

Ενεργοποιήστε ή απενεργοποιήστε την «Ηχογράφηση κλήσεων», δημοσιεύοντας νέα έκδοση (plan-003 RC-47).

Το αν ένα VoiceAgent ηχογραφεί ορίζεται σταθερά στις εκδόσεις του, όπως κάθε άλλο στοιχείο του τρόπου απάντησής του: μια έκδοση είναι αμετάβλητη και μια συνομιλία διατηρεί την έκδοση με την οποία έγινε δεκτή. Επομένως, αυτό δεν επεξεργάζεται την ενεργή έκδοση. Την αντιγράφει — την ίδια επικυρωμένη διαμόρφωση με αλλαγμένο το recordingEnabled και το ίδιο μετρημένο πρόθεμα prompt — ως νέα ready έκδοση και τη δημοσιεύει μέσω του ίδιου compare-and-set, της ίδιας εγγραφής ελέγχου και του ίδιου μηνύματος outbox όπως το publishAgentVersion, σε μία συναλλαγή. Μια συνομιλία που ήδη εξελίσσεται διατηρεί τη ρύθμιση με την οποία ξεκίνησε· η επόμενη λαμβάνει τη νέα έκδοση.

recording_enabled είναι το μόνο πεδίο που αλλάζει αυτή η διαδρομή. expected_live_version_seq απαιτείται, όπως στη δημοσίευση. Αν ζητηθεί η τιμή που ήδη έχει η ενεργή έκδοση, δεν δημοσιεύεται τίποτα και η απάντηση είναι changed: false. Ένα VoiceAgent χωρίς ακόμη ενεργή έκδοση είναι 422 agent_version_not_ready: το πρώτο build του χρησιμοποιεί την τιμή με την οποία δημιουργήθηκε.

Με recording_enabled: false το runtime δεν εκφωνεί ειδοποίηση ηχογράφησης, δεν καταγράφει ήχο και αφήνει το conversation.recording_consent στην τιμή not_asked.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• conversation:read
• βαρύ

Όλα όσα εμφανίζει η καρτέλα Αναλύσεις, για ένα χρονικό παράθυρο, σε μία ανάγνωση.

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

Κάθε ανάλυση είναι πλήθος, ποτέ ποσοστό: ο παρονομαστής αποστέλλεται μία φορά, στο figure.conversation_count, και η οθόνη κάνει τη διαίρεση. Δύο ποσοστά που στρογγυλοποιούνται χωριστά δεν αθροίζονται σε 100 και ένα ποσοστό χρονικού παραθύρου που δεν βλέπει ο καλών δεν μπορεί να ελεγχθεί.

Οι ομάδες ορίζονται στη ζώνη ώρας του χώρου εργασίας που αναφέρει η απάντηση, ώστε οι «ώρες αιχμής» να σημαίνουν τις ώρες που είχε φόρτο η επιχείρηση, όχι ο διακομιστής. Μετρώνται μόνο συνομιλίες που απαντήθηκαν και δεν είναι δοκιμαστικές, και η απάντηση το δηλώνει στο counts_answered_only και excludes_test αντί να πρέπει να συναχθεί από έναν αριθμό που φαίνεται χαμηλός.

since και until είναι προαιρετικά και δεν έχουν προεπιλογή: η απουσία σημαίνει ότι δεν υπάρχει όριο σε εκείνη την πλευρά. Μια τιμή που δεν αναλύεται δίνει 400, ποτέ σιωπηρή διεύρυνση του εύρους.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:read

Πότε απαντά αυτό το VoiceAgent και τι κάνει όταν δεν μπορεί.

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

• 200
• 401
• 403
• 404
• 429

• agent:write

Οι απαντήσεις από τις οποίες δημιουργήθηκε μια ολοκληρωμένη έκδοση, για τη φόρμα Επεξεργασίας (έλεγχος πύλης πελατών

Διαβάζονται από το επικυρωμένο έγγραφο διαμόρφωσης της έκδοσης (το προσχέδιο του οδηγού αντικαθίσταται όταν πετύχει το build): οι ώρες λειτουργίας ως εβδομάδα και ως πρόταση που διαβάζει το build, το κόστος διανομής και το όριο δωρεάν διανομής, ο τρόπος πληρωμής των καλούντων, οι γλώσσες, η φωνή, ο χαιρετισμός και η «Ηχογράφηση κλήσεων», καθώς και τα έγγραφα της έκδοσης. Ένα πεδίο κειμένου προτύπου που δεν περιέχεται στη διαμόρφωση αναφέρεται στο unrecovered_field και πρέπει να απαντηθεί ξανά. Η ενεργή έκδοση, εκτός αν το agent_version_id αναφέρει άλλη ολοκληρωμένη έκδοση. edit_refusal αναφέρει γιατί δεν μπορεί να αποθηκευτεί τώρα μια αλλαγή (εκτελείται build). Owner ή Admin.

• 200
• 401
• 403
• 404
• 409
• 422
• 429

• agent:write

Αρχειοθετήστε ένα VoiceAgent που δεν απαντά πλέον (έλεγχος πύλης πελατών

Ορίζει archived_at, με καταγραφή ελέγχου (voice_agent.archived): φεύγει από listVoiceAgents — τη λίστα, την καταμέτρηση της πλευρικής στήλης και κάθε επιλογέα — ενώ διατηρούνται οι συνομιλίες, οι παραγγελίες και το ιστορικό του και το getVoiceAgent εξακολουθεί να απαντά γι’ αυτό. Δεν διαγράφεται τίποτα.

Απορρίπτεται (409 voice_agent_archive_refused) όσο είναι ενεργό (θέστε το πρώτα σε παύση), όσο αριθμός ή endpoint εξακολουθεί να δρομολογεί σε αυτό (οι αριθμοί κατέχονται από τη WeTalk: ζητήστε από τη WeTalk μετακίνηση ή αποδέσμευση) ή όσο εκτελείται το build του. Ένα build που ακόμη περιμένει έγγραφα κλείνει μαζί του. Η αρχειοθέτηση ήδη αρχειοθετημένου VoiceAgent δεν αλλάζει τίποτα (changed: false).

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• agent:write
• βαρύ

Μιλήστε στην ενεργή έκδοση του βοηθού από το μικρόφωνο του περιηγητή.

Μια πραγματική συνομιλία στην ενεργή έκδοση μέσω της υπηρεσίας μεταφοράς φωνής περιηγητή της WeTalk, με ένδειξη is_test και χρέωση όπως κάθε άλλο λεπτό από τη στιγμή που απαντάται (AC-38), για έως max_duration_second (15 λεπτά). Η κονσόλα ζητά πρώτα άδεια μικροφώνου και δεν στέλνει τίποτα αν απορριφθεί. Διαβάστε τη δοκιμή με readTestCall ?conversation_id= και τερματίστε την με endTestCall — τις ίδιες δύο διαδρομές που χρησιμοποιεί μια τηλεφωνική δοκιμή.

Ελέγχεται με τη σειρά και τα μηνύματα της τηλεφωνικής δοκιμής, χωρίς τον έλεγχο «διαθέτει αριθμό»: ο βοηθός (404 voice_agent_not_found)· η ενεργή έκδοσή του (422 agent_version_not_ready)· η γλώσσα (422 language_unavailable)· ο βοηθός απαντά συνομιλίες (422 voice_agent_paused)· το τρέχον υπόλοιπο και ο προϋπολογισμός του χώρου εργασίας πληρώνουν ένα δευτερόλεπτό της (402 trial_exhausted, credit_exhausted, hard_stop_reached, budget_exceeded)· το μοντέλο εκτελείται (503 model_pool_unavailable). Κάθε απόρριψη τελειώνει με «Δεν χρεώθηκε τίποτα.» και δεν γράφεται τίποτα.

Μία δοκιμή περιηγητή ανά μέλος ανά βοηθό: η έναρξη μιας τερματίζει την ήδη εκτελούμενη δοκιμή σας σε αυτόν τον βοηθό και την αναφέρει στο replaced_conversation_id.

Η απάντηση περιέχει webrtc — τη διεύθυνση της υπηρεσίας μεταφοράς, token συμμετοχής (δύο λεπτά, το δωμάτιο μόνο αυτής της συνομιλίας, μόνο μικρόφωνο), join_by, και τις δύο ταυτότητες συμμετεχόντων — καθώς και το id της συνομιλίας, στο state = connecting.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 402
• 403
• 404
• 422
• 429
• 503

• agent:write

Ξεκινήστε το build του VoiceAgent από τα επιβεβαιωμένα έγγραφά του.

Προσθέτει στην ουρά το build της υπό κατασκευή έκδοσης του VoiceAgent, μία φορά. Δεύτερη έναρξη δίνει 409 build_already_started· πρότυπο που δημιουργείται από έγγραφα χωρίς κανένα επιβεβαιωμένο δίνει 422 build_no_document. Απαιτεί Idempotency-Key.

• 202
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• agent:read

Τα endpoints που φτάνουν σε αυτό το VoiceAgent.

Μία εγγραφή ανά channel_binding: ποιο μέσο μεταφέρει, με ποιο στοιχείο διευθυνσιοδοτείται και πόσες συνομιλίες έφτασαν σε αυτό τις τελευταίες επτά ημέρες.

• 200
• 401
• 403
• 429

• agent:read

Πόσες συνομιλίες εξυπηρετεί αυτό το VoiceAgent και πόσες επιτρέπεται να εξυπηρετεί.

in_use μετρά συνομιλίες χωρίς χρόνο λήξης. channel_unit_ceiling είναι το πραγματικό όριο στο οποίο η διαδικασία εισδοχής περιορίζει τις νέες συνομιλίες: το δικό του, του VoiceAgent, channel_unit_limit όταν έχει οριστεί, διαφορετικά το ενεργό agent_versionτου version_ceiling. Είναι null όταν δεν έχει δημοσιευτεί τίποτα — ένα VoiceAgent χωρίς ενεργή έκδοση δεν δέχεται κανέναν, κάτι που δεν ισοδυναμεί με μηδενικό όριο. entitlement_ceiling είναι το δικαίωμα ταυτόχρονων συνομιλιών του οργανισμού, η μέγιστη τιμή στην οποία μπορεί να οριστεί το channel_unit_limit .

• 200
• 401
• 403
• 404
• 429

• agent:write

Αλλάξτε πόσες συνομιλίες δέχεται αυτό το VoiceAgent ταυτόχρονα.

Ορίζει το δικό του όριο γραμμών του VoiceAgent, channel_unit_limit, χωρίς δημοσίευση νέας έκδοσης. null το επαναφέρει στο όριο της δημοσιευμένης έκδοσης. Όποιος μπορεί να αλλάξει τον βοηθό (Owner, Admin, Member, Developer) μπορεί να το αλλάξει, έως το δικαίωμα ταυτόχρονων συνομιλιών του οργανισμού· πάνω από αυτό η απάντηση είναι 422 channel_unit_limit_above_entitlement με error.detail.entitlement_ceiling, και ο τρόπος αύξησης είναι «Αίτημα για περισσότερες γραμμές» (POST /v1/quota-requests).

Οι νέες συνομιλίες εφαρμόζουν το όριο μέσα σε λίγα δευτερόλεπτα. Ένα χαμηλότερο όριο δεν τερματίζει ποτέ συνομιλία σε εξέλιξη: οι νέοι καλούντες συναντούν τη συμπεριφορά απασχολημένου βοηθού μέχρι να μιλούν λιγότεροι από το νέο όριο. Κάθε αλλαγή καταγράφεται στο αρχείο ελέγχου (voice_agent.channel_unit_limit_changed, παλιά και νέα τιμή)· ο ορισμός της ήδη υπάρχουσας τιμής δεν αλλάζει ούτε καταγράφει τίποτα.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• agent:read

Πώς φτάνουν οι κλήσεις σε αυτό το VoiceAgent και τι δεν μπορεί να υποσχεθεί κανείς γι’ αυτό.

Ο αριθμός, ο πάροχος, η διεύθυνση SIP με το domain στο οποίο βρίσκεται, το endpoint συμβάντων, η πιο πρόσφατη παρατήρηση εγγραφής — ή null όταν δεν υπάρχει — και το συμπέρασμα για την εφεδρική δρομολόγηση εισερχομένων.

inbound_failover.possible είναι πάντα false. Ένας αριθμός ανήκει σε έναν πάροχο και η μετακίνησή του είναι διαδικασία φορητότητας που μετριέται σε ημέρες· αναφέρεται η εναλλακτική (byo_sip_dual_home) ώστε η απάντηση να μην είναι απλώς «όχι».

• 200
• 401
• 403
• 404
• 429

• agent:read

Τα ονόματα των αρχείων από τα οποία απαντά η ενεργή έκδοση του βοηθού (plan-015 TC1).

Τα έγγραφα από τα οποία δημιουργήθηκε η ενεργή έκδοση, με την παλαιότερη μεταφόρτωση πρώτη: εκείνα της νεότερης ολοκληρωμένης έκδοσης, στην ενεργή έκδοση ή πριν από αυτή, που έχει έγγραφα (μια επεξεργασία κάνει build χωρίς νέα μεταφόρτωση). Ένας βοηθός χωρίς ενεργή έκδοση απαντά με κενή λίστα. Μόνο ονόματα — τα αποθηκευμένα αρχεία δεν είναι προσβάσιμα από εδώ. Η υπόδειξη κειμένου της κονσόλας Δοκιμών τα αναφέρει («Ο βοηθός απαντά από …»).

• 200
• 401
• 403
• 404
• 429

• agent:write

Σύνδεσμος μεταφόρτωσης μικρής διάρκειας, μόνο για εγγραφή, για ένα έγγραφο της υπό κατασκευή έκδοσης.

Επιστρέφει σύνδεσμο στον οποίο ο περιηγητής στέλνει με PUT τα bytes ενός αρχείου, απευθείας στον χώρο αποθήκευσης, και υπογεγραμμένη άδεια μεταφόρτωσης για την επιβεβαίωση. Δεν καταγράφεται ακόμη τίποτα: το έγγραφο υπάρχει όταν επιβεβαιωθεί.

Μόνο όσο το build του VoiceAgent περιμένει έγγραφα (στην ουρά, πριν ξεκινήσει): διαφορετικά 409 build_already_started. Έως το όριο εγγράφων ανά έκδοση της πλατφόρμας (422 document_count_exceeded). Απαιτεί Idempotency-Key.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 413
• 415
• 422
• 429

• agent:write

Καταγράψτε ένα μεταφορτωμένο έγγραφο αφού ελέγξετε το αποθηκευμένο μέγεθος και το SHA-256 του.

Επαληθεύει την άδεια μεταφόρτωσης, διαβάζει ξανά το αποθηκευμένο αντικείμενο και ελέγχει ότι μέγεθος, τύπος περιεχομένου και SHA-256 είναι τα δηλωμένα. Μια ασυμφωνία απορρίπτει τα αποθηκευμένα bytes και απαντά 422 document_mismatch. Μια αντιστοιχία καταγράφει το έγγραφο και μια εγγραφή ελέγχου.

Η επιβεβαίωση του ίδιου εγγράφου δύο φορές επιστρέφει το ίδιο έγγραφο. Μια άδεια πλαστή, αλλοιωμένη ή εκδοθείσα για άλλο έγγραφο ή λογαριασμό δίνει 400 upload_grant_invalid· μια άδεια που έχει λήξει δίνει 410 upload_grant_expired.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 410
• 422
• 429

• agent:write

Ανοίξτε την επόμενη έκδοση από επεξεργασμένες απαντήσεις και δημιουργήστε τη (έλεγχος πύλης πελατών

Εισάγει την επόμενη agent_version (κατάσταση building, τις επεξεργασμένες απαντήσεις ως προσχέδιό της), ένα queued build_job και τα έξι βήματά του. Η ενεργή έκδοση συνεχίζει να απαντά: ένα VoiceAgent που έχει ήδη ενεργή έκδοση δεν δημοσιεύεται από το build του (απόφαση D14 (a))· η νέα έκδοση δοκιμάζεται στην καρτέλα Εκδόσεις και δημοσιεύεται με publishAgentVersion, που διατηρεί τις συνομιλίες σε εξέλιξη στην έκδοση με την οποία ξεκίνησαν (design §7.5).

documents: "keep" αντιγράφει τα έγγραφα της βασικής έκδοσης στη νέα και ξεκινά το build (202). documents: "replace" ανοίγει την έκδοση χωρίς έγγραφα (201)· μεταφορτώστε τα με createAgentDocumentUpload / confirmAgentDocument, έπειτα startVoiceAgentBuild.

Ελέγχεται πριν γραφτεί οτιδήποτε με τους ίδιους κανόνες όπως createVoiceAgent και έπειτα από τον ίδιο τον αναγνώστη του build, ώστε μη αναγνώσιμες ώρες ή χρέωση να δίνουν 400 με αναφορά του πεδίου. 409 build_in_progress όσο εκτελείται build (ένα που απλώς περιμένει έγγραφα κλείνει και αντικαθίσταται)· 409 live_version_seq_stale; 409 voice_agent_archived; 422 agent_version_not_ready χωρίς ολοκληρωμένη έκδοση ως βάση επεξεργασίας· 422 build_no_document για «keep» χωρίς έγγραφο· 422 edit_unchanged όταν δεν άλλαξε τίποτα· 422 edit_needs_no_build όταν άλλαξε μόνο το recording_enabled — αυτός ο διακόπτης δημοσιεύεται ανεξάρτητα μέσω updateVoiceAgent, χωρίς build. Owner ή Admin· με καταγραφή ελέγχου (voice_agent.edit_requested)· απαιτεί Idempotency-Key.

Οι απαντήσεις εξυπηρέτησης (plan-015, 2026-10-09) μπορούν να αλλάξουν εδώ· όποια παραλείπεται διατηρεί την τιμή της βασικής έκδοσης· κάθε αλλαγή χρειάζεται build. Μια προώθηση — δηλωμένη ή διατηρημένη — ελέγχεται όπως στη δημιουργία: 422 forward_unavailable, 400 forward_destination_refused.

Δέχεται σώμα αιτήματος JSON.

• 201
• 202
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• conversation:read

Συνομιλίες για τις οποίες κάποιος ή κάτι επισήμανε πρόβλημα.

Ένας πίνακας, δύο κατηγορίες προέλευσης. Ένα μέλος επισημαίνει συνομιλία από το Ιστορικό, ένας operator από την κονσόλα προσωπικού, το runtime αυτόματα, ένας πάροχος με αναφορά — και οι τέσσερις καταλήγουν στο conversation_flag και διακρίνονται από το raised_by_kind. Η λίστα επιστρέφει και τις τέσσερις προελεύσεις, επειδή η απόκρυψη όσων επισήμανε operator θα άφηνε τον πελάτη με λίστα που δεν συμφωνεί με όσα βλέπει η WeTalk.

state έχει προεπιλογή open, δηλαδή όσα δεν έχουν αντιμετωπιστεί.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:write

Σημειώστε ότι ένα επισημασμένο πρόβλημα αντιμετωπίστηκε.

Ορίζει handled_at και καταγράφει ποια κατηγορία προέλευσης το αντιμετώπισε, στην αντίστοιχη στήλη. Η επίλυση ήδη επιλυμένου προβλήματος δεν είναι σφάλμα — δύο άτομα μπορεί να πατήσουν ταυτόχρονα — αλλά καταγράφεται ο πρώτος που το επέλυσε.

• 200
• 401
• 403
• 404
• 429

• conversation:read

Ερωτήσεις καλούντων στις οποίες δεν απαντούν τα έγγραφα, ομαδοποιημένες και με καταμέτρηση.

Ταξινομημένες βάσει του πλήθους των καλούντων που τις ρώτησαν. state επιλέγει σε ποια από τις τέσσερις καταστάσεις βρίσκεται ένα κενό και έχει προεπιλογή open· μια παρούσα αλλά άγνωστη τιμή δίνει 400 αντί για σιωπηρή διεύρυνση της λίστας.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:write

Βάλτε μια απάντηση στην ουρά για το επόμενο προσχέδιο.

Συμπληρώνει answer_text και αφήνει answered_into_agent_version_id null, που σημαίνει «στην ουρά». Δεν δημοσιεύεται και δεν δημιουργείται τίποτα — publishAnswers αποθηκεύει τις απαντήσεις της ουράς ως προσχέδιο έκδοσης και ο βοηθός συνεχίζει να λέει όσα λέει η ενεργή έκδοση μέχρι κάποιος να δημοσιεύσει το προσχέδιο από τις Εκδόσεις.

Ένα κενό που έχει ήδη ενσωματωθεί σε έκδοση — ακόμη και προσχέδιο — απορρίπτεται: εκείνη η απάντηση είναι μέρος μιας αμετάβλητης agent_version, και μια διόρθωση απαντάται σε νέο κενό και μπαίνει στο επόμενο προσχέδιο.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:write

Σημειώστε ότι ένα κενό δεν αξίζει να απαντηθεί.

Ορίζει dismissed_at. Η εγγραφή διατηρείται αντί να διαγραφεί: η ομάδα είναι απόδειξη ότι οι καλούντες ρώτησαν και η διαγραφή της θα επέτρεπε να εντοπιστεί ξανά η ίδια ερώτηση ως νέα τον επόμενο μήνα.

• 200
• 401
• 403
• 404
• 429

• agent:write

Αποθηκεύστε τις απαντήσεις της ουράς ως προσχέδιο έκδοσης.

Δημιουργεί προσχέδιο· δεν δημοσιεύει τίποτα (plan-015 DRF, ADR 0043). Ενσωματώνει κάθε απάντηση που δεν είναι ακόμη ενεργή — κάθε απάντηση στην ουρά (κενό με answer_text και χωρίς answered_into_agent_version_id) και κάθε απάντηση ήδη σε προσχέδιο που δεν δημοσιεύτηκε ποτέ — σε νέα ready έκδοση που βασίζεται στην ενεργή: τη διαμόρφωση της ενεργής έκδοσης με διευρυμένες απαντήσεις και το πρόθεμα prompt μετρημένο ξανά. Το προσχέδιο δεν έχει published_at, το base_agent_version_id είναι η ενεργή έκδοση και κάθε ενσωματωμένο κενό την αναφέρει από τότε. Μια ερώτηση της ουράς ίση με μία ήδη ενεργή την αντικαθιστά.

Δεν υπάρχει agent_version.published μήνυμα outbox και η ενεργή έκδοση δεν αλλάζει: live_version_id και live_version_seq επιστρέφουν όπως ήταν και κάθε συνομιλία συνεχίζει να φτάνει στην ενεργή έκδοση μέχρι κάποιος με δικαίωμα δημοσίευσης να δημοσιεύσει το προσχέδιο από τις Εκδόσεις (publishAgentVersion, που απορρίπτει 409 draft_base_changed αν στο μεταξύ ενεργοποιήθηκε άλλη έκδοση, εκτός αν αναγνωριστεί η αλλαγή). Η εγγραφή ελέγχου είναι agent_version.draft_created. Η επανεκτέλεση αφού ενεργοποιηθεί άλλη έκδοση είναι η «Αναδημιουργία στην τρέχουσα έκδοση» των απαντήσεων.

Το operationId διατηρεί το προηγούμενο όνομά του ώστε να μη χαλάσουν οι παραγόμενοι clients.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• agent:read

Οι αριθμοί στους οποίους απαντά αυτό το VoiceAgent.

Τόσο αριθμοί παρόχου όσο και αριθμοί του δικού σας SIP trunk. Ένας αριθμός trunk έχει provider: sip_trunk, carrier: null, και αναφέρει το trunk του.

• 200
• 401
• 403
• 429

• agent:write
• credit:spend

Ξεκινήστε έναν έλεγχο βελτιστοποίησης. Καταγράφεται και μπαίνει στην ουρά για το worker· δεν εκτελείται εδώ.

Καταγράφει τον έλεγχο με state = idle και την τιμή του (price_minor, currency = EUR), τον βάζει στην ουρά του optimisation_review.run θέμα outbox και γράφει την εγγραφή ελέγχου optimisation_review.requested, όλα σε μία συναλλαγή βάσης δεδομένων. Ο έλεγχος εκτελείται πίσω από το frontier wall στο factory, ποτέ στη συστοιχία μοντέλων· το worker που τον εκτελεί δεν έχει ακόμη εγκατασταθεί, επομένως ο έλεγχος παραμένει idle και η απάντηση το δηλώνει στο queued.

Δεν μετακινούνται χρήματα κατά τη δημιουργία. Η χρέωση λαμβάνεται όταν ολοκληρωθεί ο έλεγχος, στην ίδια συναλλαγή που τον σημειώνει ως done· ένας έλεγχος που αποτυγχάνει δεν χρεώνεται ποτέ.

payer = customer χρεώνει τον λογαριασμό και απαιτεί η τρέχουσα διαθέσιμη πίστωση να καλύπτει την τιμή. payer = wetalk απορροφά το κόστος και αποτελεί απόφαση μόνο operator της WeTalk: χρειάζεται absorbed_reason, τουλάχιστον δώδεκα χαρακτήρες. Ένας operator της WeTalk που ενεργεί ως μέλος δεν μπορεί να χρεώσει τον λογαριασμό (403 impersonation_forbidden, και η απόρριψη γράφεται στο αρχείο ελέγχου του λογαριασμού)· ένα άτομο ή κλειδί API δεν μπορεί να απορροφήσει το κόστος (403 permission_denied).

Idempotency-Key είναι απαιτούμενο: ένα επαναλαμβανόμενο αίτημα επιστρέφει τον πρώτο έλεγχο αντί να βάλει στην ουρά δεύτερο πληρωμένο έλεγχο.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• agent:read

Τι θα κόστιζε κάθε βάθος ελέγχου βελτιστοποίησης για ένα χρονικό παράθυρο και αν μπορεί να εκτελεστεί.

Μετρά τις συνομιλίες που θα διάβαζε ένας έλεγχος — αυτού του VoiceAgent, στον χώρο εργασίας του διαπιστευτηρίου, ολοκληρωμένες και μη δοκιμαστικές, που ξεκίνησαν εντός του χρονικού παραθύρου (since_last_version σημαίνει από την πιο πρόσφατη δημοσίευση) — και πόσες έχουν ακόμη ηχογράφηση βάσει της πολιτικής διατήρησης. Οι ηχογραφήσεις είναι ορατές μόνο σε owners και admins, οπότε για ένα μέλος recording_available_count είναι 0.

Η τιμή κάθε βάθους προέρχεται από τον ισχύοντα τιμοκατάλογο του λογαριασμού (review_standard_minor, review_ultra_minor), EUR σε ακέραιες υπομονάδες. unavailable_reason είναι null όταν το βάθος μπορεί να εκτελεστεί, διαφορετικά: no_conversations_in_scope· για ultra μόνο, recording_consent_refused (κάθε καλών στο χρονικό παράθυρο αρνήθηκε την ηχογράφηση) ή recordings_expired; insufficient_credit όταν η τρέχουσα διαθέσιμη πίστωση είναι κάτω από την τιμή. Δεν καταγράφεται ούτε δαπανάται τίποτα.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:write

Σταματήστε ένα ενεργό VoiceAgent να απαντά μέχρι να συνεχιστεί η λειτουργία του (έλεγχος πύλης πελατών

live → paused, με καταγραφή ελέγχου (voice_agent.paused). Από την επόμενη συνομιλία, ο καλών ακούει το μήνυμα του γλωσσικού πακέτου «δεν μπορούμε να δεχθούμε την κλήση σας αυτή τη στιγμή, δοκιμάστε αργότερα» και η συνομιλία λήγει ως voice_agent_paused — ποτέ σιωπή. Μια συνομιλία που ήδη εξελίσσεται ολοκληρώνεται. Μόνο ένα live VoiceAgent μπορεί να τεθεί σε παύση (409 voice_agent_not_pausable)· η παύση ενός ήδη σε παύση δεν αλλάζει τίποτα (changed: false).

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• agent:write

Δοκιμάστε ξανά ένα αποτυχημένο build, με τα ίδια ή με νέα έγγραφα (έλεγχος πύλης πελατών

Για VoiceAgent του οποίου η νεότερη έκδοση απέτυχε. documents: "reuse" κάνει ξανά build εκείνης της έκδοσης από τα ήδη μεταφορτωμένα έγγραφα και ξεκινά αμέσως (202). documents: "replace" ανοίγει νέα έκδοση με τις ίδιες απαντήσεις και χωρίς έγγραφα (201)· μεταφορτώστε τα με createAgentDocumentUpload / confirmAgentDocument, έπειτα startVoiceAgentBuild. Με καταγραφή ελέγχου (voice_agent.rebuild_requested). Απαιτεί Idempotency-Key.

409 rebuild_refused όταν η νεότερη έκδοση δεν απέτυχε (δημιουργείται, περιμένει έγγραφα ή έχει ολοκληρωθεί)· 409 voice_agent_archived για αρχειοθετημένο VoiceAgent· 422 build_no_document για «reuse» όταν η αποτυχημένη έκδοση δεν έχει έγγραφο και το πρότυπο απαιτεί ένα.

Δέχεται σώμα αιτήματος JSON.

• 201
• 202
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• agent:write

Αφήστε να απαντήσει ξανά ένα VoiceAgent που έθεσε σε παύση ο ιδιοκτήτης του (έλεγχος πύλης πελατών

paused → live, με καταγραφή ελέγχου (voice_agent.resumed). Ένα VoiceAgent που έθεσε σε παύση η WeTalk επανενεργοποιείται μόνο από τη WeTalk (409 voice_agent_paused_by_operator)· ένα που δεν βρίσκεται σε παύση είναι 409 voice_agent_not_paused· η επανενεργοποίηση ήδη ενεργού δεν αλλάζει τίποτα (changed: false).

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• agent:write
• βαρύ

Πληκτρολογήστε μία γραμμή ως καλών και λάβετε την απάντηση της ενεργής έκδοσης.

Μια δοκιμή κειμένου με τον βοηθό, στην οποία απαντά το agent_runtime από το prompt της έκδοσης μέσω της συστοιχίας μοντέλων — αυτό που θα άκουγε ένας καλών, ως κείμενο. Δωρεάν (AC-38): δεν ελέγχεται υπόλοιπο και δεν χρεώνεται τίποτα. turn είναι όσα παρήγαγε αυτό το αίτημα, με τη σειρά — η καταγεγραμμένη γραμμή, η απάντηση και μία system γραμμή όταν ο βοηθός θα εκτελούσε κάτι (μια δοκιμή κειμένου δεν εκτελεί τίποτα: δεν καταχωρίζεται παραγγελία) — όχι ολόκληρη η συνομιλία.

Η συνομιλία κειμένου είναι συνομιλία (medium = web_chat, is_test), οπότε εμφανίζεται στο Ιστορικό ως δοκιμή. Στείλτε ξανά το επιστρεφόμενο conversation_id για να τη συνεχίσετε· η συνομιλία παραμένει στην έκδοση που χρησιμοποιήθηκε στην πρώτη σειρά ομιλίας. Παραλείψτε το για νέα συνομιλία στην ενεργή έκδοση ή στείλτε agent_version_id για να ξεκινήσετε σε ολοκληρωμένη έκδοση που δεν έχει ακόμη δημοσιευτεί (μια επεξεργασία, έλεγχος πύλης πελατών #75): 422 agent_version_not_ready εκτός αν εκείνη η έκδοση είναι ready.

Ελέγχεται με αυτή τη σειρά: text (μη κενό, έως 2000 χαρακτήρες)· ο βοηθός (404 voice_agent_not_found)· η ενεργή έκδοσή του (422 agent_version_not_ready)· η γλώσσα (422 language_unavailable)· η συνομιλία κειμένου (404 conversation_not_found). Ένα μοντέλο σε ανάπαυση δίνει 503 model_pool_unavailable και ένα runtime που δεν απαντά δίνει 503 agent_runtime_unavailable — δηλώνεται πριν γραφτεί οτιδήποτε.

plan-015 TC2: μια έρευνα με δύο ομάδες ερωτήσεων χρειάζεται survey_arm (A = ομάδα 1, B = ομάδα 2) σε κάθε σειρά ομιλίας της συνομιλίας της· απορρίπτεται για μία ομάδα ή απουσία έρευνας (400 validation_failed, πεδίο survey_arm). opening: true σε νέα συνομιλία κειμένου βοηθό που κάνει κλήσεις απαντά τη σειρά ομιλίας 0 — τον χαιρετισμό του, πριν πληκτρολογήσει οτιδήποτε ο δοκιμαστής — αποθηκευμένο όπως κάθε γραμμή και δωρεάν.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 422
• 429
• 503

• agent:read

Πρόσφατη σηματοδοσία SIP για αυτό το VoiceAgent.

Οι εγγραφές που συνέθεσε η WeTalk αντί να παρατηρήσει περιέχουν synthesised: true, επειδή ορισμένοι πάροχοι δεν εκθέτουν REGISTER ή κωδικό απάντησης και ένα κατασκευασμένο στοιχείο που παρουσιάζεται ως παρατηρημένο είναι χειρότερο από ένα κενό.

• 200
• 401
• 403
• 429

• agent:read

Η διεύθυνση SIP δικής σας σύνδεσης για αυτό το VoiceAgent (παλαιότερη λειτουργία).

Παλαιότερη λειτουργία (P10). Το διαπιστευτήριο SIP ανά VoiceAgent της εποχής παρόχου. Παραμένει και απαντά όπως πριν, αλλά δεν είναι SIP trunk πελάτη και η πύλη δεν το εμφανίζει πλέον: συνδέστε το δικό σας trunk με /v1/sip-trunks.

Η διεύθυνση είναι στο domain του παρόχου, όχι της WeTalk, και το sip_address_owner το δηλώνει. Τα προσαρμοσμένα domains SIP της Telnyx υπάρχουν μόνο σε συνδέσεις IP, FQDN και Teams-auth, ενώ οι συνδέσεις διαπιστευτηρίων που απαιτούν τα ονόματα ανά VoiceAgent δεν μπορούν να διαθέτουν τέτοιο domain.

• 200
• 401
• 403
• 404
• 429

• agent:write

Ζητήστε νέο κωδικό πρόσβασης SIP για αυτό το VoiceAgent (παλαιότερη λειτουργία).

Παλαιότερη λειτουργία (P10). Αλλάζει το διαπιστευτήριο SIP ανά VoiceAgent της εποχής παρόχου· ο κωδικός πρόσβασης ενός trunk πελάτη αντικαθίσταται με PUT /v1/sip-trunks/{sip_trunk_id}/password.

Έγινε δεκτό, δεν εφαρμόστηκε. Το worker εκδίδει το νέο μυστικό στον πάροχο και το γράφει στον χώρο κλειδιών· μέχρι τότε, ο υπάρχων κωδικός πρόσβασης λειτουργεί. Το τμήμα χρήστη της διεύθυνσης SIP δεν αλλάζει, οπότε δεν χρειάζεται αλλαγή προορισμού.

• 202
• 401
• 403
• 404
• 429

• agent:read

Πώς εξελίσσεται μια δοκιμαστική φωνητική κλήση — τηλεφωνική ή περιηγητή.

Τηλεφωνική δοκιμή: μετά το createTestCall, η κονσόλα το διαβάζει με party_number και since μέχρι να φτάσει και να λήξει η κλήση του δοκιμαστή: state = idle όσο δεν έχει έρθει τίποτα από party_number από τη στιγμή since, έπειτα dialing, live και ended, με το id της συνομιλίας (για τη ζωντανή ροή απομαγνητοφώνησης) και, όταν λήξει, τα χρεωμένα δευτερόλεπτα και το ποσό.

Δοκιμή περιηγητή (plan-004, από 2026-09-26): μετά το createBrowserTestCall, διαβάστε το με conversation_id αντί αυτού. state = connecting μέχρι η εισδοχή να αναλάβει τη συνομιλία — πριν συνδεθεί ο περιηγητής (καμία εγγραφή ακόμη) και όσο έχει συνδεθεί αλλά δεν έχει απαντηθεί ακόμη — έπειτα live και ended, όπως σε τηλεφωνική δοκιμή. Ένα id που δεν ξεκίνησε αυτός ο χώρος εργασίας είναι 404.

Προσδιορίστε τη δοκιμή με έναν τρόπο: conversation_id, ή party_number και since — και τα δύο δίνουν 400.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:write
• βαρύ

Πραγματοποιήστε δοκιμαστική φωνητική κλήση στην ενεργή έκδοση του βοηθού.

agent_calls_me καλεί party_number από τον βοηθό· i_call_the_agent απαντά state = idle και θεωρεί την επόμενη εισερχόμενη συνομιλία από party_number, εντός 120 δευτερολέπτων, ως τη δοκιμή. Και στις δύο περιπτώσεις η συνομιλία εκτελείται στην ενεργή έκδοση μέσω των πραγματικών συνδέσεων, επισημαίνεται ως is_test, και χρεώνεται όπως κάθε άλλο λεπτό (AC-38).

Ελέγχεται με αυτή τη σειρά: το σώμα (party_number απαιτείται και στις δύο κατευθύνσεις — στην εισερχόμενη κλήση, έτσι αναγνωρίζεται η δοκιμή)· ο βοηθός (404 voice_agent_not_found)· η ενεργή έκδοσή του (422 agent_version_not_ready, με λόγια που δηλώνουν αν το build απέτυχε ή εκτελείται ακόμη)· η γλώσσα (422 language_unavailable).

Έπειτα, και στις δύο κατευθύνσεις: ο βοηθός πρέπει να απαντά κλήσεις (422 voice_agent_paused) και να διαθέτει αριθμό (422 tenant_resolution_failed, «δεν έχει ακόμη αριθμό τηλεφώνου» — τον αριθμό προς κλήση ή τον αριθμό προέλευσης)· για agent_calls_me, party_number δεν πρέπει να βρίσκεται στη λίστα μη κλήσης του λογαριασμού για όλους τους βοηθούς ή για αυτόν (422 contact_suppressed)· το τρέχον υπόλοιπο (402 trial_exhausted, credit_exhausted ή hard_stop_reached) και ο μηνιαίος προϋπολογισμός του χώρου εργασίας (402 budget_exceeded) πρέπει να πληρώνουν ένα δευτερόλεπτό της.

i_call_the_agent: το agent_runtime θέτει τον αριθμό του δοκιμαστή σε αναμονή δοκιμής — 503 model_pool_unavailable όταν το μοντέλο είναι σε ανάπαυση, 503 agent_runtime_unavailable όταν το runtime δεν απαντά — και η απάντηση είναι 201 με state = idle, dial_number (ο αριθμός προς κλήση), waiting_since και waiting_until.

agent_calls_me (από 2026-09-25): το agent_runtime καλεί party_number από τον αριθμό του ίδιου του βοηθού — dial_number στην απάντηση, ώστε η κονσόλα να αναφέρει ποιος αριθμός θα καλέσει. Απορρίπτεται πριν χτυπήσει οτιδήποτε με 503 model_pool_unavailable όταν το μοντέλο είναι σε ανάπαυση ή όταν κάθε ελεύθερη γραμμή κρατείται για εισερχόμενους καλούντες (τα εισερχόμενα προηγούνται των εξερχομένων), 503 agent_runtime_unavailable όταν το runtime δεν απαντά ή επανεκκινείται, 502 carrier_failed όταν ο πάροχος απορρίπτει την κλήση, 422 tenant_resolution_failed όταν ο αριθμός δεν φτάνει πλέον στον βοηθό. Η απάντηση είναι 201 με state = dialing, dial_number, waiting_since και waiting_until (όταν σταματά το κουδούνισμα). Ένα τηλέφωνο που δεν απαντάται ή είναι απασχολημένο ή απορρίπτει τερματίζει τη συνομιλία με end_reason no_answer ή busy, χωρίς χρέωση.

Διαβάστε την εξέλιξη της κλήσης με GET σε αυτή τη διαδρομή. Δεν γράφεται τίποτα εδώ: το runtime γράφει τη συνομιλία όταν ο πάροχος αναφέρει το σκέλος, με ένδειξη is_test, και χρεώνεται όπως κάθε άλλο λεπτό από τη στιγμή που απαντάται.

Αριθμός στο SIP trunk του ίδιου του λογαριασμού (plan-008, από 2026-09-30). Ο αριθμός του βοηθού είναι ο πρώτος ενεργοποιημένος αριθμός παρόχου του· όταν δεν έχει κανέναν, ο ενεργοποιημένος αριθμός trunk του (σύνδεση sip_trunk_number , πρώτα μία που επιτρέπεται ως caller ID). Ένας αριθμός παρόχου έχει προτεραιότητα όταν ο βοηθός διαθέτει και τα δύο. Ένας αριθμός trunk προσεγγίζεται μέσω του trunk, με τους ίδιους κανόνες όπως createSipTrunkTestCall:

- agent_calls_me καλεί party_number μέσω του trunk από τον αριθμό trunk (origin: test_call, ο προεπιλεγμένος χρόνος κουδουνίσματος του trunk). Πριν χτυπήσει οτιδήποτε: ένα κλειδί χρειάζεται επίσης conversation:dial (403 scope_insufficient)· τα όρια κλήσης ανά λεπτό που μοιράζονται με startOutboundConversation (10 ανά λογαριασμό, 3 ανά κλειδί: 429 rate_limited, με Retry-After)· το trunk δεν είναι απενεργοποιημένο (422 sip_trunk_disabled)· ο αριθμός επιτρέπεται ως caller ID (422 caller_id_not_bound)· οι κανόνες προορισμού (422 destination_refused)· η λίστα μη κλήσης (422 contact_suppressed)· το υπόλοιπο (402). Οι απορρίψεις του ίδιου του runtime: 429 daily_ceiling_reached, 422 sip_trunk_unverified, 503 all_lines_busy, 503 sip_edge_unavailable, 503 model_pool_unavailable, 503 agent_runtime_unavailable. Το runtime ανοίγει τη συνομιλία πριν απαντήσει, επομένως το 201 περιέχει το conversation_id με state = dialing, dial_number (τον αριθμό trunk), waiting_since και waiting_until; GET σε αυτή τη διαδρομή το διαβάζει όπως μια δοκιμαστική κλήση παρόχου και το endTestCall την τερματίζει μέσω του trunk. Ένα σκέλος που δεν μπόρεσε να φτάσει στο τηλέφωνο λήγει ως unreachable, χωρίς χρέωση. - i_call_the_agent απαιτεί η WeTalk να δέχεται κλήσεις μέσω trunks πελατών: όσο οι εισερχόμενες SIP της πλατφόρμας είναι κλειστές, είναι 422 sip_trunk_inbound_off («Οι κλήσεις προς … περνούν μέσω του δικού σας τηλεφωνικού συστήματος και η WeTalk δεν δέχεται ακόμη κλήσεις μέσω τηλεφωνικών συστημάτων.»), πριν διαβαστεί το υπόλοιπο. Όταν ενεργοποιηθεί, τίθεται σε αναμονή δοκιμής ο ίδιος ο αριθμός trunk (waiting_until είναι όταν λήγει η αναμονή δοκιμής), και ένα trunk μη έτοιμο για εισερχόμενα είναι 422 sip_trunk_inbound_off.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 402
• 403
• 404
• 422
• 429
• 503

• agent:write

Σταματήστε το «Το τηλέφωνό μου» να περιμένει την κλήση του δοκιμαστή (plan-015 TC1).

Ακυρώνει την αναμονή δοκιμής όταν κλείνει το πάνελ δοκιμών. Μια μεταγενέστερη κλήση από εκείνο το τηλέφωνο είναι κανονική συνομιλία, όχι δοκιμή. Idempotent: 204 είτε ο αριθμός βρισκόταν σε αναμονή δοκιμής είτε όχι. Ο αριθμός του δοκιμαστή βρίσκεται στο σώμα, ποτέ στο URL.

Δέχεται σώμα αιτήματος JSON.

• 204
• 400
• 401
• 403
• 404
• 429
• 503

• agent:write

Διατηρήστε το «Το τηλέφωνό μου» σε αναμονή της κλήσης του δοκιμαστή (plan-015 TC1).

Μετακινεί ξανά το τέλος ενός παραθύρου «Εγώ καλώ τον βοηθό» σε αναμονή κατά το παράθυρο αναμονής της πλατφόρμας (δέκα λεπτά), διατηρώντας την αρχή του: η απάντηση είναι waiting_since (αμετάβλητο) και το νέο waiting_until. Η κονσόλα Δοκιμών ανανεώνει στα μισά του παραθύρου όσο το πάνελ είναι ανοικτό. Αναμονή που έληξε ή χρησιμοποιήθηκε ήδη από κλήση δεν επαναφέρεται: 404 test_call_arm_not_found, και η κονσόλα θέτει εκ νέου αναμονή με createTestCall. Ο αριθμός του δοκιμαστή βρίσκεται στο σώμα, ποτέ στο URL. Δεν γίνεται κλήση ή χρέωση.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 429
• 503

• agent:read

Οι σουίτες δοκιμών για αυτό το VoiceAgent, με την πιο πρόσφατη εκτέλεση καθεμίας.

Επιτυχία και αποτυχία ανά περίπτωση, με το κείμενο αποτελέσματος και το απόσπασμα απομαγνητοφώνησης που δείχνει την αποτυχία. Μια αποτυχημένη περίπτωση δεν εμποδίζει τη δημοσίευση (AC-15) — δεν υπάρχει περιορισμός που συνδέει την ενεργή έκδοση με επιτυχή εκτέλεση — επομένως η εκτέλεση καταγράφει σε ποια agent_version_id έγινε και η αποτυχία παραμένει ανακτήσιμη για την έκδοση που δημοσιεύτηκε ούτως ή άλλως.

Η ανάγνωση μιας εκτέλεσης δεν την εκτελεί. Η πραγματοποίηση δοκιμαστικής συνομιλίας χρειάζεται το runtime και ανήκει στην κονσόλα Δοκιμών (P11-09)· αυτή η διαδρομή διαβάζει όσα έχουν ήδη εκτελεστεί.

• 200
• 401
• 403
• 404
• 429

• agent:read

Κάθε έκδοση αυτού του VoiceAgent, με τις νεότερες πρώτα.

Το ίδιο το έγγραφο διαμόρφωσης δεν περιλαμβάνεται στην προβολή της λίστας: περιέχει ολόκληρο τον εξαγμένο κατάλογο και η οθόνη εκδόσεων εμφανίζει ετικέτα, ημερομηνία, συντάκτη, σημείωση και λίστα αλλαγών. Διαβάστε μία έκδοση για να λάβετε το έγγραφό της.

• 200
• 400
• 401
• 403
• 429

• agent:read

Μία έκδοση, με το έγγραφο διαμόρφωσης στο οποίο μετατράπηκε κατά το build.

• 200
• 401
• 403
• 404
• 429

• agent:read

Τα έγγραφα πηγής από τα οποία δημιουργήθηκε αυτή η έκδοση.

Τα έγγραφα ορίζονται σταθερά ανά έκδοση, ώστε όσα χρησιμοποιεί μια ενεργή έκδοση για να απαντήσει να μπορούν πάντα να ληφθούν ακριβώς όπως μεταφορτώθηκαν.

• 200
• 401
• 403
• 404
• 429

• agent:write

Ορίστε αυτή την έκδοση ως εκείνη στην οποία καταλήγουν οι νέες συνομιλίες.

Ενημέρωση μίας εγγραφής. Οι συνομιλίες που ήδη εξελίσσονται κρατούν τη διαμόρφωση που επιλύθηκε κατά την εισδοχή και ολοκληρώνονται στην προηγούμενη έκδοση· η επόμενη νέα συνομιλία παίρνει αυτήν. expected_live_version_seq είναι η ακολουθία που διαβάσατε τελευταία — μια ασυμφωνία δίνει 409 αντί για σιωπηρή αντικατάσταση της απόφασης κάποιου άλλου.

Ένα ΠΡΟΣΧΕΔΙΟ (plan-015, ADR 0043) — έκδοση από απαντήσεις, διορθώσεις πληρωμένου ελέγχου ή επεξεργασία, που δεν δημοσιεύτηκε ποτέ — καταγράφει την έκδοση που ήταν ενεργή όταν δημιουργήθηκε. Αν δεν είναι πλέον η ενεργή έκδοση, η δημοσίευσή του θα αντικαθιστούσε όσα ενεργοποιήθηκαν έκτοτε, επομένως απαντά 409 draft_base_changed (με error.detail.base_agent_version_id, base_label, live_agent_version_id, live_label) εκτός αν το σώμα δηλώνει acknowledge_base_change: true. Ένα παλιό expected_live_version_seq ελέγχεται πρώτο.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• agent:write

Επιστρέψτε σε προηγούμενη έκδοση. Η ίδια λειτουργία με τη δημοσίευση.

Ίδιο με τη δημοσίευση, με id παλαιότερης έκδοσης και την ίδια εγγύηση για τις συνομιλίες που ήδη εξελίσσονται. Δεν υπάρχει ξεχωριστή διαδρομή επαναφοράς.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• agent:read

Ένα build όπως ισχύει τώρα — τα βήματα, η πρόοδος ή ο λόγος αποτυχίας του (έλεγχος πύλης πελατών

Αυτό που διαβάζει η οθόνη Δημιουργίας κατά τη φόρτωση και όταν η ροή της δηλώνει αλλαγή, ώστε μια επαναφόρτωση, δεύτερη καρτέλα ή σύνδεσμος που ανοίγει αργότερα να δείχνει την πραγματική κατάσταση. Η αποτυχία περιέχει την πρόταση για τον ιδιοκτήτη και το σφάλμα, ποτέ την τεχνική λεπτομέρεια του operator.

• 200
• 401
• 403
• 404
• 429

• agent:read

Τα συστήματα που μπορεί να καλέσει μία έκδοση ενός VoiceAgent, με τις λίστες επιτρεπόμενων λειτουργιών τους.

• 200
• 400
• 401
• 403
• 429

• agent:write

Καταχωρίστε ένα σύστημα που μπορεί να καλέσει το VoiceAgent και τις λειτουργίες που μπορεί να χρησιμοποιήσει.

Το μεταφορτωμένο έγγραφο OpenAPI 3 ή Swagger 2 αναλύεται εδώ και το operation_id πρέπει να αναφέρει λειτουργίες που δηλώνει εκείνο το έγγραφο. Η προκύπτουσα λίστα είναι η λίστα επιτρεπόμενων λειτουργιών: το runtime δεν μπορεί να καλέσει τίποτα άλλο και κάθε τέτοια απόπειρα αποκλείεται και γράφεται στο χρονολόγιο συμβάντων της ίδιας της συνομιλίας.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 429

• agent:read

Μία σύνδεση και η λίστα επιτρεπόμενων λειτουργιών της.

• 200
• 401
• 403
• 404
• 429

• agent:write
• βαρύ

Διαβάστε μια μεταφορτωμένη προδιαγραφή και απαριθμήστε τις λειτουργίες που προσφέρει.

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

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 429

• agent:write

Προετοιμάστε ένα μενού για προεπισκόπηση — ή επιστρέψτε την προεπισκόπηση του ίδιου αρχείου που έχει ήδη διαβαστεί.

Αναφέρει το πρότυπο, τη γλώσσα του μενού και το αρχείο (μέγεθος και SHA-256). Όταν αυτός ο χώρος εργασίας έχει ήδη προεπισκόπηση του ίδιου ακριβώς αρχείου για το ίδιο πρότυπο και γλώσσα — διαβασμένη ή υπό ανάγνωση — επιστρέφεται αμέσως (200, upload: null): η επισύναψη του ίδιου αρχείου ξανά δεν κοστίζει τίποτα και δεν το διαβάζει ξανά. Διαφορετικά (201) η προεπισκόπηση είναι uploading και upload είναι σύνδεσμος μικρής διάρκειας, μόνο για εγγραφή, στον οποίο ο περιηγητής στέλνει τα bytes με PUT και ακριβώς τις δοθείσες κεφαλίδες· έπειτα καλέστε confirmDocumentPreview.

Κάθε νέα προεπισκόπηση είναι ανάγνωση από το μοντέλο: έως το όριο της πλατφόρμας ανά άτομο ανά ώρα (429 rate_limited, με Retry-After). Προεπισκοπήσεις έχουν μόνο τα πρότυπα που διαβάζουν μενού (422 validation_failed στο agent_template_code). Μια προεπισκόπηση διατηρείται για το διάστημα διατήρησης της πλατφόρμας και έπειτα αφαιρείται.

Δέχεται σώμα αιτήματος JSON.

• 200
• 201
• 400
• 401
• 403
• 413
• 415
• 422
• 429

• agent:write

Μία προεπισκόπηση μενού — ελέγχετε περιοδικά όσο διαβάζεται.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:write

Ελέγξτε το μεταφορτωμένο μενού και ξεκινήστε την ανάγνωσή του.

Διαβάζει ξανά το αποθηκευμένο αρχείο και ελέγχει ότι μέγεθος, τύπος περιεχομένου και SHA-256 είναι τα δηλωμένα· μια ασυμφωνία το απορρίπτει (422 document_mismatch). Έπειτα, όταν έχει ήδη διαβαστεί προεπισκόπηση του ίδιου αρχείου, αυτή η μεταφόρτωση ενσωματώνεται σε εκείνη και επιστρέφεται η υπάρχουσα προεπισκόπηση· διαφορετικά η προεπισκόπηση είναι queued και η WeTalk διαβάζει το μενού στο παρασκήνιο. Ελέγχετε περιοδικά το readDocumentPreview μέχρι να είναι done ή failed. Η επιβεβαίωση προεπισκόπησης που δεν είναι πλέον uploading την επιστρέφει όπως είναι.

• 200
• 400
• 401
• 403
• 404
• 422
• 429

• agent:read

Συνομιλίες στα widgets ιστοτόπου του χώρου εργασίας, γραπτές ή φωνητικές.

Ο πίνακας συνομιλιών της σελίδας Μηνυμάτων (plan-004 WC-90, design §17.10.7): κάθε συνομιλία σε σύνδεση καναλιού web_chat_widget — web_chat και φωνή widget — με τον επισκέπτη (visitor_tag, ποτέ το κλειδί), την ετικέτα καναλιού, την τελευταία γραμμή που ειπώθηκε, το αποτέλεσμα και τον χρόνο. Η δοκιμαστική συνομιλία της ίδιας της κονσόλας δεν έχει σύνδεση και δεν εμφανίζεται.

Διαβάζεται σύμφωνα με την ορατότητα του αναγνώστη: party_address επιστρέφει null για Member και Viewer — conversation_visible το θέτει NULL στη βάση δεδομένων — και last_message είναι null για Viewer, του οποίου ο ρόλος δεν περιλαμβάνει όσα ειπώθηκαν (transcript_withheld).

• 200
• 401
• 403
• 429

• agent:read

Τα τέσσερα μέσα και αν καθένα μπορεί να μεταφέρει συνομιλία σήμερα.

• 200
• 401
• 403
• 429

• agent:read

Ένα μέσο πλήρως — συνδεδεμένο, σύντομα διαθέσιμο ή μη συνδεδεμένο.

Αποκωδικοποιεί βάσει του MessagingMediumDetail και για τα τέσσερα μέσα. Για web_chat περιέχει επίσης κάθε widget ιστοτόπου (widget, το καθένα με το απόσπασμα κώδικα, τις γραμμές CSP και την κατάστασή του) και install (το URL του script και την πρόταση χρέωσης)· για τα άλλα μέσα το widget είναι κενό και το install είναι null.

• 200
• 401
• 403
• 404
• 429

• agent:write

Συνδέστε ένα μέσο σε VoiceAgent.

Απορρίπτεται με 409 για μέσο σε λίστα αναμονής και για voice — αριθμός, trunk και εναλλασσόμενος κωδικός SIP ανήκουν στην περιοχή Αριθμοί και SIP, και η σύνδεση αριθμού σε δύο μέρη οδηγεί σε λάθος στο ένα. Η απόρριψη δηλώνει ποια από τις δύο περιπτώσεις ισχύει.

Για web_chat το σώμα χρειάζεται επίσης site_origin — τη διεύθυνση του ιστοτόπου όπου τοποθετείται η συνομιλία (https://host[:port]· απλό http μόνο για localhost) — που γίνεται η πρώτη επιτρεπόμενη προέλευση του widget. Ένας φωνητικός βοηθός που έχει ήδη widget λαμβάνει πίσω εκείνο το widget, επανενεργοποιημένο, με προσθήκη της διεύθυνσης (200)· διαφορετικά δημιουργείται νέο (201). Το κλειδί widget είναι το id της σύνδεσης: δημόσιο αναγνωριστικό επικολλημένο στη σελίδα του πελάτη, χωρίς scope ή μυστικό.

Δέχεται σώμα αιτήματος JSON.

• 200
• 201
• 400
• 401
• 403
• 404
• 409
• 429

• agent:write

Σταματήστε την απάντηση σε ένα μέσο, διατηρώντας το ιστορικό του.

Απενεργοποιεί τις συνδέσεις του χώρου εργασίας σε αυτό το μέσο. Δεν διαγράφεται τίποτα: οι συνομιλίες αναφέρονται στη σύνδεση και μια διαγραφή θα έπρεπε να επιλέξει μεταξύ παραβίασης του ξένου κλειδιού και αφαίρεσης των απομαγνητοφωνήσεων μαζί της. Κάθε widget ιστοτόπου που απενεργοποιείται καταγράφεται στο αρχείο ελέγχου.

• 200
• 401
• 403
• 404
• 429

• agent:write

Ενεργοποιήστε ή απενεργοποιήστε ένα widget ιστοτόπου και τη φωνή του.

{ enabled?, voice_enabled? } — τουλάχιστον ένα. Η ενεργοποίηση οποιουδήποτε χρειάζεται τουλάχιστον μία επιτρεπόμενη προέλευση (422 origin_list_empty). Η απενεργοποίηση της συνομιλίας σταματά αμέσως την απάντηση. Κάθε αλλαγή γράφει μία εγγραφή ελέγχου· ένα αίτημα χωρίς αλλαγές δεν γράφει καμία. Μόνο Owners και Admins.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 422
• 429

• agent:write

Αποσυνδέστε ένα widget ιστοτόπου, διατηρώντας το ιστορικό του.

Απενεργοποιεί το widget και τη φωνή του και διαγράφει τις επιτρεπόμενες προελεύσεις· η σελίδα έπειτα το εμφανίζει ως μη συνδεδεμένο. Δεν διαγράφεται τίποτα από το Ιστορικό και η επανασύνδεση του ίδιου φωνητικού βοηθού επαναφέρει το ίδιο κλειδί widget. Μόνο Owners και Admins.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:write

Αντικαταστήστε τους ιστοτόπους στους οποίους απαντά ένα widget ιστοτόπου.

{ allowed_origin: [...] } αντικαθιστά ολόκληρη τη λίστα. Κάθε τιμή κανονικοποιείται σε scheme://host[:port] (πεζά, με αφαίρεση της προεπιλεγμένης θύρας)· https μόνο, εκτός από http://localhost:<port>. Έως 20 μετά την αφαίρεση διπλοτύπων. Τιμή που δεν είναι διεύθυνση ιστοτόπου → 400 origin_invalid με αναφορά του allowed_origin[<i>]· κενή λίστα όσο η συνομιλία ή η φωνή της είναι ενεργή → 422 origin_list_empty. Ο έλεγχος προέλευσης εμποδίζει την ενσωμάτωση του widget σε άλλο ιστότοπο· δεν είναι έλεγχος ταυτότητας. Μόνο Owners και Admins.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 422
• 429

• agent:read

Κάθε αριθμός στον χώρο εργασίας, συνδεδεμένος ή όχι.

Η λίστα ανά VoiceAgent δεν μπορεί να εξυπηρετήσει αυτή την οθόνη: ένας αριθμός χωρίς σύνδεση δεν έχει VoiceAgent κάτω από το οποίο να εμφανιστεί και αυτή ακριβώς είναι η εγγραφή που ανοίγει ο πελάτης στους Αριθμούς και SIP για να διορθώσει. Οι αριθμοί του δικού σας SIP trunk εμφανίζονται δίπλα στους αριθμούς παρόχου, με provider: sip_trunk και το όνομα εμφάνισης του trunk. meta.sip_trunk_count μετρά τα SIP trunks πελατών του χώρου εργασίας (εξαιρούνται τα διαγραμμένα) — όχι τα παλαιότερα διαπιστευτήρια SIP ανά VoiceAgent.

Η επικεφαλίδα μετρά σκόπιμα αριθμούς και trunks και δεν ένα endpoint WebRTC: η υποδομή πολυμέσων περιηγητή παραμένει ανεπίλυτη (plan spike S8, risk R15), και η καταμέτρηση κάποιου στοιχείου που δεν μπορεί να μεταφέρει ήχο θα ήταν ισχυρισμός, όχι μέτρηση.

• 200
• 401
• 403
• 429

• agent:read

Η τελευταία συνομιλία ενός αριθμού, το πλήθος του τρέχοντος μήνα και οι πέντε πιο πρόσφατες συνομιλίες του.

Όσα εμφανίζει η οθόνη Αριθμοί και SIP όταν ανοίγει ένας αριθμός: «Τελευταία κλήση», «Αυτόν τον μήνα» και «Πρόσφατη δραστηριότητα». Μια συνομιλία μετρά όταν ήρθε — ή, για εξερχόμενο σκέλος μέσω SIP trunk, έφυγε — μέσω φωνητικής σύνδεσης αυτού του αριθμού όσο τον κατείχε ο χώρος εργασίας (μεταξύ των purchased_at και released_at), που είναι ακριβώς όσα GET /v1/conversations?phone_number_id= απαριθμεί («Δείτε όλες τις κλήσεις σε αυτόν τον αριθμό»).

Το «Αυτόν τον μήνα» ξεκινά από την πρώτη χρονική στιγμή του τρέχοντος μήνα στη ζώνη ώρας του χώρου εργασίας. Οι δοκιμαστικές συνομιλίες μετρούν: είναι συνομιλίες σε αυτόν τον αριθμό. Διαβάζεται βάσει της ορατότητας του καλούντος, επομένως Member και Viewer λαμβάνουν party_address ως null, όπως στο Ιστορικό.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:read

Αν η WeTalk μπορεί να εκδώσει αριθμό σήμερα.

Απαντά waitlisted. Σε ποιες χώρες η WeTalk εκδίδει αριθμούς και ποιος αναλαμβάνει τα κανονιστικά δικαιολογητικά είναι ανοικτή απόφαση προϊόντος: ένας ελληνικός αριθμός +30 χρειάζεται απόδειξη ταυτότητας από κράτος μέλος της ΕΕ και απαιτεί ημέρες, ένας αμερικανικός δεν χρειάζεται. Η λεπτομέρεια αναφέρει τις δύο υπάρχουσες διαδρομές: αίτημα αριθμού που εκπληρώνει η WeTalk και «Σύνδεση trunk» για αριθμούς που ήδη έχετε στον δικό σας πάροχο VoIP (/v1/sip-trunks).

• 200
• 401
• 403
• 429

• agent:read

Περιοχή και καθυστέρηση μετ’ επιστροφής, μετρημένες από τη WeTalk.

Κανένα API παρόχου δεν το αναφέρει. Ούτε η Telnyx ούτε η Twilio εκθέτει σε πελάτη μέτρηση καθυστέρησης ανά περιοχή, επομένως το στοιχείο σχεδιασμού us-west · 4 ms είναι μέτρηση της WeTalk ή διακόσμηση. Τα δείγματα προέρχονται από region_latency_sample, τον πίνακα πλατφόρμας που δημιούργησε για αυτά το design §4.7· όταν δεν έγινε καμία ανίχνευση εντός του παραθύρου, η απάντηση δηλώνει measured: false και δεν περιέχει τιμή. Έναν εύλογο αριθμό χωρίς τεκμηρίωση θα τον επικαλούνταν ο πελάτης στη διάρκεια περιστατικού.

• 200
• 401
• 403
• 429

• agent:read

Τα αιτήματα αριθμών αυτού του χώρου εργασίας, με τα νεότερα πρώτα και ένδειξη αν ικανοποιήθηκε καθένα.

state παράγεται κατά την ανάγνωση: connected μόλις ο ζητούμενος βοηθός έχει συνδεδεμένο αριθμό κατά ή μετά το αίτημα, pending μέχρι τότε.

• 200
• 401
• 403
• 429

• agent:write

Ζητήστε από τη WeTalk να ορίσει αριθμό τηλεφώνου για έναν από τους βοηθούς σας.

Προς το παρόν οι αριθμοί ορίζονται από τη WeTalk. Αυτό καταγράφει το αίτημα — τον βοηθό που πρέπει να απαντά, τη χώρα και όσα πρέπει να γνωρίζει η WeTalk (αριθμό που ήδη κατέχετε, το δικό σας τηλεφωνικό σύστημα) — ως εγγραφή στο αρχείο ελέγχου σας (voice_agent.number_requested)· το id της εγγραφής είναι του αιτήματος. Ένας operator το διαβάζει από το API προσωπικού και αναθέτει τον αριθμό· το αίτημα έπειτα εμφανίζεται ως state: connected.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 429

• agent:read

Ένας έλεγχος βελτιστοποίησης, με τα ευρήματα και τις αποφάσεις τους.

recording_available_count μετριέται ξανά στο χρονικό παράθυρο του ελέγχου όπως ίσχυε όταν ζητήθηκε, με τη σημερινή διατήρηση. next_agent_version_label είναι η ετικέτα που θα λάμβανε το προσχέδιο. queued ορίζεται όσο ο έλεγχος περιμένει το worker.

• 200
• 400
• 401
• 403
• 404
• 429

• agent:write

Αποδεχθείτε, απορρίψτε ή αναιρέστε την απόφαση για ένα εύρημα.

Τα ευρήματα αποφασίζονται ένα τη φορά και τίποτα δεν γίνεται δεκτό από προεπιλογή. Επιτρέπεται μόνο όσο ο έλεγχος είναι done και οι διορθώσεις του δεν βρίσκονται ακόμη σε προσχέδιο (409 optimisation_review_state_conflict διαφορετικά). Γράφει την εγγραφή ελέγχου optimisation_finding.decided.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• agent:write

Αποθηκεύστε τις αποδεκτές διορθώσεις ως προσχέδιο έκδοσης — compare-and-set στην ενεργή ακολουθία.

Δημιουργεί προσχέδιο· δεν δημοσιεύει τίποτα (plan-015 DRF, ADR 0043 — «Δημιουργία προσχεδίου vN με N διορθώσεις»). Εφαρμόζει την αλλαγή διαμόρφωσης κάθε αποδεκτού ευρήματος στο έγγραφο διαμόρφωσης της ενεργής έκδοσης (μια αλλαγή μπορεί να τροποποιήσει μόνο τον χαιρετισμό, τον εξαγμένο κατάλογο, τις ώρες λειτουργίας, την υπερχείλιση και τη συμπεριφορά εκτός ωραρίου — ποτέ μεταφορές, συνδέσεις, διατύπωση συγκατάθεσης, γλώσσες, φωνή ή ταυτόχρονη εξυπηρέτηση), επικυρώνει το αποτέλεσμα και το εισάγει ως ready έκδοση χωρίς published_at και base_agent_version_id = την ενεργή έκδοση, εφόσον το live_version_seq εξακολουθεί να ισούται με expected_live_version_seq. Ο έλεγχος αναφέρει από τότε το προσχέδιο.

Η ενεργή έκδοση δεν αλλάζει: δεν υπάρχει agent_version.published μήνυμα outbox, live_version_seq επιστρέφει όπως ήταν και κάθε συνομιλία συνεχίζει να φτάνει στην ενεργή έκδοση μέχρι κάποιος με δικαίωμα δημοσίευσης να δημοσιεύσει το προσχέδιο από τις Εκδόσεις (publishAgentVersion). Γράφει τις εγγραφές ελέγχου agent_version.draft_created και optimisation_review.published. Η χρέωση παραμένει αμετάβλητη: ο έλεγχος χρεώθηκε όταν ολοκληρώθηκε και η αποθήκευση των διορθώσεών του ως προσχέδιο δεν μετακινεί χρήματα.

Ένας έλεγχος του οποίου το προσχέδιο δεν δημοσιεύτηκε ποτέ και δεν βασίζεται πλέον στην ενεργή έκδοση (άλλη έκδοση ενεργοποιήθηκε στο μεταξύ) μπορεί να το εκτελέσει ξανά: οι ίδιες αποδεκτές διορθώσεις εφαρμόζονται στο τρέχον ενεργό έγγραφο και ο έλεγχος αναφέρει το νέο προσχέδιο («Αναδημιουργία στην τρέχουσα έκδοση»). Ένα προσχέδιο που εξακολουθεί να βασίζεται στην ενεργή έκδοση ή έχει ήδη δημοσιευτεί είναι 409 optimisation_review_state_conflict.

Ένα live_version_seq που μετακινήθηκε από τότε που το διαβάσατε είναι 409 live_version_seq_stale χωρίς να αποθηκευτεί τίποτα: επαναφορτώστε και αποφασίστε ξανά, ποτέ επανάληψη με τον ίδιο αριθμό.

Το operationId διατηρεί το προηγούμενο όνομά του ώστε να μη χαλάσουν οι παραγόμενοι clients.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• δεν χρειάζεται κλειδί

Ξεκινήστε φωνητική συνομιλία από widget ιστοτόπου.

Χωρίς έλεγχο ταυτότητας. Πραγματική συνομιλία με τον βοηθό του widget μέσω της υπηρεσίας μεταφοράς φωνής περιηγητή της WeTalk, με χρέωση στον ιδιοκτήτη του ιστοτόπου όπως κάθε άλλο λεπτό από τη στιγμή που απαντάται, για έως max_duration_second (10 λεπτά).

Ελέγχεται με αυτή τη σειρά· κάθε απόρριψη δεν γράφει τίποτα και δεν δημιουργεί δωμάτιο: το στοιχείο του αιτήματος Origin είναι το πλαίσιο φωνής της WeTalk (403 origin_not_allowed)· το σώμα (400 validation_failed)· η απόδειξη εργασίας — γνήσια, μη ληγμένη, λυμένη και χωρίς προηγούμενη υποβολή (400 proof_of_work_failed)· έως δέκα άδειες από μία διεύθυνση δικτύου ανά ώρα (429 rate_limited)· το widget υπάρχει, είναι ενεργό και έχει ενεργή φωνή — μία απάντηση και για τα τρία (404 widget_voice_disabled); embedding_origin είναι ένας από τους επιτρεπόμενους ιστοτόπους του widget (403 origin_not_allowed)· ο βοηθός μπορεί να δεχθεί τώρα τη συνομιλία (503 widget_voice_unavailable — μία απάντηση ανεξάρτητα από την αιτία, ώστε ο επισκέπτης να μην μαθαίνει ποτέ την κατάσταση χρέωσης του ιδιοκτήτη)· όλες οι γραμμές του βοηθού απασχολημένες (503 all_lines_busy).

Σύνδεση στη συνομιλία κειμένου. Όταν ο επισκέπτης ήδη συνομιλεί γραπτώς, το πλαίσιο στέλνει το στοιχείο μίας χρήσης της συνομιλίας join_proof· η φωνή τότε συνδέεται σε εκείνη τη συνομιλία αντί να ξεκινήσει νέα, μετά από κάθε παραπάνω έλεγχο. Το agent runtime ελέγχει την απόδειξη: μια που απορρίπτει (ληγμένη, ήδη χρησιμοποιημένη, άλλου widget ή άλλου επισκέπτη) είναι 503 widget_voice_unavailable όπως κάθε άλλος λόγος. Χωρίς απόδειξη, η άδεια συμπεριφέρεται ακριβώς όπως πριν.

Ο έλεγχος επιτρεπόμενων ιστοτόπων εμποδίζει την ενσωμάτωση widget σε άλλο ιστότοπο· δεν είναι έλεγχος ταυτότητας. Η απόδειξη εργασίας, το όριο ανά διεύθυνση και η ταυτόχρονη εξυπηρέτηση του ίδιου του βοηθού είναι τα όρια κατάχρησης.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 403
• 404
• 429
• 502
• 503

• δεν χρειάζεται κλειδί

Νέα πρόκληση απόδειξης εργασίας για το πλαίσιο φωνής του widget.

Χωρίς έλεγχο ταυτότητας. Πρόκληση ALTCHA — ο ίδιος αυτοφιλοξενούμενος έλεγχος, κλειδί και κόστος με τη δημόσια σελίδα εξαίρεσης (απόφαση προϊόντος A6) — υπογεγραμμένη από αυτό το API και έγκυρη για πέντε λεπτά. Το πλαίσιο φωνής τη λύνει και στέλνει τη λύση ως altcha σε createWidgetVoiceGrant· κάθε λυμένη πρόκληση γίνεται δεκτή μία φορά.

Μετριέται ανά διεύθυνση προέλευσης από τον δημόσιο περιοριστή του API, ώστε να μην μπορούν να συσσωρευτούν προκλήσεις. Δεν αποθηκεύεται ποτέ προσωρινά. Το στοιχείο σώματος data είναι η ίδια η μορφή πρόκλησης του ALTCHA (ονόματα πεδίων camelCase — ο επιλυτής διαβάζει ακριβώς αυτά).

• 200
• 429
• 502

• agent:read

Τα διαπιστευτήρια SIP του χώρου εργασίας, ένα ανά VoiceAgent (παλαιότερη λειτουργία).

Παλαιότερη λειτουργία (P10). Τα διαπιστευτήρια SIP ανά VoiceAgent της εποχής παρόχου. Η διαδρομή παραμένει και απαντά όπως πριν· η οθόνη Αριθμοί και SIP δεν τα εμφανίζει πλέον (η κάρτα trunk πελάτη, /v1/sip-trunks, αντικατέστησε την κάρτα διαπιστευτηρίων) και δεν μετρώνται στο listNumbers.meta.sip_trunk_count.

Ο κωδικός πρόσβασης δεν μεταφέρεται σε αυτή τη διεπαφή και δεν θα μεταφερθεί ποτέ: secret_ref είναι ΟΝΟΜΑ μυστικού στον χώρο κλειδιών. Η αλλαγή γίνεται με POST /v1/agents/{voice_agent_id}/sip/rotation, που γίνεται δεκτό και εφαρμόζεται από το worker.

• 200
• 401
• 403
• 429

• agent:write

Τερματίστε μια δοκιμαστική φωνητική κλήση.

Μπορεί να προσδιοριστεί μόνο δοκιμαστική φωνητική συνομιλία (is_test, medium = voice) του χώρου εργασίας του καλούντος· κάθε άλλο id — συμπεριλαμβανομένης πραγματικής συνομιλίας πελάτη — είναι 404 conversation_not_found. Μια δοκιμαστική κλήση που έχει ήδη λήξει επιστρέφει τα αποθηκευμένα στοιχεία της (state = ended), επομένως ο διπλός τερματισμός είναι ακίνδυνος. Μια ανοικτή τερματίζεται από το agent_runtime, που κατέχει το σκέλος παρόχου· η απάντηση είναι η κλήση όπως αποθηκεύεται εκείνη τη στιγμή (συνήθως ακόμη live — ο τερματισμός του παρόχου κλείνει την εγγραφή λίγο αργότερα), οπότε διαβάστε την ξανά με readTestCall. Το API δεν σημειώνει ποτέ ως ληγμένη κλήση που δεν τερμάτισε: όταν το runtime δεν εξυπηρετεί πλέον την κλήση ή δεν απαντά, είναι 503 agent_runtime_unavailable και η εγγραφή παραμένει ως έχει. billed_amount είναι η αξία των χρεωμένων δευτερολέπτων στην τιμή του λογαριασμού· charged_amount είναι όσα χρεώνει η τιμολόγηση αφού η δωρεάν δοκιμή καλύψει όσα καλύπτει (review #233)· το τιμολόγιο είναι το κλείσιμο ημέρας (design §7.9).

Μια δοκιμή περιηγητή (plan-004, από 2026-09-26) τερματίζεται μέσω του σκέλους WebRTC του agent_runtime, όχι παρόχου: ανοικτή συνομιλία στη σύνδεση περιηγητή του βοηθού ή — στα δευτερόλεπτα πριν το runtime ανοίξει την εγγραφή του — δοκιμή που ξεκίνησε ο καλών μόλις πριν (state = ended, end_reason = caller_hangup, χωρίς χρέωση). Μια δοκιμή περιηγητή που μόλις ξεκίνησε άλλο μέλος είναι 404, όπως ένα άγνωστο id.

Μια δοκιμαστική κλήση σε αριθμό trunk (plan-008, από 2026-09-30) τερματίζεται μέσω της διαδρομής τερματισμού του ίδιου του trunk, όπως την endSipTrunkTestCall τερματίζει. Μια κλήση που πραγματοποίησε ο δοκιμαστής προς αριθμό trunk δεν έχει διαδρομή τερματισμού: 422 validation_failed — κλείστε το τηλέφωνο.

• 200
• 400
• 401
• 403
• 404
• 422
• 429
• 503

• agent:read

Τι μπορεί να δοκιμαστεί τώρα και γιατί όχι.

Διαβάζεται όταν ανοίγει η κονσόλα Δοκιμών ή μια καρτέλα Δοκιμής, ώστε μια δοκιμή που δεν μπορεί να εκτελεστεί να δηλώνεται πριν κάποιος πληκτρολογήσει ή πατήσει κουμπί. model_running είναι false εκτός των προγραμματισμένων παραθύρων της συστοιχίας μοντέλων· direction_available απαριθμεί τις κατευθύνσεις φωνητικών δοκιμών που μπορούν να πραγματοποιηθούν (μόνο εισερχόμενες: η πλατφόρμα δεν κάνει ακόμη εξερχόμενες κλήσεις)· message αναφέρει γιατί κάτι δεν μπορεί να εκτελεστεί, με λόγια για ένα άτομο. country_calling_code είναι του ίδιου του λογαριασμού (+30), για το παράδειγμα του πεδίου τηλεφώνου. browser_test_call_available (plan-004) αναφέρει αν μπορεί να ξεκινήσει δοκιμή περιηγητή — το runtime απάντησε, το μοντέλο εκτελείται και η υπηρεσία μεταφοράς φωνής περιηγητή της WeTalk είναι προσβάσιμη — με browser_test_call_message να αναφέρει γιατί όχι.

• 200
• 401
• 403
• 429

• agent:write

Οι κοινόχρηστες διαμορφώσεις βοηθών από τις οποίες μπορεί αυτός ο χώρος εργασίας να ξεκινήσει νέο βοηθό.

plan-014 (παράδοση B5): κάθε διαμόρφωση βοηθού που κοινοποίησε άλλος χώρος εργασίας του οργανισμού, την οποία αυτός ο χώρος αποδέχθηκε και δεν έχει ακόμη αντιγράψει, όσο η κοινοποίηση ισχύει και οι δύο χώροι εργασίας είναι ενεργοί — ακριβώς όσα το createVoiceAgent δέχεται ως resource_share_id. Καθεμία περιέχει το είδος βοηθού, τις γλώσσες, τη φωνή, τον χαιρετισμό, τον διακόπτη ηχογράφησης και την ταυτόχρονη εξυπηρέτηση της σταθερά ορισμένης έκδοσης, από τα οποία ξεκινά ο οδηγός. Κλήσεις, ηχογραφήσεις, αριθμοί και έγγραφα δεν μεταφέρονται ποτέ μαζί με διαμόρφωση. Owner ή Admin, όπως στη δημιουργία βοηθού.

• 200
• 401
• 403
• 429

• conversation:read

Συνομιλίες, με τις νεότερες πρώτα και τα στοιχεία ολόκληρου του φιλτραρισμένου συνόλου.

Η λίστα της καρτέλας Ιστορικό. Κάθε φίλτρο είναι παράμετρος ερωτήματος ώστε μια φιλτραρισμένη προβολή να είναι σύνδεσμος που μπορεί να επικολληθεί σε μήνυμα.

figure περιγράφει το ολόκληρο φιλτραρισμένο σύνολο, όχι τη σελίδα: το πλήθος συνομιλιών και ο χρόνος ομιλίας δεν πρέπει να αλλάζουν όσο κάποιος κάνει κύλιση. Η σελιδοποίηση γίνεται με cursor, ποτέ offset — διαφορετικά μια συνομιλία που λήγει στη μέση της σελίδας θα προκαλούσε διπλή εγγραφή ή παράλειψη.

billed_amount είναι ενδεικτικό. Το Design §7.9 τιμολογεί μια ημέρα στο κλείσιμο, ανά (voice_agent, day, medium, is_test) ομαδοποίηση, ώστε εκατοντάδες στρογγυλοποιήσεις ανά συνομιλία να μη συσσωρεύονται σε υπόλοιπο που δεν συμφωνεί· η τιμή εδώ είναι η αξία των δευτερολέπτων μίας συνομιλίας στην τιμή του λογαριασμού και το τιμολόγιο είναι το κλείσιμο ημέρας.

• 200
• 400
• 401
• 403
• 429

• conversation:read

Μία συνομιλία με την απομαγνητοφώνηση, το χρονολόγιο συμβάντων και την αναφορά ηχογράφησής της.

Οι τέσσερις ενότητες που εμφανίζει το πάνελ λεπτομερειών Ιστορικού, δηλαδή οι τέσσερις ερωτήσεις πελάτη για ολοκληρωμένη συνομιλία: πώς ακουγόταν (recording), τι συνέβη σε μία πρόταση (transcript.summary), τι ειπώθηκε (turn) και τι έκανε η πλατφόρμα (event).

recording είναι μία αναφορά, όχι URL αναπαραγωγής. Το Design §8.8 καθιστά την αναπαραγωγή ηχογράφησης πράξη που καταγράφεται για έλεγχο — POST /v1/conversations/{id}/recording/access γράφει την εγγραφή ελέγχου και μόνο έπειτα εκδίδει URL μικρής διάρκειας — επομένως η παροχή ενός εδώ, σε διαδρομή που απαιτεί μόνο conversation:read, θα ήταν το κενό που κλείνει ο σχεδιασμός.

recording είναι null σε τρεις περιπτώσεις που ο αναγνώστης σκόπιμα δεν μπορεί να διακρίνει: δεν υπάρχει ηχογράφηση, η διατήρηση την έχει ήδη διαγράψει ή ο αναγνώστης είναι Member ή Viewer και η βάση δεδομένων δεν επέστρεψε εγγραφή.

sip_leg (plan-008) υπάρχει μόνο για συνομιλία μέσω του δικού σας SIP trunk: το trunk, το codec που διαπραγματεύτηκε και αν ήταν HD, η μεταφορά και η κρυπτογράφηση πολυμέσων όπως παρατηρήθηκαν και η προέλευση και αναφορά μιας εξερχόμενης συνομιλίας.

• 200
• 401
• 403
• 404
• 429

• recording:read

Γράψτε την εγγραφή ελέγχου και έπειτα επιστρέψτε URL μικρής διάρκειας για μία ηχογράφηση.

Απαιτεί το recording:read scope σε κλειδί και ρόλο Owner ή Admin σε συνεδρία — το δεύτερο επιβάλλεται από τη βάση δεδομένων, όχι από αυτό το endpoint.

Κάθε κλήση καταγράφεται για έλεγχο. Μια audit_entry με action_code = "recording.played" οριστικοποιείται πριν δημιουργηθεί το URL, στον λογαριασμό που κατέχει τη συνομιλία. Όταν operator της WeTalk αναπαράγει ηχογράφηση — ακόμη και όταν ενεργεί ως ένα από τα άτομά σας — η εγγραφή αναφέρει εκείνον τον operator, ώστε το δικό σας αρχείο ελέγχου να δείχνει ποιος άκουσε.

Ένας λογαριασμός μπορεί να απενεργοποιήσει πλήρως την πρόσβαση operators σε ηχογραφήσεις· όσο είναι κλειστή, ένας operator λαμβάνει recording_operator_access_disabled και δεν εκδίδεται URL.

Το URL λήγει. Είναι υπογεγραμμένο για ακριβώς ένα αντικείμενο, μόνο για ανάγνωση, μέσω HTTPS, και δεν είναι μόνιμη διεύθυνση: ζητήστε νέο αντί να το αποθηκεύσετε.

• 200
• 400
• 401
• 403
• 404
• 429

• conversation:read

Οι συνομιλίες ενός VoiceAgent σε εξέλιξη και τα σημερινά στοιχεία δίπλα τους.

Μια ενεργή συνομιλία είναι εκείνη με ended_at IS NULL (γλωσσάρι C11). voice_agent_id απαιτείται: το όριο μονάδων καναλιού, η ετικέτα αποτελέσματος και ο μετρητής είναι ιδιότητες ενός VoiceAgent, και απάντηση χωρίς αυτό θα απαντούσε άλλη ερώτηση.

Το «Σήμερα» είναι η χώρου εργασίας ημέρα στη ζώνη ώρας του ίδιου του χώρου εργασίας, επειδή μια ημέρα χρήσης είναι η ημέρα του πελάτη, όχι του διακομιστή.

last_event_kind είναι το πιο πρόσφατο conversation_event σε εκείνη τη συνομιλία, δηλαδή μέχρι πού έχει προχωρήσει. Είναι null μέχρι να φτάσει το πρώτο συμβάν.

Κάθε συνομιλία περιέχει επίσης media_codec, media_sample_rate_hz και latency_ms (καθένα nullable): τη μορφή πολυμέσων του σκέλους που παρατηρήθηκε, γραμμένη μία φορά όταν απαντήθηκε, και την καθυστέρησή του έως τώρα. Το null σημαίνει ότι δεν αναφέρθηκε ή δεν μετρήθηκε ακόμη — ποτέ εκτίμηση.

• 200
• 400
• 401
• 403
• 404
• 429

• conversation:read

Κάθε συνομιλία σε εξέλιξη, σε κάθε VoiceAgent που μπορεί να δει ο αναγνώστης.

Η σελίδα Ζωντανής δραστηριότητας όλου του λογαριασμού (2026-09-29). Μια ενεργή συνομιλία είναι εκείνη με ended_at IS NULL (γλωσσάρι C11). Σε αντίθεση με listLiveConversations, δεν λαμβάνεται voice_agent_id : η απάντηση αφορά κάθε VoiceAgent, με την παλαιότερη συνομιλία πρώτη και κάθε εγγραφή να αναφέρει το VoiceAgent και τον χώρο εργασίας της ώστε η σελίδα να συνδέεται στη δική του καρτέλα Ζωντανά.

Η ορατότητα είναι του Ιστορικού: ένα άτομο διαβάζει τους χώρους εργασίας στους οποίους ανήκει και Member ή Viewer λαμβάνει κάθε εγγραφή με party_address null.

• 200
• 401
• 403
• 429

• μόνο συνδεδεμένο άτομο

Τα κλειδιά του οργανισμού (scope λογαριασμού).

Τα κλειδιά οργανισμού — billing:read, usage:read, document:read — με τα νεότερα πρώτα, συμπεριλαμβανομένων των ανακληθέντων. Χρειάζεται account.api_key.manage (Owner, Admin οργανισμού): 403 capability_missing διαφορετικά. Το id άλλου οργανισμού είναι 404 not_found.

• 200
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Εκδώστε κλειδί οργανισμού. Εμφανίζεται ακριβώς μία φορά.

Ένα κλειδί οργανισμού διαβάζει τα οικονομικά του οργανισμού — υπόλοιπα και προσφορές (billing:read), αποδιδόμενη χρήση (usage:read), οικονομικά έγγραφα (document:read) — και τίποτα άλλο: κανένα περιεχόμενο χώρου εργασίας, καμία ιδιότητα μέλους, καμία αλλαγή οποιουδήποτε είδους. Χρειάζεται account.api_key.manage (Owner, Admin οργανισμού)· κάθε scope πρέπει να είναι ένα που διαθέτει ο καλών (403 scope_insufficient). Διαφορετικά όπως POST /v1/workspaces/{workspace_id}/api-keys; api_key.created καταγράφεται για έλεγχο στην ίδια συναλλαγή.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Τα κλειδιά του χώρου εργασίας που έχει ανοικτό η κονσόλα (διατηρείται για μία κυκλοφορία).

GET /v1/workspaces/{workspace_id}/api-keys για τον ίδιο τον χώρο εργασίας του auth_session. Χρησιμοποιήστε εκείνη τη διαδρομή.

• 200
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Εκδώστε κλειδί στον χώρο εργασίας που έχει ανοικτό η κονσόλα (διατηρείται για μία κυκλοφορία).

POST /v1/workspaces/{workspace_id}/api-keys για τον ίδιο τον χώρο εργασίας του auth_session, με το ίδιο σώμα και τους ίδιους κανόνες (expires_at απαιτείται). Χρησιμοποιήστε εκείνη τη διαδρομή.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Ανακαλέστε ένα κλειδί.

revoked_at ορίζεται· η εγγραφή παραμένει. Αυτό απαντά «ποιο κλειδί έκανε αυτή την κλήση» για κάθε εγγραφή ελέγχου που το αναφέρει ήδη. Το κλειδί σταματά να λειτουργεί στο επόμενο αίτημα και μια εργασία που ενεργεί για αυτό το ελέγχει ξανά πριν ενεργήσει. Γράφει μία api_key.revoked εγγραφή ελέγχου.

Χρειάζεται api_key.manage στον χώρο εργασίας του κλειδιού (ή api_key.integration_manage για κλειδί μόνο με scopes ενσωμάτωσης)· ένα κλειδί οργανισμού ή κλειδί ενσωμάτωσης οργανισμού υπακούει επίσης στο account.api_key.manage. Ένα κλειδί που λείπει, έχει ήδη ανακληθεί ή ανήκει σε άλλον οργανισμό είναι 404 not_found.

• 204
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Αλλάξτε ένα κλειδί — νέα τιμή, το παλιό ανακαλείται. Εμφανίζεται ακριβώς μία φορά.

Εκδίδει νέο κλειδί με το ίδιο όνομα, scopes, ιδιοκτήτη, δίκτυα και όριο αιτημάτων και ανακαλεί το παλιό στην ίδια συναλλαγή βάσης δεδομένων (ανακαλείται, ποτέ δεν επαναφέρεται — revoked_reason δηλώνει ότι αντικαταστάθηκε). Το νέο κλειδί αναφέρει το παλιό στο rotated_from_api_key_id. expires_at ζητείται ξανά: κατά την αλλαγή ορίζεται η επόμενη ημερομηνία λήξης. Χρειάζεται ό,τι απαιτεί η έκδοση εκείνου του κλειδιού· ο καλών πρέπει να διαθέτει ακόμη κάθε scope του (403 scope_insufficient). Ένα ανακληθέν κλειδί είναι 409 conflict. Γράφει api_key.rotated.

ΤΡΟΠΟΠΟΙΗΣΗ 2026-10-06 (security review M-8): ένα κλειδί που ανήκει σε άτομο αλλάζει μόνο από τον ιδιοκτήτη του — οποιοσδήποτε άλλος μπορεί να το διαχειριστεί απορρίπτεται με 403 permission_denied (ανακαλέστε το αντί γι’ αυτό και δημιουργήστε δικό σας κλειδί)· ένα κλειδί ενσωμάτωσης αλλάζει από όποιον μπορεί να διαχειρίζεται εκεί κλειδιά ενσωμάτωσης.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 429

• agent:read

Τα endpoints webhook που έχουν διαμορφωθεί σε αυτόν τον λογαριασμό.

• 200
• 400
• 401
• 403
• 429

• agent:write

Καταχωρίστε προορισμό για εξερχόμενα συμβάντα.

Η παράδοση γίνεται τουλάχιστον μία φορά από το transactional outbox, με επαναλήψεις και εκθετική καθυστέρηση για επτά ημέρες, και κάθε προσπάθεια καταγράφεται. Ο παραλήπτης πρέπει να είναι idempotent βάσει του id συμβάντος.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 409
• 429

• agent:read

Το αρχείο παραδόσεων ανά προσπάθεια για ένα endpoint.

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

• 200
• 400
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Τα κλειδιά που εκδόθηκαν για έναν χώρο εργασίας.

Με τα νεότερα πρώτα, συμπεριλαμβανομένων των ανακληθέντων. Χρειάζεται api_key.manage (Owner, Admin) ή api_key.integration_manage (επίσης Developer) σε εκείνον τον χώρο εργασίας: 403 capability_missing σε μέλος που δεν διαθέτει κανένα· χώρος εργασίας στον οποίο ο καλών δεν έχει ρόλο ή που ανήκει σε άλλον οργανισμό είναι 404 not_found.

Καμία εγγραφή δεν περιέχει το κλειδί. Αποθηκεύεται μόνο η σύνοψή του, οπότε δεν υπάρχει τίποτα να επιστραφεί.

• 200
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Εκδώστε κλειδί χώρου εργασίας. Εμφανίζεται ακριβώς μία φορά.

key υπάρχει σε αυτή την απάντηση και πουθενά αλλού, ποτέ.

Κανένα κλειδί δεν υπερβαίνει τον εκδότη του. Κάθε scope πρέπει να είναι ένα που διαθέτει ο καλών σε αυτόν τον χώρο εργασίας αυτή τη στιγμή: 403 scope_insufficient αναφέρει όσα δεν διαθέτει. Ένα κλειδί που ανήκει σε άτομο (owner_kind: person, η προεπιλογή) περιορίζεται ξανά σε κάθε χρήση από τον ΤΡΕΧΟΝΤΑ ρόλο του ιδιοκτήτη του και σταματά να λειτουργεί όταν ο ιδιοκτήτης φύγει από τον χώρο εργασίας. owner_kind: account_integration εκδίδει κλειδί ενσωμάτωσης οργανισμού, περιορισμένο μόνο από τα scopes του· χρειάζεται account.api_key.manage (Owner, Admin οργανισμού) καθώς και api_key.manage εδώ.

Χρειάζεται api_key.manage (Owner, Admin), ή api_key.integration_manage (επίσης Developer) όταν κάθε scope είναι agent:read, agent:write ή conversation:read. expires_at απαιτείται και πρέπει να είναι στο μέλλον. allowed_network (προαιρετικό) απαριθμεί τις διευθύνσεις ή τα εύρη από τα οποία μπορεί να χρησιμοποιηθεί το κλειδί· η διεύθυνση που ελέγχεται είναι εκείνη που είδε η είσοδος της WeTalk, ποτέ κεφαλίδα που έγραψε ο καλών. rate_class μπορεί να είναι μόνο standard (η υποστήριξη WeTalk αυξάνει ένα κλειδί σε elevated). name είναι έως 60 χαρακτήρες και κανένα άλλο ενεργό κλειδί στον χώρο εργασίας δεν μπορεί να το έχει ήδη (σύγκριση χωρίς διάκριση πεζών και κεφαλαίων): 409 conflict.

Το κλειδί και ένα api_key.created η καταχώριση ελέγχου (όνομα, πεδία πρόσβασης και ρυθμίσεις — ποτέ το κλειδί) γράφονται σε μία συναλλαγή βάσης δεδομένων.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 429

• οποιοδήποτε κλειδί

Η σύμβαση μεταπληρωμής ενός υπολοίπου, η οφειλή του και το διαθέσιμο ποσό.

Το πιστωτικό όριο που ενέκρινε το WeTalk, η τρέχουσα οφειλή (χρεωμένη σε ανεξόφλητα μηνιαία τιμολόγια μαζί με τη χρήση που δεν τιμολογήθηκε ακόμη, συμπεριλαμβανομένων ανοικτών συνομιλιών — χωρίς διπλή προσμέτρηση), το διαθέσιμο ποσό (το τρέχον υπόλοιπο μαζί με το πιστωτικό όριο και την υπέρβαση· νέες πληρωμένες συνομιλίες σταματούν στο μηδέν), οι όροι (εξόφληση τιμολογίου 14 ημέρες μετά το τέλος του μήνα, με κάρτα ή τραπεζική μεταφορά), το πρόγραμμα «αν αποτύχει πληρωμή» (ημερομηνία λήξης, +7, +14), κάθε ανεξόφλητο τιμολόγιο με τα βήματα είσπραξης, το τελευταίο εξοφλημένο τιμολόγιο και η κατάσταση είσπραξης. Ένα προπληρωμένο υπόλοιπο απαντά contract: null. Η ανάγνωση δεν προχωρά καμία διαδικασία. Απαιτείται account.finance.read στο υπόλοιπο.

• 200
• 401
• 403
• 404
• 429

• οποιοδήποτε κλειδί

Πληρώστε ανεξόφλητο τιμολόγιο μεταπληρωμής με κάρτα — ανοίξτε τη σελίδα πληρωμής του παρόχου.

Ξεκινά μια statement_payment πράξη χρέωσης για το μικτό ποσό του τιμολογίου (παγωμένο στο κλείσιμο του μήνα) και επιστρέφει τη φιλοξενούμενη σελίδα πληρωμής για παραπομπή του ατόμου (next_action), ή επιστρέφει τη σελίδα όπου ήδη περιμένει ανοικτή πληρωμή του ίδιου τιμολογίου. Ποτέ δεύτερη προσπάθεια (409 payment_pending)· ένα ήδη εξοφλημένο τιμολόγιο ή χωρίς οφειλή είναι 409 operation_state_conflict· μια σύμβαση που πληρώνεται μόνο με τραπεζική μεταφορά είναι 409 conflict. Το αποτέλεσμα έρχεται από τον πάροχο· αυτή η απάντηση δεν αναφέρει αποτέλεσμα. Απαιτείται account.finance.manage.

• 202
• 400
• 401
• 403
• 404
• 409
• 429

• οποιοδήποτε κλειδί

Ζητήστε επιστροφή αχρησιμοποίητης αγορασμένης πίστωσης· αποφασίζει χειριστής οικονομικών.

Μια πρόχειρη πράξη επιστροφής που περιμένει χειριστή με οικονομικά δικαιώματα (απόφαση ιδιοκτήτη OD-13). Με έγκριση, η πίστωση επιστρέφει στις αρχικές κάρτες, από την πιο πρόσφατη αγορά, και το υπόλοιπο με τραπεζική μεταφορά. Μόνο ένα αίτημα μπορεί να εκκρεμεί ανά υπόλοιπο (409 operation_conflict)· ποσό μεγαλύτερο από το επιστρέψιμο είναι 422 refund_not_refundable.

• 200
• 202
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• οποιοδήποτε κλειδί

Αχρησιμοποίητη αγορασμένη πίστωση σε υπόλοιπο.

• 200
• 401
• 403
• 404
• 429

• οποιοδήποτε κλειδί

Πληρωμή τώρα — άνοιγμα (ή εκ νέου άνοιγμα) της σελίδας πληρωμής του παρόχου.

Επιβεβαιώνει αυτόματη ανανέωση πίστωσης που περιμένει κλικ (τρόπος είσπραξης hosted_notification) ή επιστρέφει τη σελίδα όπου ήδη περιμένει μια πράξη. Ποτέ δεύτερη προσπάθεια για πράξη που έχει ήδη μία (409 payment_pending).

• 200
• 401
• 403
• 404
• 409
• 429

• οποιοδήποτε κλειδί

Τι περιμένει μια πράξη χρέωσης και πώς συνεχίζεται.

Διαβάζει, χωρίς να προχωρά: το διαβάζει η σελίδα επιστροφής από τον πάροχο. Κατονομάζονται οι καταστάσεις «αναμονή τράπεζας» (διερεύνηση άγνωστου αποτελέσματος) και «πληρώθηκε, δεν εφαρμόστηκε» (συνεχίζεται ακριβώς μία φορά).

• 200
• 401
• 403
• 404
• 429

• credit:spend

Ο κανόνας αυτόματης ανανέωσης πίστωσης.

Λογαριασμός χωρίς πολιτική δεν είναι 404 — configured: false είναι πραγματική κατάσταση και η οθόνη εμφανίζει τον διακόπτη κλειστό.

• 200
• 401
• 403
• 429

• credit:spend

Ορίστε τον κανόνα αυτόματης ανανέωσης πίστωσης.

Μια αλλαγή υπάρχουσας πολιτικής κατονομάζει την αναθεώρηση που διάβασε στο If-Match (400 validation_failed χωρίς αυτό) και απορρίπτεται με 409 revision_stale όταν η πολιτική άλλαξε έκτοτε — δύο αποθηκεύσεις από μία αναθεώρηση δεν μπορούν να επιτύχουν και οι δύο (plan-014 review I-9, 2026-10-06). Η πρώτη αποθήκευση δεν χρειάζεται αναθεώρηση· αν προηγήθηκε άλλη πρώτη αποθήκευση, απορρίπτεται με 409 revision_stale επίσης. Μία πολιτική ανά υπόλοιπο (migration 0114).

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 409
• 429

• credit:spend

Το υπόλοιπο και τι πραγματικά απομένει για δαπάνη.

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

• 200
• 401
• 403
• 404
• 429

• credit:spend

Οι έλεγχοι δαπανών του χώρου εργασίας.

Ο μηνιαίος προϋπολογισμός, το ποσοστό που στέλνει προειδοποίηση και η υποχρεωτική διακοπή. Χώρος εργασίας χωρίς ρύθμιση απαντά configured: false με προϋπολογισμό null αντί για 404: «δεν ορίστηκε προϋπολογισμός» είναι κατάσταση που εμφανίζει η οθόνη, όχι ανύπαρκτος πόρος.

• 200
• 401
• 403
• 429

• credit:spend

Ορίστε μηνιαίο προϋπολογισμό, ποσοστό ειδοποίησης και υποχρεωτική διακοπή.

Η υποχρεωτική διακοπή είναι εντολή, όχι ετυμηγορία. Η εγγραφή καταγράφει ότι οι βοηθοί πρέπει να σταματούν να απαντούν αντί να υπερβαίνουν τη δαπάνη· αν αυτό συνέβη αποφασίζεται σε κάθε αποδοχή από billingRefusalOf με βάση το τρέχον υπόλοιπο του design §7.9 — το εκκαθαρισμένο υπόλοιπο μείον τα σημερινά μη κοστολογημένα δευτερόλεπτα μείον ό,τι μπορεί να κοστίσουν ακόμη οι συνομιλίες σε εξέλιξη. Πάγωμα αυτής της κρίσης κατά την εγγραφή θα χρησιμοποιούσε ποσό ήδη παρωχημένο στην επόμενη κλήση.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 429

• credit:spend

Πρόσφατες προσπάθειες χρέωσης, από τη νεότερη.

Τα στοιχεία της ειδοποίησης απόρριψης. Διαβάζονται σκόπιμα χωριστά από το υπόλοιπο: «η κάρτα σας απορρίφθηκε» και «η πίστωση εξαντλήθηκε» είναι διαφορετικές καταστάσεις με διαφορετική αντιμετώπιση και ένας χρηματοδοτημένος λογαριασμός μπορεί να βρίσκεται στην πρώτη χωρίς τη δεύτερη — state στο υπόλοιπο δεν μπορεί να το εκφράσει, επειδή η απόρριψη αφορά κάρτα και όχι το τρέχον υπόλοιπο.

requires_reauth και declined είναι διαφορετικές: η μία ζητά νέα ταυτοποίηση κατόχου, η άλλη διαφορετική κάρτα. ambiguous σημαίνει άγνωστο αποτέλεσμα υπό ευθύνη της περιοδικής συμφωνίας πληρωμών — ποτέ «επανάληψη».

• 200
• 400
• 401
• 403
• 429

• credit:spend

Ποιο υπόλοιπο χρηματοδοτεί τον ανοικτό χώρο εργασίας, από πότε και τι επιτρέπεται να κάνει το άτομο με αυτό.

Το ισχύον υπόλοιπο του ανοικτού χώρου εργασίας (scope account είναι το κοινό υπόλοιπο του οργανισμού, workspace το δικό του), η αρχή της αδιάλειπτης χρήσης αυτού του υπολοίπου (since· null για χώρο εργασίας που δεν μεταφέρθηκε ακόμη σε χρηματοδότηση με ημερομηνία ισχύος) και οι χώροι εργασίας που χρηματοδοτεί — κατονομάζονται μόνο για όποιον επιτρέπεται να διαβάζει τους χώρους εργασίας του οργανισμού (funded_workspace_names_complete), διαφορετικά μόνο το πλήθος και ο ανοικτός χώρος εργασίας.

finance_access είναι όσα επιτρέπεται να κάνει το άτομο με το υπόλοιπο: manage ή read (Ιδιοκτήτης, Διαχειριστής ή Οικονομικά του οργανισμού, ή εξουσιοδοτημένος αποκλειστικού υπολοίπου) ή none — μέλος χώρου εργασίας χωρίς αυτό βλέπει μόνο τη δαπάνη του χώρου και οι μέθοδοι πληρωμής, η αυτόματη ανανέωση, οι προσπάθειες χρέωσης, τα τιμολόγια και το καθολικό του υπολοίπου απαντούν 403 capability_missing.

• 200
• 401
• 403
• 429

• credit:spend

Τα εκδοθέντα τιμολόγια, από τη νεότερη περίοδο.

blob_name είναι η αποθηκευμένη αναφορά, όχι URL. Η παροχή υπογεγραμμένου συνδέσμου παραχωρεί πρόσβαση και ανήκει στη διαδρομή λήψης, όχι στην παράθεση.

• 200
• 400
• 401
• 403
• 429

• credit:spend

Συναλλαγές — κάθε κίνηση χρημάτων, από τη νεότερη.

Σελιδοποιείται με δείκτη στο sequence, που αυξάνεται μονότονα ανά λογαριασμό χρέωσης. Ποτέ με μετατόπιση: το καθολικό δέχεται συνεχείς προσθήκες και η σελίδα μετατόπισης υπολογίζει ξανά την αρχή σε κάθε αίτημα, οπότε εισαγωγή γραμμής κατά τη σελιδοποίηση προκαλεί διπλότυπο ή παράλειψη.

• 200
• 400
• 401
• 403
• 429

• credit:spend

Αποθηκευμένες κάρτες — μάρκα, λήξη και τέσσερα τελευταία ψηφία.

• 200
• 401
• 403
• 429

• credit:spend

Αφαιρέστε αποθηκευμένη κάρτα.

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

• 204
• 401
• 403
• 404
• 429

• credit:spend

Ορίστε αυτή την κάρτα ως προεπιλεγμένη.

• 200
• 401
• 403
• 404
• 429

• credit:spend

Αγοράστε το πακέτο πίστωσης με το token της φόρμας και αποθηκεύστε την κάρτα.

Χρεώνει το token μίας χρήσης που παρήγαγε η φόρμα του παρόχου για το ποσό της προσφοράς για την οποία άνοιξε η φόρμα (billing_quote_id: καθαρή αξία πακέτου + ΦΠΑ, FIX-MONEY C1) — ποτέ ποσό υπολογισμένο από το αίτημα· ποσό φόρμας (amount_due_minor) που δεν ισούται με το σύνολο της προσφοράς είναι 409 quote_mismatch και δεν χρεώνεται τίποτα — μέσω του ίδιου καθολικού πρόθεσης χρέωσης που χρησιμοποιεί κάθε ανανέωση. Στην επιτυχία πιστώνεται ο λογαριασμός και αποθηκεύεται η κάρτα από την απάντηση του ίδιου του παρόχου: token αποθηκευμένου πελάτη, token κάρτας, εξουσιοδότηση, μάρκα, λήξη, όνομα κατόχου και τέσσερα τελευταία ψηφία. Δεν γίνεται ποτέ δεκτό στοιχείο κάρτας από το αίτημα· card_token πρέπει να είναι της φόρμας το ctn_ token, ενώ απορρίπτεται token αποθηκευμένου πελάτη ή κάρτας.

Idempotency-Key είναι απαιτούμενο. Η αναφορά δημιουργείται πριν την κλήση και παρέχει *απόρριψη* διπλοτύπων, όχι ιδιοδυναμία: όταν το αποτέλεσμα είναι άγνωστο, ο πάροχος ερωτάται μία φορά τι συνέβη στην ίδια αναφορά και, αν πάλι δεν απαντήσει, η απάντηση είναι pending_reconciliation — ποτέ δεύτερη χρέωση.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 409
• 429

• credit:spend

Με τι ανοίγει η φόρμα πληρωμής για προσθήκη κάρτας με αγορά πίστωσης.

Μια κάρτα προστίθεται με αγορά πίστωσης (απόφαση προϊόντος 2026-09-23). Ο πάροχος δεν τεκμηριώνει αποθήκευση κάρτας χωρίς πληρωμή: το φιλοξενούμενο Payform χρειάζεται ποσό και η εξουσιοδότηση για μελλοντική αυτόματη ανανέωση εκδίδεται μόνο με πραγματική πρώτη πληρωμή από φόρμα που άνοιξε με frequency_type: recurring.

Κατονομάστε ένα πακέτο πίστωσης· η απάντηση περιέχει το ποσό σε ακέραιες υπομονάδες νομίσματος, το δημόσιο κλειδί του παρόχου, το δικό του script και τον τύπο συχνότητας. Το ποσό ορίζεται από τον διακομιστή — το αίτημα δεν περιέχει ποσό. Δεν χρεώνεται τίποτα: ο περιηγητής ανοίγει τη φόρμα του παρόχου με αυτές τις τιμές, ο κάτοχος εισάγει εκεί την κάρτα (ποτέ στο WeTalk) και η φόρμα επιστρέφει token μίας χρήσης για completeCardPurchase.

ΤΡΟΠΟΠΟΙΗΣΗ 2026-10-06 (FIX-MONEY C1): οι τιμές δεν περιλαμβάνουν ΦΠΑ (OD-8), άρα το πακέτο είναι ΚΑΘΑΡΗ πίστωση και αυτή η διαδρομή γράφει μία γραμμή — μια top_up προσφορά καθαρής αξίας πακέτου + ΦΠΑ (billing_quote_id, net_minor, tax_minor, το σύνολο). Η φόρμα ανοίγει και το 3-D Secure επαληθεύει αυτό το σύνολο· η κονσόλα δείχνει πρώτα καθαρή αξία, ΦΠΑ και σύνολο. 409 terms_acceptance_required μέχρι μέλος με ρόλο Ιδιοκτήτη ή Οικονομικών να αποδεχθεί τους όρους αγοράς (PD-8)· 422 legal_profile_required χωρίς τα νομικά στοιχεία του οργανισμού· 503 tax_rate_unset όταν δεν ισχύει συντελεστής ΦΠΑ για τη φορολογική μεταχείριση του πληρωτή.

Τα δωρεάν λεπτά δοκιμής δεν χρειάζονται κάρτα.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 409
• 429

• credit:spend

Αγοράστε πίστωση με αποθηκευμένη ή νέα κάρτα.

Το σώμα περιέχει token της φιλοξενούμενης φόρμας πληρωμής — τα στοιχεία κάρτας δεν φτάνουν ποτέ στο WeTalk, διατηρώντας το πεδίο PCI στο SAQ A.

Μια αναφορά δημιουργείται ντετερμινιστικά από τον λογαριασμό και την προσπάθεια πριν την κλήση και επαναχρησιμοποιείται σε κάθε επανάληψη. Παρέχει *απόρριψη* διπλοτύπων, όχι ιδιοδυναμία: ένα error αποτέλεσμα σημαίνει ότι η έκβαση είναι άγνωστη και πρέπει να διερευνηθεί, ποτέ ότι επιτρέπεται νέα προσπάθεια χρέωσης.

ΤΡΟΠΟΠΟΙΗΣΗ 2026-10-06 (FIX-MONEY C1): amount_minor είναι η ΚΑΘΑΡΗ πίστωση· η κάρτα χρεώνεται με την καθαρή αξία + ΦΠΑ της προσφοράς για την οποία άνοιξε η φόρμα (billing_quote_id, amount_due_minor — createHostedCardForm). Ποσό φόρμας διαφορετικό από το σύνολο της προσφοράς είναι 409 quote_mismatch και δεν χρεώνεται τίποτα.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 409
• 429

• credit:spend

Χρόνος ομιλίας, αθροισμένος ανά φωνητικό βοηθό ανά ημέρα.

Η συγκεντρωτική αναφορά που ζητά το FR-BIL-1. Τα δευτερόλεπτα αθροίζονται ανά (voice_agent, day, medium, is_test) και κοστολογούνται μία φορά, στο κλείσιμο της ημέρας — ώστε εκατόν σαράντα δύο χωριστές στρογγυλοποιήσεις να μην συσσωρεύονται σε υπόλοιπο που δεν συμφωνεί.

• 200
• 400
• 401
• 403
• 429

• δεν χρειάζεται κλειδί

Το webhook «νέα πληρωμή» του παρόχου πληρωμών.

Ο πάροχος στέλνει εδώ το σκέτο αντικείμενο πληρωμής όταν δημιουργείται πληρωμή στον έμπορο χρέωσης. Η διαδρομή ορίζει τον τύπο συμβάντος· δεν διαβάζεται στοιχείο του σώματος για να καθοριστεί.

Δημόσιο: το διαπιστευτήριο είναι η υπογραφή. X-Signature-SHA256 είναι base64(hmac_sha256(raw body, secret)) και επαληθεύεται στα ακατέργαστα bytes, σε σταθερό χρόνο, πριν από οποιαδήποτε ανάλυση JSON. Αίτημα από διεύθυνση εκτός της τεκμηριωμένης λίστας του παρόχου απορρίπτεται με 403 χωρίς εγγραφή. Κάθε άλλο αίτημα καταγράφεται με τα ακατέργαστα bytes και την ετυμηγορία του, ακόμη και πλαστογραφημένο, που επιβεβαιώνεται με 200 χωρίς καμία επεξεργασία.

Τίποτα δεν εξαρτάται από την επίτευξη αυτού του endpoint. Η συμπεριφορά επανάληψης του παρόχου δεν τεκμηριώνεται, επομένως μια περιοδική διεργασία συμφωνίας κλείνει κάθε πληρωμή και από την πλευρά του WeTalk. Το webhook είναι έναυσμα, ποτέ τεκμήριο.

Δέχεται σώμα αιτήματος JSON.

• 200
• 403

• δεν χρειάζεται κλειδί

Το webhook «ειδοποίηση που έληξε» του παρόχου πληρωμών.

Ο πάροχος στέλνει εδώ το σκέτο αντικείμενο ειδοποίησης πληρωμής όταν λήγει ανεξόφλητο. Επαλήθευση, έλεγχος διεύθυνσης και επιβεβαίωση είναι ίδια με τη διαδρομή «νέα πληρωμή».

Δέχεται σώμα αιτήματος JSON.

• 200
• 403

• δεν χρειάζεται κλειδί

Το webhook «ειδοποίηση που πληρώθηκε» του παρόχου πληρωμών.

Ο πάροχος στέλνει εδώ το σκέτο αντικείμενο ειδοποίησης πληρωμής όταν εξοφλείται· το payment πεδίο κατονομάζει την πληρωμή ως συμβολοσειρά token. Επαλήθευση, έλεγχος διεύθυνσης και επιβεβαίωση είναι ίδια με τη διαδρομή «νέα πληρωμή».

Δέχεται σώμα αιτήματος JSON.

• 200
• 403

• δεν χρειάζεται κλειδί

Το webhook «επιστροφή χρημάτων» του παρόχου πληρωμών.

Ο πάροχος στέλνει εδώ όταν επιστρέφεται πληρωμή στον έμπορο χρέωσης. Το σώμα δεν τεκμηριώνεται, οπότε διαβάζεται μόνο ως έναυσμα: ο worker ξαναδιαβάζει τις επιστροφές της πληρωμής από τον πάροχο πριν καταγράψει οτιδήποτε. Επαλήθευση, έλεγχος διεύθυνσης και επιβεβαίωση είναι ίδια με τη διαδρομή «νέα πληρωμή».

Δέχεται σώμα αιτήματος JSON.

• 200
• 403

• order:read

Αν προσφέρεται τώρα διαδικτυακή πληρωμή στους καλούντες και τι λείπει.

Για το βήμα πληρωμής του οδηγού νέου βοηθού και τη ρύθμιση Πληρωμών του φωνητικού βοηθού. mode είναι ο τρόπος διαδικτυακής πληρωμής του λογαριασμού, που ορίζει μόνο το WeTalk (off μέχρι τότε). offered_to_callers δηλώνει αν προσφέρεται τώρα διαδικτυακή πληρωμή σε τηλεφωνικό καλούντα πραγματικής συνομιλίας· offered_in_web_chat το ίδιο για widget ιστοσελίδας. missing παραθέτει, με σειρά ενεργειών, τα εμπόδια: mode_off (το WeTalk δεν την ενεργοποίησε), merchant_binding (ο έμπορος πληρωμών του WeTalk δεν είναι ακόμη στον τρόπο που χρειάζεται αυτός ο λογαριασμός), destination και destination_unverified (απαιτείται προορισμός πληρωμής επαληθευμένος από το WeTalk για pilot και live· ένας sandbox λογαριασμός δεν χρειάζεται κανέναν), general_live (οι πληρωμές πραγματικών χρημάτων δεν είναι ακόμη διαθέσιμες σε κάθε λογαριασμό) και sms_unavailable (δεν υπάρχει αποστολέας SMS, οπότε οι τηλεφωνικοί καλούντες δεν μπορούν να λάβουν σύνδεσμο). Αν το κατάστημα δέχεται διαδικτυακή πληρωμή και αν μια γλώσσα περιέχει το κείμενο πληρωμών είναι ρυθμίσεις του φωνητικού βοηθού και δεν αξιολογούνται εδώ.

• 200
• 401
• 403
• 429

• order:read

Η κατάσταση πληρωτέων για ένα βιβλίο και μία περίοδο.

Τι οφείλει το WeTalk στο κατάστημα για τις διαδικτυακά πληρωμένες παραγγελίες του, για το live βιβλίο (ή, με ένδειξη «Sandbox» στην κονσόλα, το sandbox βιβλίο, που δεν αποδίδεται ποτέ). Η περίοδος αποτελεί ολόκληρες ημέρες στη Europe/Athens, τη ζώνη ώρας όλων των ορίων απόδοσης χρημάτων.

balance είναι το βιβλίο τώρα: held_minor βρίσκεται ακόμη στην περίοδο παρακράτησης (κάθε παρακρατούμενη πίστωση παρατίθεται με το release_at), available_minor είναι όσα μπορεί να πάρει μια απόδοση χρημάτων. Στο πραγματικό βιβλίο holds αναφέρει τι εμποδίζει την επόμενη απόδοση και γιατί, και next_payout είναι το επόμενο χρονικό όριο και το αναμενόμενο ποσό τότε (0 όσο υπάρχει εμπόδιο). entries είναι το καθολικό της περιόδου σε σειρά· μια γραμμή παραγγελίας γράφει μικτό ποσό · προμήθεια WeTalk απορροφημένη · προμήθεια 0 · καθαρό = μικτό. opening_balance_minor + entry_total_minor = closing_balance_minor, και το υπόλοιπο κλεισίματος είναι του βιβλίου στο τέλος της περιόδου. Περισσότερες από 5000 εγγραφές στην περίοδο είναι 422 export_too_large· επιλέξτε μικρότερη περίοδο.

Ιδιοκτήτες, Διαχειριστές και Αναγνώστες το διαβάζουν· Μέλη όχι.

• 200
• 400
• 401
• 403
• 422
• 429

• credit:spend

Πού αποδίδονται τα χρήματα, με απόκρυψη στοιχείων.

null μέχρι ο Ιδιοκτήτης να προσθέσει προορισμό. Ο IBAN εμφανίζεται με τους τέσσερις τελευταίους χαρακτήρες και το φορολογικό αναγνωριστικό με τους τρεις τελευταίους· δεν επιστρέφονται ποτέ οι πλήρεις τιμές. verified γίνεται true όταν το WeTalk ελέγξει τον προορισμό· αλλαγή προορισμού αφαιρεί την επαλήθευση και οι αποδόσεις περιμένουν μέχρι hold_until. Ιδιοκτήτες και Διαχειριστές, συνδεδεμένοι· ποτέ κλειδί API.

• 200
• 401
• 403
• 429

• credit:spend

Αλλάξτε προορισμό απόδοσης (ο Ιδιοκτήτης, με πρόσφατη πρόσθετη ταυτοποίηση).

Μόνο Ιδιοκτήτης, συνδεδεμένος, εντός λίγων λεπτών από νέα εισαγωγή κωδικού, κωδικού εφαρμογής ταυτοποίησης ή passkey (POST /v1/session/step-up): διαφορετικά 401 step_up_required. Απορρίπτεται με 403 step_up_unavailable ενώ η υποστήριξη WeTalk ενεργεί ως μέλος, και 403 για κάθε άλλο ρόλο ή κλειδί API. Ο IBAN πρέπει να ανήκει σε χώρα SEPA και να περνά έλεγχο ψηφίων· BIC απαιτείται μόνο εκτός ΕΟΧ· το ελληνικό φορολογικό αναγνωριστικό είναι ο 9-ψήφιος ΑΦΜ. Μη έγκυρο πεδίο είναι 422 payout_destination_invalid κατονομάζοντας το πεδίο — η τιμή δεν επαναλαμβάνεται ποτέ.

Ο IBAN φυλάσσεται στην αποθήκη κλειδιών αποδόσεων του WeTalk, ποτέ στη βάση: η απάντηση περιέχει τους τέσσερις τελευταίους χαρακτήρες του. Ο νέος προορισμός δεν επαληθεύεται μέχρι να τον ελέγξει το WeTalk, και οι αποδόσεις περιμένουν την παρακράτηση αλλαγής προορισμού (hold_until). Καταγράφεται ως payout_destination.changed.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 422
• 429
• 502

• order:read
• βαρύ

Οι πληρωτέες εγγραφές της περιόδου ως υπολογιστικό φύλλο.

Οι ίδιες εγγραφές με το GET /v1/payouts, μία γραμμή καθεμία, δημιουργούνται όταν ζητούνται χωρίς αποθήκευση: UTF-8 με δείκτη σειράς bytes, εγγραφές CRLF, ποσά ως προσημασμένοι δεκαδικοί σε ευρώ. Πεδίο κειμένου που αρχίζει με =, +, - ή @ προτάσσεται με μονό εισαγωγικό.

• 200
• 400
• 401
• 403
• 422
• 429

• agent:read

Τα αιτήματα αυτού του χώρου εργασίας για περισσότερες ταυτόχρονες συνομιλίες, από το νεότερο.

• 200
• 401
• 403
• 429

• agent:write

Ζητήστε από το WeTalk περισσότερες ταυτόχρονες συνομιλίες.

Καταγράφει ένα quota_request (state: pending) και μια καταχώριση ελέγχου (billing.quota_requested) σε μία db_transaction. Χειριστής διαβάζει εκκρεμή αιτήματα από το API χειριστών και αυξάνει το όριο του λογαριασμού· τίποτα δεν αλλάζει πριν το κάνει.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 429

• agent:read

Ποιος επιτρέπεται να δημιουργεί χώρους εργασίας σε αυτόν τον οργανισμό.

• 200
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Αλλάξτε ποιος μπορεί να δημιουργεί χώρους εργασίας.

account.workspace.manage (Ιδιοκτήτης, Διαχειριστής)· όταν επιτρέπεται μόνο στον Ιδιοκτήτη, μόνο εκείνος μπορεί να αλλάξει την πολιτική (403 workspace_creation_forbidden). Απορρίπτεται χειριστής WeTalk που ενεργεί ως μέλος. If-Match κατονομάζει την αναθεώρηση του οργανισμού (409 revision_stale όταν άλλαξε).

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Κάθε χώρος εργασίας του οργανισμού με την κατάσταση κύκλου ζωής του.

account.workspace_metadata.read. Πρώτα ενεργοί χώροι και χώροι σε διαδικασία παύσης, τελευταίοι αρχειοθετημένοι, καθένας με την αρχειοθέτηση σε εξέλιξη (open_operation_id) — η σελίδα Αρχειοθέτηση και κλείσιμο.

• 200
• 401
• 403
• 404

• μόνο συνδεδεμένο άτομο

Δημιουργήστε χώρο εργασίας σε αυτόν τον οργανισμό και ορίστε τον καλούντα ως Ιδιοκτήτη.

plan-014 B3 (FR12-WSP-01). Όνομα, προαιρετικό σταθερό slug (ποτέ _account· ένα που έχει χρησιμοποιήσει αυτός ο οργανισμός είναι 409 slug_taken), ζώνη ώρας και τρόπος χρηματοδότησης: κοινό υπόλοιπο ή δικό του από €0.00 — που απαιτεί account.finance.manage (Ιδιοκτήτης, Διαχειριστής, Οικονομικά). Ο χώρος, η ιδρυτική συμμετοχή Ιδιοκτήτη και η χρηματοδότησή του (billing_assignment) αποτελούν μία μονάδα εργασίας.

Η πολιτική «ποιος μπορεί να δημιουργεί χώρους εργασίας» καθορίζει τους δικαιούχους: Ιδιοκτήτης και Διαχειριστές ή μόνο Ιδιοκτήτης — 403 workspace_creation_forbidden για Διαχειριστή στη δεύτερη περίπτωση. Ελέγχεται πρώτα το δικαίωμα χώρων εργασίας του οργανισμού (409 resource_limit_reached· η πληρωμή ανά χρήση δεν έχει όριο). Δεν επιτρέπεται κλήση από κλειδί API.

plan-015 WSK (G25): προαιρετικό kind — standard (όταν απουσιάζει) ή test, ετικέτα που χρεώνεται όπως κάθε χώρος εργασίας.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 429

• agent:read

Το αρχείο ελέγχου του χώρου εργασίας, από τη νεότερη εγγραφή.

Εγγραφές από τους τελευταίους retention_month ημερολογιακούς μήνες (24), από τη νεότερη, με προαιρετικό φίλτρο. matched_count μετρά το φιλτραρισμένο σύνολο, όχι τη σελίδα, έως 10 000 (matched_count_capped δηλώνει αν υπάρχουν περισσότερες). Εγγραφές χειριστή WeTalk — αναπαραγωγή ηχογράφησης, ανάγνωση απομαγνητοφώνησης, χρόνος εκπροσώπησης μέλους — περιέχουν origin: wetalk_support, κατονομάζουν τον χειριστή όπως καταγράφηκε και το εκπροσωπούμενο μέλος στο effective_actor. Το αρχείο χειριστών δεν διαβάζεται ποτέ.

• 200
• 400
• 401
• 403
• 429

• agent:read
• βαρύ

Εξαγάγετε το αρχείο ελέγχου ως CSV.

Γράφει κάθε εγγραφή που ταιριάζει στα φίλτρα εντός του ορίου διατήρησης σε CSV (UTF-8 με δείκτη σειράς bytes, εγγραφές CRLF, πεδίο που αρχίζει με =, +, - ή @ με πρόθεμα ') και επιστρέφει σύνδεσμο λήψης μικρής διάρκειας. Περισσότερες από WETALK_API_EXPORT_MAX_ROW εγγραφές είναι 422 export_too_large μαζί με το πλήθος· το αρχείο δεν περικόπτεται ποτέ. Το CSV περιέχει τα στοιχεία της προβολής — πραγματικό και ενεργό δράστη, αποτέλεσμα, πεδίο στόχου, αιτιολογία και ασφαλείς τιμές πριν/μετά — ποτέ άλλα στοιχεία της εγγραφής, και κατονομάζει τον χειριστή σε κάθε δική του εγγραφή. Η ίδια η εξαγωγή καταγράφεται (audit_entry.exported): η εγγραφή γράφεται ΠΡΙΝ διαβαστούν οι γραμμές, στην ίδια συναλλαγή βάσης δεδομένων, και δεν περιλαμβάνεται στο αρχείο.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 422
• 429

• agent:read

Οι ενεργοί χώροι εργασίας που μπορεί να δει ο καλών.

Κάθε γραμμή περιέχει τα δύο μεγέθη των καρτών — πόσα άτομα συμμετέχουν και τη δαπάνη του μήνα — υπολογισμένα στο ίδιο στιγμιότυπο με τη γραμμή, ώστε όνομα και μεγέθη να μην προέρχονται από διαφορετικές στιγμές. Οι αρχειοθετημένοι χώροι απουσιάζουν· deleted_at είναι αυτό που αρχειοθετεί έναν χώρο.

plan-014 B3: Ιδιοκτήτης, Διαχειριστής, Οικονομικά και Αναγνώστης του οργανισμού βλέπουν κάθε χώρο εργασίας (account.workspace_metadata.read), με ή χωρίς ανοικτό χώρο· όλοι οι άλλοι βλέπουν χώρους όπου έχουν ρόλο — κανένας άλλος χώρος δεν εμφανίζεται, ούτε ως πλήθος. Κάθε γραμμή κατονομάζει τη χρηματοδότησή της, την αναθεώρηση και τον ρόλο του καλούντος. q αναζητά στο όνομα (χωρίς διάκριση πεζών/κεφαλαίων)· η λίστα σελιδοποιείται με κλειδιά, από τον παλαιότερο.

plan-015 BAL (G24): γραμμή με δικό της υπόλοιπο περιέχει dedicated_balance (το ποσό του) μόνο για καλούντα με πρόσβαση ανάγνωσης στο υπόλοιπο — Ιδιοκτήτη, Διαχειριστή και Οικονομικά του οργανισμού ή άτομο του χώρου με σχετική εξουσιοδότηση. Για άλλους το πεδίο απουσιάζει.

• 200
• 400
• 401
• 403
• 429

• μόνο συνδεδεμένο άτομο

Δημιουργήστε χώρο εργασίας και ορίστε τον καλούντα ως Ιδιοκτήτη (διαδρομή πριν το plan-014).

Διατηρείται για μία έκδοση δίπλα στο POST /v1/accounts/{account_id}/workspaces, με τους ίδιους κανόνες· σώμα χωρίς funding σημαίνει κοινό υπόλοιπο, όπως πάντα.

Ο χώρος και η ιδρυτική συμμετοχή αποτελούν μία μονάδα εργασίας. Χώρος χωρίς συμμετοχή δεν είναι προσβάσιμος στον δημιουργό του, γι’ αυτό οι δύο εγγραφές γίνονται σε μία συναλλαγή αντί για δύο αιτήματα με ενδιάμεσο κενό.

Ο νέος χώρος δείχνει στον προεπιλεγμένο λογαριασμό χρέωσης — την επιλογή σχεδιασμού «κοινό υπόλοιπο λογαριασμού». Χωριστό υπόλοιπο είναι διαφορετικός λογαριασμός χρέωσης και δεν δημιουργείται εδώ: χώρος συνδεδεμένος σε τέτοιον χωρίς μέθοδο πληρωμής θα φαινόταν χρηματοδοτημένος αλλά θα απέρριπτε κάθε κλήση.

Δεν επιτρέπεται κλήση από κλειδί API. Η ιδρυτική συμμετοχή χρειάζεται άτομο ως ιδιοκτήτη, και το κλειδί δεν είναι άτομο.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 409
• 429

• agent:write

Αρχειοθετήστε χώρο εργασίας. Ο Ιδιοκτήτης του χώρου ή ο Ιδιοκτήτης ή Διαχειριστής του οργανισμού.

Ποιος. Ο Ιδιοκτήτης του ίδιου του χώρου (workspace.lifecycle) ή ο Ιδιοκτήτης ή Διαχειριστής του οργανισμού — είτε μέλος του χώρου είτε όχι, με ανοικτό χώρο ή μόνο οργανισμό (ADR 0041, 2026-10-09). Οποιοσδήποτε άλλος απορρίπτεται ως προς τον χώρο στόχο.

Αρχειοθέτηση, όχι διαγραφή. Συνομιλίες, εγγραφές καθολικού και ελέγχου δείχνουν σε αυτή τη γραμμή· η αφαίρεσή της θα διέγραφε διαδοχικά ιστορικό χρέωσης ή θα αποτύγχανε σε ξένο κλειδί. deleted_at με state = 'archived' αφαιρεί τον χώρο από κάθε ενεργή προβολή — σταματώντας τις απαντήσεις όλων των βοηθών του — διατηρώντας ανέπαφα τα τεκμήρια των ενεργειών του.

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

Μόνο ένας κενός χώρος αρχειοθετείται (διαφορετικά 409): χωρίς φωνητικούς βοηθούς και μόνο με το άτομο που αρχειοθετεί. Απορρίπτεται ο χώρος στον οποίο είναι συνδεδεμένος ο καλών (πρώτα αλλάξτε χώρο). Η αρχειοθέτηση αποσύρει ανοικτές προσκλήσεις και τερματίζει τις υπόλοιπες συμμετοχές.

• 204
• 401
• 403
• 404
• 409
• 429

• agent:read

Ένας χώρος εργασίας με τους φωνητικούς βοηθούς του.

• 200
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Μετονομάστε χώρο εργασίας ή αλλάξτε τη ζώνη ώρας του.

Το slug δεν αλλάζει με μετονομασία. Χρησιμοποιείται σε διαδρομές αποθήκευσης, άρα η αλλαγή θα άφηνε ορφανά τα blobs της παλιάς διαδρομής.

name καθαρίζεται από ακραία κενά και έχει έως 60 χαρακτήρες (όπως στη δημιουργία), και δεν μπορεί να υπάρχει ήδη σε άλλον ενεργό χώρο του λογαριασμού (χωρίς διάκριση πεζών/κεφαλαίων): 409 conflict διαφορετικά. Αλλαγή ονόματος γράφει workspace.renamed, αλλαγή ζώνης workspace.time_zone_changed, καθεμία με προηγούμενη και νέα τιμή.

Μόνο σύνδεση ατόμου. Ένα κλειδί API είναι 403 permission_denied: η καταχώριση ελέγχου κατονομάζει το άτομο που άλλαξε τα στοιχεία (customer-portal review item 182). Χώρος σε παύση ή αρχειοθετημένος κρατά το όνομά του (422).

plan-015 WSK (G25, ADR 0050): προαιρετικό kind (standard | test) αλλάζει την ετικέτα του χώρου — μόνο Ιδιοκτήτης ή Διαχειριστής του οργανισμού, όπως στη μετονομασία — και αλλαγή τύπου γράφει workspace.kind_changed με { old, new }. Αν απουσιάζει, ο τύπος διατηρείται.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• agent:read

Πώς εντάσσονται άτομα σε αυτόν τον χώρο εργασίας.

• 200
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Αλλάξτε πώς εντάσσονται άτομα σε αυτόν τον χώρο εργασίας.

Ο Ιδιοκτήτης ή Διαχειριστής του χώρου ή του οργανισμού. verified_domain κατονομάζει έναν ΕΠΑΛΗΘΕΥΜΕΝΟ τομέα του οργανισμού και τον ρόλο ένταξης — ποτέ Ιδιοκτήτη ή Διαχειριστή (422 validation_failed). Χώρος σε παύση ή αρχειοθετημένος κρατά τους κανόνες του (422). Απορρίπτεται χειριστής WeTalk που ενεργεί ως μέλος.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• μόνο συνδεδεμένο άτομο

Αρχειοθετήστε τον χώρο όταν τελειώσουν οι συνομιλίες του.

Ο χώρος γίνεται draining: απορρίπτονται νέες συνομιλίες και προσπάθειες καμπάνιας (workspace_draining), οι καμπάνιες παύουν και δεν επανεκκινούν με επαναφορά, αριθμοί και widgets αποσυνδέονται (οι αριθμοί παραμένουν του οργανισμού), κλειδιά API ανακαλούνται οριστικά, εκκρεμείς προσκλήσεις αποσύρονται. Οι τρέχουσες συνομιλίες τελειώνουν· ο χώρος αρχειοθετείται όταν λήξει η τελευταία — αμέσως αν καμία δεν εκτελείται. 202 με την πράξη (200 για το ίδιο Idempotency-Key ξανά). Απορρίπτεται ο μοναδικός ενεργός χώρος του οργανισμού με 409 operation_conflict· ένας ήδη σε παύση ή αρχειοθετημένος με 422 workspace_draining / workspace_archived. in_progress_action είναι finish (δεν διατίθεται άμεσος τερματισμός συνομιλιών).

• 200
• 202
• 400
• 401
• 403
• 404
• 409

• μόνο συνδεδεμένο άτομο

Τι θα έκανε η αρχειοθέτηση αυτού του χώρου, στοιχείο προς στοιχείο.

workspace.lifecycle στον χώρο ή account.workspace.manage στον οργανισμό. Μία γραμμή για τρέχουσες συνομιλίες, ενεργές καμπάνιες, αριθμούς και διαδικτυακή συνομιλία, κλειδιά API, αποκλειστικό υπόλοιπο και επαναλαμβανόμενα πρόσθετα: now (τι υπάρχει) και on_archive (τι κάνει η αρχειοθέτηση σε αυτό), με τις λέξεις της κονσόλας, μαζί με πλήθος ή ποσό (amount_minor + currency). open_operation είναι η αρχειοθέτηση σε εξέλιξη, αν υπάρχει.

• 200
• 401
• 403
• 404

• agent:write

Προσκαλέστε κάποιον σε χώρο εργασίας.

Το token επιστρέφεται ακριβώς μία φορά. invitation.token_hash είναι το μόνο που κρατά η βάση, άρα δεν υπάρχει δεύτερη εμφάνιση ή διαδρομή ανάκτησης — ίδιο συμβόλαιο με κλειδί API, για τον ίδιο λόγο. Ο καλών παραδίδει τον σύνδεσμο· η κονσόλα εμφανίζει διάλογο εφάπαξ αντιγραφής.

Μια πρόσκληση δεν δημιουργεί άτομο. Η αποδοχή απαιτεί ταυτοποιημένη σύνδεση και το άτομο είτε υπάρχει είτε εγγράφεται πρώτα: πρόσκληση που δημιουργούσε εγγραφή ατόμου θα δημιουργούσε λογαριασμούς για διευθύνσεις που δεν ελέγχει κανείς.

Διαχειριστής δεν μπορεί να προσκαλέσει Ιδιοκτήτη. Προσφέρεται οποιοσδήποτε από τους επτά ρόλους χώρου (plan-014 B3). Χώρος σε παύση ή αρχειοθετημένος δεν δέχεται πρόσκληση (422 workspace_draining / workspace_archived), και ελέγχεται το δικαίωμα θέσεων (409 seat_limit_reached· η πληρωμή ανά χρήση δεν έχει όριο θέσεων).

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

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• agent:write

Ανακαλέστε πρόσκληση που δεν έχει γίνει δεκτή.

Ποιος. Οι Ιδιοκτήτες και Διαχειριστές του χώρου (membership.invite) και ο Ιδιοκτήτης και Διαχειριστής του οργανισμού σε κάθε χώρο του, είτε συμμετέχουν είτε όχι, που έχουν membership.remove εκεί χωρίς δυνατότητα πρόσκλησης (ADR 0052, 2026-10-10). Η καταχώριση ελέγχου περιέχει authority: "organization" όταν χρησιμοποιείται αυτή η εξουσία.

• 204
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Η μόνιμη κατάσταση αρχειοθέτησης ή επαναφοράς.

• 200
• 401
• 403
• 404

• μόνο συνδεδεμένο άτομο

Ακυρώστε αρχειοθέτηση που περιμένει ακόμη την τελευταία συνομιλία.

Ο χώρος ενεργοποιείται ξανά και επανασυνδέονται αριθμοί και widgets που αποσυνδέθηκαν· ανακληθέντα κλειδιά API παραμένουν ανακληθέντα και καμπάνιες σε παύση παραμένουν σε παύση (γνωστοποιείται). 409 operation_state_conflict όταν ολοκληρωθεί η αρχειοθέτηση.

• 200
• 401
• 403
• 404
• 409

• agent:read

Τα άτομα του χώρου και οι προσκλήσεις του — εκκρεμείς, ληγμένες και ανακληθείσες.

Μία απάντηση αντί δύο, επειδή η οθόνη τα εμφανίζει σε μία λίστα με στήλη Κατάσταση — και επειδή μέλος και πρόσκληση στην ίδια διεύθυνση από χωριστά σελιδοποιημένες απαντήσεις προκαλούν διπλή γραμμή στην οθόνη.

Ποιος. Οι Ιδιοκτήτες, Διαχειριστές, Μέλη και Αναγνώστες του χώρου (membership.read) και ο Ιδιοκτήτης και Διαχειριστής του οργανισμού σε κάθε χώρο του, μέλη ή όχι, με ανοικτό χώρο ή μόνο οργανισμό (ADR 0041, 2026-10-09).

display_name και email προέρχονται από τον ρόλο ταυτότητας, δηλαδή μια δεύτερη ανάγνωση: membership περιορίζεται στον λογαριασμό και person δεν περιορίζεται, άρα κανένας ρόλος δεν μπορεί να τα ενώσει. Είναι null όταν δεν υπάρχει πια το άτομο, επειδή επινόηση ονόματος για ορφανή συμμετοχή θα έκρυβε πραγματική κατάσταση.

• 200
• 401
• 403
• 404
• 429

• agent:write

Αφαιρέστε κάποιον από χώρο εργασίας.

removed_at ορίζεται· η γραμμή παραμένει. Οι καταχωρίσεις ελέγχου κατονομάζουν τη συμμετοχή και η διαγραφή της θα αφαιρούσε το νόημα εγγραφών που ακόμη την αναφέρουν. Ο τελευταίος Ιδιοκτήτης δεν αφαιρείται, όπως δεν υποβιβάζεται, και μόνο Ιδιοκτήτης μπορεί να αφαιρέσει Ιδιοκτήτη (403 member_role_insufficient για Διαχειριστή ή κλειδί API· review #132).

Ποιος. Οι Ιδιοκτήτες και Διαχειριστές του χώρου (membership.remove) και ο Ιδιοκτήτης και Διαχειριστής του οργανισμού σε κάθε χώρο του, μέλη ή όχι (ADR 0052, 2026-10-10). Με εξουσία οργανισμού μπορούν να αφαιρέσουν Ιδιοκτήτη, ακόμη και τον τελευταίο· ο Διαχειριστής του οργανισμού ποτέ δεν αφαιρεί τον Ιδιοκτήτη του οργανισμού. Η καταχώριση ελέγχου περιέχει authority: "organization".

• 204
• 401
• 403
• 404
• 409
• 429

• agent:write

Αλλάξτε ρόλο μέλους.

Ο τελευταίος Ιδιοκτήτης δεν υποβιβάζεται. Λογαριασμός χωρίς Ιδιοκτήτη δεν έχει κανέναν που μπορεί να πληρώσει, να αλλάξει επίπεδο ή να τον διαγράψει, και η ανάκτηση καταλήγει σε SQL από την υποστήριξη.

Μόνο Ιδιοκτήτης μπορεί να προάγει κάποιον σε Ιδιοκτήτη ή να αλλάξει ρόλο Ιδιοκτήτη (403 member_role_insufficient διαφορετικά· customer-portal review 2026-09-25 #132). Αλλιώς η αλλαγή ρόλου γίνεται μηχανισμός αύξησης προνομίων: Διαχειριστής θα μπορούσε να υποβιβάσει όλους τους Ιδιοκτήτες πλην ενός. Κλειδί API δεν επιτρέπεται καμία από τις δύο ενέργειες επειδή δεν έχει ρόλο.

Ποιος. Οι Ιδιοκτήτες και Διαχειριστές του χώρου (membership.role_change) και ο Ιδιοκτήτης και Διαχειριστής του οργανισμού σε κάθε χώρο του, μέλη ή όχι, με ανοικτό χώρο ή μόνο οργανισμό (ADR 0052, 2026-10-10). Με εξουσία οργανισμού ενεργούν υπό τα όρια Ιδιοκτήτη χώρου και μπορούν να υποβιβάσουν τον τελευταίο Ιδιοκτήτη (ο οργανισμός εξακολουθεί να εποπτεύει τον χώρο)· κανείς δεν αλλάζει έτσι τον δικό του ρόλο και ο Διαχειριστής του οργανισμού ποτέ δεν αλλάζει τον Ιδιοκτήτη του οργανισμού (403 member_role_insufficient). Η καταχώριση ελέγχου περιέχει authority: "organization".

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Επαναφέρετε αρχειοθετημένο χώρο εργασίας.

Επανελέγχει σε μία db_transaction: «ποιος μπορεί να δημιουργεί χώρους» (403 workspace_creation_forbidden), τη χρηματοδότηση (παύση ισχύος υπολοίπου 409 operation_conflict· αναστολή λόγω μη πληρωμής 422 account_suspended_nonpayment) και το όριο χώρων του οργανισμού (409 resource_limit_reached). Καμπάνιες, κλειδιά API και αριθμοί παραμένουν όπως στην αρχειοθέτηση: ξεκινήστε καμπάνιες και επανασυνδέστε αριθμό όταν είστε έτοιμοι.

• 200
• 401
• 403
• 404
• 409

• order:read

Μία σελίδα βιβλίου παραγγελιών, από τη νεότερη.

Σελιδοποίηση με δείκτη, ποτέ μετατόπιση. shop κατονομάζει τον πάγκο· με ένα κατάστημα στον χώρο μπορεί να παραλειφθεί.

• 200
• 400
• 401
• 403
• 404
• 429

• order:write

Καταγράψτε παραγγελία.

Το κόστος παράδοσης ανήκει στο κατάστημα και καθορίζεται από ό,τι απομένει μετά την έκπτωση, άρα ένα κουπόνι μπορεί να φέρει την παραγγελία κάτω από το όριο δωρεάν παράδοσης. Του καλούντος το total δεν θεωρείται αξιόπιστο ότι το εφάρμοσε.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 409
• 429

• order:read

Μία παραγγελία με τη συνομιλία προέλευσής της.

• 200
• 400
• 401
• 403
• 404
• 429

• order:write

Προχωρήστε την κατάσταση, ακυρώστε με αιτιολογία, αναιρέστε την τελευταία μετακίνηση ή σημάνετε ως πληρωμένη.

Η μετακίνηση συγκρίνει και ορίζει την τρέχουσα κατάσταση, ώστε δύο άτομα που προχωρούν την ίδια παραγγελία να λαμβάνουν μία επιτυχία και ένα 409 αντί για δύο μεταβάσεις από ήδη εγκαταλειμμένη κατάσταση.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• order:write

Στείλτε ξανά τον σύνδεσμο πληρωμής παραγγελίας.

Ο ίδιος σύνδεσμος όσο ισχύει (το SMS τηλεφωνικής παραγγελίας επαναστέλλεται εντός ορίων SMS)· νέος σύνδεσμος μόνο αφού ο τελευταίος λήξει, αποτύχει ή ακυρωθεί — ποτέ δεύτερος όσο ένας δημιουργείται. Εκτελείται από τον worker: η απάντηση είναι 202 με την τρέχουσα κατάσταση πληρωμής.

Δέχεται σώμα αιτήματος JSON.

• 202
• 400
• 401
• 403
• 404
• 409
• 429

• order:write

Ακυρώστε τον ανοικτό σύνδεσμο πληρωμής παραγγελίας.

Η ενέργεια «Ακύρωση συνδέσμου» της κονσόλας — πριν τη σήμανση ως πληρωμένης ή με επιλογή καταστήματος. Ο worker τον ακυρώνει στον πάροχο· αν ο πάροχος αναφέρει ενδιάμεση πληρωμή, καταγράφεται εκείνη αντί ακύρωσης.

• 202
• 401
• 403
• 404
• 409
• 429

• order:write

Αλλάξτε την παραγγελία σε πληρωμή κατά την παράδοση/παραλαβή.

Μόνο μέθοδος που δέχεται ο φωνητικός βοηθός της παραγγελίας. Ανοικτός σύνδεσμος πληρωμής ακυρώνεται. Απορρίπτεται σε πληρωμένη παραγγελία.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• order:write

Επιστρέψτε διαδικτυακή πληρωμή, πλήρως ή μερικώς.

Μόνο Ιδιοκτήτης και Διαχειριστής. amount_minor: null επιστρέφει όλο το επιστρέψιμο ποσό. Η επιστροφή καταγράφεται αμέσως και εκτελείται από τον worker· η κατάστασή της αλλάζει στην οθόνη Παραγγελιών με τις απαντήσεις του παρόχου. Δοκιμαστική πληρωμή επιστρέφεται αμέσως χωρίς μετακίνηση χρημάτων.

Δέχεται σώμα αιτήματος JSON.

• 202
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• order:write

Καταγράψτε εκτύπωση δελτίου κουζίνας και επιστρέψτε τι θα εκτυπωθεί.

• 200
• 400
• 401
• 403
• 404
• 429

• order:read
• βαρύ

Το βιβλίο παραγγελιών ως υπολογιστικό φύλλο.

Μία γραμμή ανά παραγγελία, όχι ανά είδος — ο ιδιοκτήτης συμφωνεί φύλλο παραγγελιών με το ταμείο και μία γραμμή ανά είδος θα πολλαπλασίαζε κάθε σύνολο με το πλήθος πιτσών.

Με όριο, όχι σελιδοποίηση: CSV με δείκτη δεν είναι CSV. Περιορίστε το διάστημα με since· διάστημα πάνω από το όριο απορρίπτεται με το πλήθος αντί σιωπηρής περικοπής.

Πεδίο που αρχίζει με =, +, - ή @ παίρνει πρόθεμα μονό εισαγωγικό. Excel, LibreOffice και Sheets το αντιμετωπίζουν ως τύπο, και το βιβλίο παραγγελιών αποθηκεύει τρία πεδία ελεύθερου κειμένου που μπορεί να υπαγορεύσει καλών.

plan-005 OP-35: τέσσερις στήλες ακολουθούν τις υπάρχουσες — payment_state, paid_amount, refunded_amount (κύριες νομισματικές μονάδες) και payment_is_test.

• 200
• 400
• 401
• 403
• 404
• 429

• order:read

Τα μεγέθη πάνω από τον πίνακα Παραγγελιών.

• 200
• 400
• 401
• 403
• 404
• 429

• order:read

Μεταφερμένο: κάθε κουπόνι αυτού του καταστήματος.

• 200
• 401
• 403
• 404
• 429

• order:write

Μεταφερμένο: δημιουργία κουπονιού.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 409
• 429

• order:write

Μεταφερμένο: διαγραφή κουπονιού.

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

• 200
• 401
• 403
• 404
• 429

• order:read

Μεταφερμένο: μπορεί να χρησιμοποιηθεί τώρα αυτό το κουπόνι;

Ο έλεγχος πέντε βημάτων, με πρώτη αποτυχία να υπερισχύει: άγνωστο ή ανενεργό → 404 unknown_code· ληγμένο → 422· κάτω από το ελάχιστο → 422 (παραλείπεται όταν subtotal λείπει ή είναι μηδέν, επειδή καλών που δεν παρήγγειλε ακόμη δεν απέτυχε ελάχιστο)· όριο ανά πελάτη → 422 (παραλείπεται όταν δεν δίνεται phone , επειδή δεν ελέγχεται όριο για άγνωστο καλούντα — επανελέγχεται στην εξαργύρωση).

• 200
• 401
• 403
• 404
• 422
• 429

• order:write

Μεταφερμένο: αλλαγή των πέντε μεταβλητών πεδίων κουπονιού.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 429

• order:read

Μεταφερμένο: κάθε αναγνωρισμένος καλών, από τον πιο πρόσφατο.

• 200
• 401
• 403
• 404
• 429

• order:read

Μεταφερμένο: αναγνώριση καλούντος από αριθμό τηλεφώνου.

Μία από τις δύο κλήσεις που κάνει παράλληλα ο φωνητικός βοηθός όταν καλεί γνωστός αριθμός. Υποβαθμίζεται αντί να αποτυγχάνει: ο πελάτης αναφοράς απαντά null σε κάθε σφάλμα και συνεχίζει την παραγγελία, επειδή βλάβη του συστήματος παραγγελιών δεν πρέπει να εμποδίζει τηλεφωνική κλήση (design §9.7 item 1).

• 200
• 401
• 403
• 404
• 429

• order:write

Μεταφερμένο: απομνημόνευση καλούντος και διεύθυνσης.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 429

• order:read

Μεταφερμένο: τι παρήγγειλε προηγουμένως αυτός ο καλών.

Ανάκληση πρόσφατων παραγγελιών και ανάγνωση για το «πού είναι η παραγγελία μου;» — ο φωνητικός βοηθός απαντά από αυτές τις γραμμές χωρίς κλήση μοντέλου. active=1 περιορίζει σε ενεργές παραγγελίες, όπως χρειάζεται η ερώτηση.

• 200
• 401
• 403
• 404
• 429

• order:read

Μεταφερμένο: κάθε παραγγελία, από τη νεότερη.

• 200
• 401
• 403
• 404
• 409
• 429

• order:write

Μεταφερμένο: καταγραφή παραγγελίας.

Διπλότυπο id απαντά 409 με την υπάρχουσα παραγγελία στο σώμα, που ο πελάτης αναφοράς διαβάζει ως επιτυχία — έτσι είναι ασφαλής η επαναλαμβανόμενη αποστολή από φωνητικό βοηθό στη μέση πρότασης.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 409
• 429

• order:write

Μεταφερμένο: ακύρωση. Ποτέ δεν διαγράφει γραμμή.

Ορίζει την κατάσταση σε cancelled και επιστρέφει την παραγγελία. Μία σκόπιμη απόκλιση: η αναφορά επιβάλλει cancelled από κάθε κατάσταση, ακόμη και delivered, επειδή ελέγχει νομιμότητα μόνο για {"status":"next"}. Εδώ αποφασίζει η μηχανή καταστάσεων, οπότε ακύρωση παραδοθείσας παραγγελίας απαντά με το αντίστοιχο της αναφοράς cannot move from delivered αντί να αναιρεί σιωπηρά την παράδοση πληρωμένης παραγγελίας.

• 200
• 400
• 401
• 403
• 404
• 429

• order:read

Μεταφερμένο: μία παραγγελία.

• 200
• 401
• 403
• 404
• 429

• order:write

Μεταφερμένο: προώθηση κατάστασης ή σήμανση ως πληρωμένης.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 429

• δεν χρειάζεται κλειδί

Ο πίνακας πάγκου — κάθε ενεργή παραγγελία ενός καταστήματος.

Μία σελίδα χωρίς δείκτη: ο πίνακας είναι όλη η ενεργή κατάσταση ενός πάγκου και κουζίνα που μετακινείται στη σελίδα για το επόμενο δελτίο έχει χειρότερη οθόνη από έναν πάσσαλο χαρτιών.

Ο αριθμός τηλεφώνου του καλούντος δεν εμφανίζεται στην κάρτα. Tablet στον πάγκο είναι η μοναδική επιφάνεια της πλατφόρμας που μπορεί να διαβάσει ξένος πάνω από τον ώμο σας· για παράδοση σακούλας χρειάζεται όνομα και δρόμος, όχι αριθμός τηλεφώνου.

Η απάντηση περιέχει shop_id ώστε το tablet να ανοίξει GET /v1/shop/{shop_id}/order-stream και να ανανεώνεται σε κάθε αλλαγή αντί να κάνει περιοδικές αναγνώσεις. Αυτό είναι το μόνο αναγνωριστικό που μαθαίνει το tablet — το αναγνωριστικό λογαριασμού δεν περνά αυτό το όριο.

• 200
• 404
• 429

• δεν χρειάζεται κλειδί

Ο πάγκος αλλάζει τους χρόνους αναμονής — σε φόρτο, από την οθόνη καταστήματος.

Το δικαίωμα πρόσβασης του πάγκου, όπως στον πίνακα: όποιος έχει τον σύνδεσμο οθόνης μπορεί να δηλώσει τους τρέχοντες χρόνους παραγγελιών. Τίποτα άλλο για το κατάστημα δεν αλλάζει από το tablet.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 404
• 429

• δεν χρειάζεται κλειδί

Το απλό πάτημα — προώθηση μίας παραγγελίας κατά ένα βήμα.

Χωρίς σώμα. Η μόνη νόμιμη κίνηση είναι το επόμενο βήμα, άρα δεν χρειάζεται πληροφορία· σώμα με κατάσταση στόχο θα επέτρεπε αυθαίρετη κατάσταση, ενώ αυτό το δικαίωμα επιτρέπει μόνο ένα βήμα εμπρός.

Η ακύρωση απουσιάζει σκόπιμα. Δυνατότητα ακύρωσης πληρωμένης παραγγελίας χωρίς σύνδεση και όνομα δράστη δεν παραχωρείται σε tablet — η κονσόλα μπορεί να ακυρώσει και γνωρίζει ποιος το έκανε.

Η μετακίνηση συγκρίνει και ορίζει, ώστε δύο tablets στον ίδιο φούρνο που πατούν την ίδια κάρτα να λαμβάνουν μία επιτυχία και ένα 409 αντί δύο μεταβάσεων από μία κατάσταση.

• 200
• 400
• 404
• 409
• 429

• order:write

Ανακαλέστε τον σύνδεσμο πάγκου και εκδώστε νέο.

Ιδιοκτήτης ή διαχειριστής, από την κονσόλα — όχι από το tablet. Ο παλιός σύνδεσμος σταματά αμέσως με την οριστικοποίηση, όπως σημαίνει «ανακλητός» στο σχόλιο σχήματος, άρα το tablet πρέπει να ανοίξει ξανά με τον νέο.

Το νέο κλειδί επιστρέφεται μία φορά. Είναι URL και όχι μυστικό για κατακερματισμό, αλλά κονσόλα που το επανεμφανίζει σε κάθε φόρτωση θα το άφηνε σε κάθε στιγμιότυπο της καρτέλας Παραγγελιών.

• 200
• 400
• 401
• 403
• 404
• 429

• δεν χρειάζεται κλειδί

Η ενεργή ροή του πίνακα — μία ειδοποίηση ανά αλλαγή, ποτέ παραγγελία.

Ροή συμβάντων διακομιστή που κρατά ανοικτή το tablet ώστε όλα τα tablets στον φούρνο να ανανεώνονται εντός ενός καρέ. Εξουσιοδοτείται από τον σύνδεσμο πάγκου, όχι σύνδεση ατόμου: το κλειδί πρέπει να προσδιορίζεται και να ανήκει στο shop_id. Βρίσκεται κάτω από /v1/shop/**, οπότε η άδεια πολλαπλών προελεύσεων του δημόσιου ιστοτόπου ισχύει αμετάβλητη.

Το κλειδί είναι παράμετρος ερωτήματος επειδή ένα EventSource δεν στέλνει κεφαλίδα. Το API δεν καταγράφει τη συμβολοσειρά ερωτήματος και η οθόνη καταστήματος κρατά το κλειδί μόνο στο τμήμα κατακερματισμού του URL με referrer: no-referrer.

Τα συμβάντα είναι ειδοποιήσεις, όχι δεδομένα. customer_order και snapshot, καθένα με data: {} και UUID v7 id που μπορεί να παρουσιάσει επανασύνδεση ως Last-Event-ID· δεν αναμεταδίδεται τίποτα άλλο στη ροή καταστήματος. Το tablet ξαναδιαβάζει getShopBoard σε καθένα — τη μοναδική επιφάνεια ανάγνωσης του συνδέσμου πάγκου — ώστε κανένα καρέ να μην περιέχει στοιχεία καλούντος. Καρέ σχολίου κάθε 15 δευτερόλεπτα αποτρέπει το κλείσιμο από αδρανείς διαμεσολαβητές.

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

• 200
• 401

• order:write

Οι χρόνοι αναμονής παράδοσης και παραλαβής του καταστήματος.

Ιδιοκτήτης ή διαχειριστής, από την κονσόλα.

• 200
• 401
• 403
• 404
• 429

• order:write

Ορίστε τους χρόνους αναμονής παράδοσης και παραλαβής.

Ιδιοκτήτης ή διαχειριστής, από την κονσόλα. Ο φωνητικός βοηθός λέει τον νέο χρόνο από την επόμενη συνομιλία· υπάρχουσες παραγγελίες κρατούν τον δικό τους.

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 429

• conversation:read

Ενεργές συνομιλίες ενός φωνητικού βοηθού.

Συμβάντα: conversation.started, conversation.updated, conversation.ended, channel_unit.changed.

• 200
• 401
• 403
• 404

• agent:read

Πρόοδος δημιουργίας για μία εργασία δημιουργίας.

Συμβάντα: build.step, build.progress, build.check, build.succeeded, build.failed.

build.check ανακοινώνει ολοκληρωμένο έλεγχο εγγράφου μόνο με τον κύκλο και το αποτέλεσμα. Διαβάστε GET /v1/builds/{build_job_id} για την τρέχουσα αποθηκευμένη κατάσταση.

Κάθε καρέ περιέχει id που είναι δείκτης UUID v7· επανασύνδεση μπορεί να το παρουσιάσει ως Last-Event-ID. Καρέ σχολίου κάθε 15 δευτερόλεπτα αποτρέπει κλείσιμο από αδρανείς διαμεσολαβητές. Αν ο διακομιστής δεν προλαβαίνει αργό καταναλωτή, εκπέμπει event: resync και κλείνει αντί να απορρίπτει συμβάντα, επειδή ενεργή προβολή που έχασε σιωπηρά συμβάντα δίνει ψευδή εικόνα.

• 200
• 401
• 403
• 404

• conversation:read

Η τρέχουσα απομαγνητοφώνηση μίας συνομιλίας.

Συμβάντα: turn.partial, turn.final, conversation.event, customer_order_payment.

customer_order_payment (plan-005 OP-37, design §18.14.3) είναι το στοιχείο πληρωμής του δοκιμαστικού πάνελ περιηγητή: κατάσταση συνδέσμου πληρωμής για παραγγελία αυτής της συνομιλίας (ποσό, λήξη, σύνδεσμος και ένδειξη δοκιμής), αποστελλόμενη ξανά σε κάθε αλλαγή. Οι οθόνες Παραγγελιών και ο πίνακας καταστήματος κρατούν το δικό τους customer_order συμβάν.

• 200
• 401
• 403
• 404

• order:read

Τα συμβάντα παραγγελιών καταστήματος, για συνδεδεμένο αναγνώστη με order:read (η κονσόλα).

Συμβάντα: snapshot, customer_order, shop_customer, coupon. Μόνο συνδεδεμένοι αναγνώστες (order:read). Το δημόσιο tablet πάγκου — η οθόνη καταστήματος — δεν χρησιμοποιεί αυτή τη ροή: ο ενεργός πίνακάς του είναι streamShopCustomerOrderBoard (GET /v1/shop/{shop_id}/order-stream?counter_access_key=…, plan-003 RC-72), με εξουσιοδότηση του κλειδιού πρόσβασης πάγκου.

• 200
• 401
• 403
• 404

• conversation:read

Όλα όσα συμβαίνουν σε έναν χώρο εργασίας.

Συμβάντα: conversation.started, conversation_flag.raised, notification.created, billing.alert.

• 200
• 401
• 403
• 404

• δεν χρειάζεται κλειδί

Οι οργανισμοί στους οποίους μπορεί να εισέλθει το συνδεδεμένο άτομο.

Plan-014 B1 (design §27.9.2). Κάθε οργανισμός όπου το άτομο έχει ρόλο οργανισμού ή συμμετοχή χώρου, με τον ρόλο και τους χώρους που μπορεί να ανοίξει (enterable είναι false για μη ενεργό χώρο). Διαβάζεται μέσω account_access_for_person (migration 0078)· ποτέ δεν παρατίθενται οργανισμοί άλλου ατόμου. Συνήθης καλών είναι auth_session χωρίς πεδίο ή μόνο με λογαριασμό.

• 200
• 401
• 429

• μόνο συνδεδεμένο άτομο

Το προφίλ οργανισμού.

Plan-014 B2. Όνομα, κατάσταση, χώρα, προεπιλεγμένη γλώσσα, ισχύουσα ζώνη ώρας χρέωσης και αλλαγή που περιμένει τον μήνα χρέωσης, και το revision που πρέπει να κατονομάσει η επόμενη αλλαγή (ETag το περιέχει επίσης) — μαζί με τα στοιχεία Επισκόπησης: μεταδεδομένα κάθε χώρου (account.workspace_metadata.read· ποτέ το περιεχόμενό του), πόσοι έχουν πρόσβαση, πόσοι έχουν ρόλο οργανισμού και αριθμός υπολοίπων (null εκτός αν ο καλών έχει account.finance.read). Δυνατότητα account.profile.read — κάθε ρόλος οργανισμού. Απορρίψεις: 403 capability_missing (μέλος χώρου χωρίς ρόλο οργανισμού), 404 not_found, τα 401, 429 rate_limited.

• 200
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Μετονομάστε οργανισμό ή αλλάξτε προεπιλεγμένη γλώσσα.

Plan-014 B2. If-Match: "<revision>" απαιτείται (409 revision_stale όταν ο οργανισμός άλλαξε μετά την ανάγνωση). Δυνατότητα account.profile.write — Ιδιοκτήτης, Διαχειριστής. Η ζώνη ώρας χρέωσης αλλάζει από scheduleAccountBillingTimezone, ποτέ εδώ. Καταγράφεται (account.profile_changed).

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Επιτρέψτε σύνδεση κονσόλας από περιοχή δικτύου.

Plan-014 C2 (FR12-SEC-04/06). Μόνο σύνδεση κονσόλας: κλειδιά API έχουν δικούς τους κανόνες δικτύου και κλήσεις και webhooks δεν επηρεάζονται. Περιοχή με bits υπολογιστή κανονικοποιείται στο δίκτυό της. Η αλλαγή αυξάνει την αναθεώρηση πολιτικής (κάθε auth_session επανελέγχεται στο επόμενο αίτημα) και ισχύει από το επόμενο αίτημα· αλλαγή που θα άφηνε τη διεύθυνση αυτού του περιηγητή όπως τη βλέπει το WeTalk εκτός κάθε περιοχής απορρίπτεται με 409 sign_in_policy_lockout· ενεργό διπλότυπο είναι 409 conflict. Δυνατότητα account.sign_in_policy.write με πρόσφατη πρόσθετη ταυτοποίηση. Καταγράφεται (allowed_network.added).

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Αφαιρέστε επιτρεπόμενη περιοχή δικτύου.

Plan-014 C2. Αυξάνει αναθεώρηση πολιτικής. Απορρίπτεται με 409 sign_in_policy_lockout όταν οι περιοχές που απομένουν δεν περιέχουν τη διεύθυνση αυτού του περιηγητή όπως τη βλέπει το WeTalk. Δυνατότητα account.sign_in_policy.write με πρόσφατη πρόσθετη ταυτοποίηση. Καταγράφεται (allowed_network.removed).

• 200
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Το αρχείο ελέγχου οργανισμού, από τη νεότερη εγγραφή.

Plan-014 C4b (FR12-SEC-08). Κάθε εγγραφή οργανισμού — των χώρων, του ίδιου του οργανισμού και των υπολοίπων του — από τους τελευταίους retention_month ημερολογιακούς μήνες, από τη νεότερη, με τα φίλτρα αρχείου χώρου συν scope και workspace_id. account.audit.read (Ιδιοκτήτης, Διαχειριστής) διαβάζει όλες τις εγγραφές· account.audit.financial_read μόνο (Οικονομικά) διαβάζει εγγραφές που ο κατάλογος ορίζει ως οικονομικές, στη σελίδα, στο πλήθος και στην εξαγωγή, και η απάντηση το δηλώνει (finance_only). Διατίθεται με ανοικτό μόνο οργανισμό. Ποτέ κλειδί API.

• 200
• 400
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο
• βαρύ

Εξαγάγετε το αρχείο ελέγχου οργανισμού ως CSV.

Plan-014 C4b. Εξαγωγή με όρια και καταγραφή όπως στον χώρο: πρώτα το πλήθος (422 export_too_large πάνω από WETALK_API_EXPORT_MAX_ROW, κατονομάζοντάς το), μετά audit_entry.exported γραμμένο πριν διαβαστούν οι εγγραφές, μετά αρχείο και σύνδεσμος μικρής διάρκειας. Τα Οικονομικά εξάγουν μόνο οικονομικές εγγραφές. Μέχρι ο οργανισμός να έχει δική του θέση αρχείου, αυτό αποθηκεύεται στον ανοικτό χώρο του ατόμου, άρα σύνδεση με μόνο οργανισμό απορρίπτεται με 409 scope_required.

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 422
• 429

• μόνο συνδεδεμένο άτομο

Αλλάξτε ζώνη ώρας χρέωσης από τον επόμενο μήνα χρέωσης.

Plan-014 B2 (design §27.8.5· owner input 12). Η αλλαγή ισχύει από την αρχή του επόμενου μήνα χρέωσης στην τρέχουσα ζώνη (effective_from) και ποτέ δεν ξαναγράφει ανοικτή περίοδο· δήλωση της ισχύουσας ζώνης αποσύρει εκκρεμή αλλαγή. If-Match: "<revision>" απαιτείται. Δυνατότητα account.finance.manage — Ιδιοκτήτης, Διαχειριστής, Οικονομικά. Απορρίψεις: 400 time_zone_invalid, 409 revision_stale, 403 capability_missing. Με καταγραφή ελέγχου (account.billing_timezone_scheduled).

Δέχεται σώμα αιτήματος JSON.

• 200
• 400
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Τι εμποδίζει το κλείσιμο οργανισμού, τι επιστρέφεται και τι διατηρείται.

Η ανάγνωση του Ιδιοκτήτη (account.close· αρκεί παλαιότερη πρόσθετη ταυτοποίηση για ανάγνωση). blocker[] παραθέτει κάθε τρέχον εμπόδιο κλεισίματος — συνομιλία σε εξέλιξη, ανεξόφλητη κατάσταση, αρνητικό υπόλοιπο, πληρωμή σε επεξεργασία, υποχρέωση απόδοσης — με την αντιμετώπισή του. refundable[] είναι η αχρησιμοποίητη ΑΓΟΡΑΣΜΕΝΗ πίστωση κάθε υπολοίπου (δοκιμαστική και προωθητική πίστωση δεν επιστρέφονται και χρησιμοποιούνται πρώτες). retention δηλώνει τα μεγέθη του ιδιοκτήτη: το περιεχόμενο διαγράφεται content_purge_after_day ημέρες μετά τη λήξη πρόσβασης (περίοδος χάριτος αναίρεσης), τα οικονομικά αρχεία διατηρούνται financial_keep_year ημερολογιακά έτη μετά το κλείσιμο. latest_closure είναι το πιο πρόσφατο κλείσιμο, ανεξαρτήτως κατάστασης.

• 200
• 401
• 403
• 404

• μόνο συνδεδεμένο άτομο

Ξεκινήστε κλείσιμο οργανισμού (ασύγχρονα).

Μόνο Ιδιοκτήτης (account.close), με πρόσφατη πρόσθετη ταυτοποίηση (step_up_required διαφορετικά), ποτέ χειριστής WeTalk που ενεργεί ως μέλος. Τα εμπόδια αποθηκεύονται και απαντούν με 409 closure_blocked με error.detail.blocker[]. Διαφορετικά ο οργανισμός γίνεται closing — χωρίς νέες συνομιλίες ή αγορές — και το κλείσιμο ακολουθεί παύση → απόφαση επιστροφών → λήξη προγράμματος και όρων μεταπληρωμής → ανάκληση πρόσβασης → χάρη → διαγραφή περιεχομένου → κλειστός· ακολουθήστε status_url. refund_choice είναι refund (ένα αίτημα επιστροφής ανά υπόλοιπο, καθένα εγκεκριμένο από χειριστή οικονομικών), waive (με refund_waiver, τα λόγια του ίδιου του ιδιοκτήτη) ή none (όταν δεν υπάρχει αχρησιμοποίητη αγορασμένη πίστωση). Το κλείσιμο αυτού του οργανισμού ποτέ δεν αφαιρεί συμμετοχές του ατόμου σε άλλους.

Δέχεται σώμα αιτήματος JSON.

• 200
• 202
• 400
• 401
• 403
• 404
• 409

• μόνο συνδεδεμένο άτομο

Η μόνιμη κατάσταση κλεισίματος.

• 200
• 401
• 403
• 404

• δεν χρειάζεται κλειδί

Αναιρέστε κλείσιμο εντός της περιόδου χάριτος (ο πρώην Ιδιοκτήτης).

Σημείο εισόδου ταυτότητας: μετά τη λήξη πρόσβασης ο πρώην Ιδιοκτήτης δεν έχει συμμετοχή, άρα το cookie auth_session παρουσιάζεται στην ίδια τη διαδρομή (με X-WeTalk-Csrf). Μόνο το άτομο που ζήτησε κλείσιμο το αναιρεί, μόνο εντός χάριτος (409 operation_state_conflict διαφορετικά)· κλείσιμο άλλου ατόμου είναι 404. Ο οργανισμός επιστρέφει στην προηγούμενη κατάσταση με τον πρώην Ιδιοκτήτη ως Ιδιοκτήτη του και των χώρων που αρχειοθετήθηκαν· δεν επιστρέφει άλλη πρόσβαση και κλειδιά, αριθμοί και καμπάνιες παραμένουν κλειστά.

• 200
• 401
• 403
• 404
• 409

• μόνο συνδεδεμένο άτομο

Αποσύρετε κλείσιμο πριν αρχίσει η ανάκληση πρόσβασης.

Επιτρέπεται όσο το κλείσιμο παύει λειτουργία, επιστρέφει χρήματα ή λήγει πρόγραμμα (409 operation_state_conflict μετά). Ο οργανισμός επιστρέφει στην προηγούμενη κατάσταση· αιτήματα επιστροφής χωρίς απόφαση ακυρώνονται. Καμπάνιες και αυτόματες ανανεώσεις παραμένουν κλειστές μέχρι να επανεκκινηθούν.

• 200
• 401
• 403
• 404
• 409

• μόνο συνδεδεμένο άτομο

Οι προσκλήσεις οργανισμού σε κάθε κατάσταση, από τη νεότερη.

Plan-014 B2 (FR12-TEAM-05). Εκκρεμείς, ληγμένες, ανακληθείσες, αντικατασταθείσες και αποδεκτές προσκλήσεις — η κονσόλα τις εμφανίζει χωριστά από τα μέλη. Δυνατότητα account_membership.read.

• 200
• 401
• 403
• 404
• 429

• μόνο συνδεδεμένο άτομο

Προσκαλέστε κάποιον στον οργανισμό.

Plan-014 B2 (FR12-TEAM-01/02). Προσφέρει ρόλο οργανισμού (Διαχειριστής, Οικονομικά ή Αναγνώστης — ποτέ Ιδιοκτήτης, 403 owner_change_forbidden), κατονομασμένους ρόλους χώρων σε ενεργούς χώρους αυτού του οργανισμού ή και τα δύο· η προσφορά παγώνει — μεταγενέστερος χώρος δεν περιλαμβάνεται ποτέ. Μόνο Ιδιοκτήτης οργανισμού προσφέρει ρόλο Ιδιοκτήτη χώρου. Ο σύνδεσμος ισχύει για τη ρυθμισμένη διάρκεια (7 ημέρες). Μία εκκρεμής πρόσκληση ανά διεύθυνση (409 conflict)· άτομο που έχει ήδη ρόλο οργανισμού απορρίπτεται αντί δεύτερης πρόσκλησης. Δυνατότητα account_membership.invite — Ιδιοκτήτης, Διαχειριστής. delivery δηλώνει αν η πρόσκληση στάλθηκε με email ή — όσο δεν έχει συνδεθεί αποστολέας email — το invitation_path επιστρέφεται ΜΙΑ ΦΟΡΑ για προώθηση από τον προσκαλούντα. Καταγράφεται (account_invitation.sent).

Δέχεται σώμα αιτήματος JSON.

• 201
• 400
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Στείλτε ξανά πρόσκληση με νέο σύνδεσμο· ο παλιός παύει να λειτουργεί.

Plan-014 B2 (FR12-TEAM-03). Εκκρεμής ή ληγμένη πρόσκληση αντικαθίσταται και εκδίδεται νέα με την ίδια παγωμένη προσφορά στην ίδια συναλλαγή βάσης δεδομένων. Αποδεκτή, ανακληθείσα ή αντικατασταθείσα είναι 409 conflict. Δυνατότητα account_membership.invite. Με καταγραφή ελέγχου (account_invitation.resent).

• 200
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Ανακαλέστε εκκρεμή πρόσκληση.

Plan-014 B2 (FR12-TEAM-03). Μόνο εκκρεμής πρόσκληση· οτιδήποτε άλλο είναι 409 conflict. Δυνατότητα account_membership.invite. Με καταγραφή ελέγχου (account_invitation.revoked).

• 200
• 401
• 403
• 404
• 409
• 429

• μόνο συνδεδεμένο άτομο

Όλοι με πρόσβαση στον οργανισμό, με τους ρόλους τους.

Plan-014 B2 (FR12-TEAM-01). Μία γραμμή ανά άτομο με ρόλο οργανισμού, χώρου ή και τα δύο: ο ρόλος οργανισμού και το revision, κάθε ρόλος χώρου με το όνομά του, ο τρόπος σύνδεσης (οι υπάρχοντες τύποι — ποτέ διαπιστευτήριο) και η τελευταία παρουσία εδώ. Δυνατότητα account_membership.read — Ιδιοκτήτης, Διαχειριστής.

• 200
• 401
• 403
• 404
• 429