Το ThunderPhone v3 είναι πλέον διαθέσιμο.Ξεκινήστε μόνοι σας, από 2¢/λεπτό.Διαβάστε την ανακοίνωση

Getting Started

Βασικές έννοιες

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

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

Η πλαϊνή γραμμή της παλιάς προβολής του πίνακα ελέγχου αντικατοπτρίζει αυτήν τη δομή:


Οργανισμοί

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

Το κλειδί API sk_live_ που δημιουργείτε στις Ενσωματώσεις → Κλειδιά API (μενού οργανισμού· Οργανισμός → Κλειδιά στην παλιά προβολή) είναι συνδεδεμένο με έναν οργανισμό. Αυτή η σύνδεση κάνει το REST API τόσο απλό: δεν προσθέτετε ποτέ αναγνωριστικό οργανισμού στις διαδρομές URL, επειδή το κλειδί σας τον ταυτοποιεί ήδη.

Στον πίνακα ελέγχου: ο επιλογέας οργανισμού (υποσέλιδο πλαϊνής γραμμής) και οι ρυθμίσεις Οργανισμός — καρτέλες για Ο λογαριασμός μου, Γενικά, Κλειδιά, Ειδοποιήσεις, Ρυθμίσεις χρέωσης και Ιστορικό χρέωσης. Δείτε την αναφορά ρυθμίσεων οργανισμού.

Στο API: /v1/orgs, /v1/developer/api-keys.


Πράκτορες

Ένας πράκτορας είναι η διαμόρφωση AI που εκτελεί μια κλήση. Περιλαμβάνει:

  • Ένα prompt που καθορίζει τι λέει ο πράκτορας και πώς συμπεριφέρεται — συμπεριλαμβανομένων ενεργειών κλήσης όπως μεταφορές, πατήματα πλήκτρων και τερματισμοί κλήσης, οι οποίες είναι απλές γραμμές του prompt και όχι ξεχωριστή διαμόρφωση.
  • Οι ρυθμίσεις του: νοημοσύνη (Core ή Pro), ακρόαση (Lite, Standard, Plus ή Max) και ταχύτητα απόκρισης, που εξισορροπούν το κόστος, την ταχύτητα και την ακρίβεια.
  • Μια φωνή μαζί με μια κύρια γλώσσα και προαιρετικές πρόσθετες γλώσσες — ο πράκτορας αλλάζει αυτόματα όταν ο καλών αλλάζει γλώσσα. Δείτε τις Υποστηριζόμενες γλώσσες.
  • Συνδεδεμένες δυνατότητες: συνδεδεμένες εφαρμογές, συνδέσεις API, βάσεις γνώσης, διακομιστές MCP και ενσωματωμένα εργαλεία συναρτήσεων.
  • Επιλογές συμπεριφοράς: σειρά ομιλίας, λειτουργία επιβεβαίωσης, μουσική υπόκρουση, χρονικό όριο αναμονής.

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

Στον πίνακα ελέγχου: Φωνητικοί πράκτορες → ο δημιουργός πρακτόρων (/dashboard/agents). Δείτε το Δημιουργήστε τον πρώτο σας φωνητικό πράκτορα.

Στο API: /v1/agents — CRUD, αντιγραφή, μεταφορά, ιστορικό εκδόσεων και βοηθήματα prompt.


Φωνές

Η βιβλιοθήκη φωνών περιέχει τις φωνές που μπορεί να χρησιμοποιεί ένας πράκτορας, τα αναπαραγώγιμα δείγματά τους, τις συμβατές γλώσσες, τις κατηγοριοποιήσεις φύλου και προφοράς, καθώς και ποιες φωνές είναι premium. Ένα επί πληρωμή εργαλείο δειγματοληψίας μπορεί να συνθέσει τη δική σας φράση 1–500 χαρακτήρων πριν επιλέξετε.

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

Στον πίνακα ελέγχου: Φωνές (/dashboard/voices). Δείτε Βιβλιοθήκη φωνών και προσαρμοσμένες φωνές.

Στο API: /v1/voices, δείγματα φωνής και προσαρμοσμένες φωνές.


Αριθμοί τηλεφώνου

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

  • Αριθμοί ThunderPhone — πραγματικοί αριθμοί ΗΠΑ που παρέχονται από το απόθεμα του ThunderPhone και ενεργοποιούνται σε δευτερόλεπτα, $1/μήνα; τα λεπτά κλήσεών τους χρεώνονται ως τηλεφωνική γραμμή. Αρχικά υποστηρίζουν μόνο εισερχόμενες κλήσεις. Ένας διαχειριστής οργανισμού μπορεί να ζητήσει εξερχόμενες κλήσεις από τη σελίδα Αριθμοί τηλεφώνου· το ThunderPhone εξετάζει κάθε αίτημα χειροκίνητα και οι εγκεκριμένοι αριθμοί μπορούν να πραγματοποιούν κλήσεις και να εκτελούν καμπάνιες. Ένας οργανισμός μπορεί να έχει 25 από προεπιλογή.
  • Αριθμοί VoIP — προστίθενται από τον δικό σας πάροχο μέσω μιας σύνδεσης VoIP. Το Twilio και το Telnyx συνδέονται απευθείας με ένα κλειδί API (το Telnyx διαθέτει επίσης καθοδηγούμενη ρύθμιση νέου λογαριασμού)· το SignalWire, το Vonage, το Plivo και κάθε άλλο SIP trunk συνδέονται μέσω ρύθμισης SIP, μιας χειροκίνητης διαμόρφωσης SIP. Μετά την εισαγωγή και την επαλήθευσή τους, οι αριθμοί VoIP υποστηρίζουν εισερχόμενες και εξερχόμενες κλήσεις.

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

Στον πίνακα ελέγχου: Αριθμοί τηλεφώνου (/dashboard/phone-numbers). Δείτε Απόκτηση αριθμού τηλεφώνου.

Στο API: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels.


Κλήσεις

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

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

Στον πίνακα ελέγχου: Ιστορικό κλήσεων (/dashboard/call-history) για το αρχείο και τις λεπτομέρειες ανά κλήση· Ζωντανές για κλήσεις σε εξέλιξη. Δείτε Έλεγχος, ακρόαση και καθοδήγηση των κλήσεών σας.

Στο API: /v1/calls — λίστα, μεταγραφή, ιστορικό, ήχος, αξιολόγηση, εξαγωγή· /v1/issue-reports.


Πύλες πελατών

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

Στον πίνακα ελέγχου: Πύλες πελατών (/dashboard/client-portals). Δείτε Πύλες πελατών.

Στο API: /v1/client-portals για το περιβάλλον διαχείρισης διαχειριστών.


Γραφικά στοιχεία ιστού

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

Τα κλειδιά λειτουργούν σε μία από δύο καταστάσεις: agent (στατικά συνδεδεμένο με έναν πράκτορα) ή webhook (ο διακομιστής σας επιλέγει τη διαμόρφωση ανά επισκέπτη — δείτε Δυναμική διαμόρφωση ανά κλήση). Οι συνεδρίες γραφικών στοιχείων διέρχονται από την ίδια υποδομή κλήσεων με τις τηλεφωνικές κλήσεις.

Στον πίνακα ελέγχου: Γραφικά στοιχεία ιστού (/dashboard/web-widgets) — δημιουργήστε γραφικά στοιχεία, ορίστε την κατάσταση και τον πράκτορα, διαχειριστείτε τους επιτρεπόμενους τομείς και αντιγράψτε το απόσπασμα ενσωμάτωσης. Δείτε Δημιουργία γραφικού στοιχείου ιστού.

Στο API: /v1/publishable-key, /v1/mic-session και η τεκμηρίωση του SDK γραφικών στοιχείων.


Βάσεις γνώσης

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

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

Στον πίνακα ελέγχου: Γνώση (/dashboard/knowledge) για τη βιβλιοθήκη εγγράφων· η ενότητα Γνώση του εργαλείου δημιουργίας για να συνδέσετε μία με έναν πράκτορα. Δείτε Δώστε στον πράκτορά σας μια βάση γνώσης.


Συνδέσεις

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

  • Εφαρμογές (/dashboard/app-connections) — συνδέσεις με HubSpot, Salesforce, Google Calendar, Google Sheets και Cal.com. Συνδεθείτε μία φορά και, στη συνέχεια, ενεργοποιήστε εργαλεία ανά λειτουργία (δημιουργία ή ενημέρωση μιας επαφής HubSpot, κράτηση μιας χρονικής θέσης στο Cal.com…) για οποιονδήποτε πράκτορα. Δείτε Σύνδεση εφαρμογών.
  • APIs (/dashboard/api-connections) — μετατρέψτε οποιοδήποτε HTTP API σε ενέργεια πράκτορα. Επικολλήστε μια εντολή cURL και ο οδηγός AI συντάσσει τον ορισμό του εργαλείου ή δημιουργήστε τον μη αυτόματα· ένα κουμπί Δοκιμαστικό αίτημα εκτελεί μια κλήση δοκιμαστικού περιβάλλοντος πριν από τη δημοσίευση. Δείτε Συνδέσεις API — η διεπαφή του πίνακα ελέγχου για το /v1/integrations.
  • MCP (/dashboard/mcp-connections) — προσθέστε έναν διακομιστή Model Context Protocol μέσω URL και επιτρέψτε στον πράκτορα να χρησιμοποιεί τα εργαλεία που εκθέτει. Δείτε Προσθήκη διακομιστή MCP.
  • VoIP (/dashboard/voip-connections) — διαπιστευτήρια παρόχου για χρήση των δικών σας τηλεφωνικών αριθμών. Δείτε Σύνδεση παρόχου VoIP.

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

Στο API: /v1/integrations, /v1/mcp-servers και /v1/voip-connections· δείτε επίσης Δημιουργία ενσωμάτωσης εργαλείου.


Καμπάνιες

Μια καμπάνια πραγματοποιεί εξερχόμενες κλήσεις σε μεγάλη κλίμακα: μεταφορτώστε ένα CSV με επαφές, επιλέξτε τον πράκτορα και τον αριθμό προέλευσης και ορίστε το χρονικό παράθυρο κλήσεων (ημέρες και ώρες, με επίγνωση ζώνης ώρας), την ταυτόχρονη εκτέλεση και την πολιτική επανάληψης (μέγιστος αριθμός προσπαθειών και ποια αποτελέσματα — καμία απάντηση, τηλεφωνητής, αποτυχία — θα επαναληφθούν). Η καμπάνια επεξεργάζεται τη λίστα και καταγράφει κάθε κλήση στο Ιστορικό κλήσεων.

Στον πίνακα ελέγχου: Καμπάνιες (/dashboard/campaigns). Δείτε Εκτέλεση καμπάνιας εξερχόμενων κλήσεων.

Για μεμονωμένες προγραμματιστικές κλήσεις: το API εξερχόμενων κλήσεων.

Ζωντανή παρακολούθηση

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

Στον πίνακα ελέγχου: Ζωντανά (/dashboard/live). Δείτε Παρακολούθηση και επίβλεψη ζωντανών κλήσεων.


Προσομοιώσεις

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

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

Στον πίνακα ελέγχου: Προσομοιώσεις (/dashboard/simulations), καθώς και το κουμπί Προσομοίωση μέσα στο εργαλείο δημιουργίας πρακτόρων. Δείτε Προσομοίωση κλήσης.

Στο API: /v1/test-calls και το πρόγραμμα εκτέλεσης σουιτών — δείτε Δοκιμή ενός πράκτορα από άκρο σε άκρο.


Σύνολα επικύρωσης

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

Στον πίνακα ελέγχου: Σύνολα επικύρωσης (/dashboard/validation) για το σύνολο δεδομένων του οργανισμού και η καρτέλα Επικύρωση του εργαλείου δημιουργίας πρακτόρων για εκτελέσεις. Δείτε Σύνολα επικύρωσης.

Στο API: /v1/validation-sets και τα τελικά σημεία επανάληψης πράκτορα/παραδείγματος στην ίδια σελίδα αναφοράς.


Πειράματα

Ένα πείραμα εκτελεί δοκιμές A/B σε διαμορφώσεις πρακτόρων με ζωντανή κίνηση: ορίστε παραλλαγές (διαφορετικά prompts, μηχανές ή ρυθμίσεις), κατανείμετε την κίνηση μεταξύ τους και συγκρίνετε αποτελέσματα ανά παραλλαγή. Χρησιμοποιήστε το αντί να υλοποιείτε χειροκίνητα λογική κατανομής σε ένα webhook.

Στον πίνακα ελέγχου: Πειράματα (/dashboard/experiments) και η καρτέλα A/B στο εργαλείο δημιουργίας πρακτόρων. Δείτε Πειράματα (δοκιμές A/B).


Ζητήματα

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

Στον πίνακα ελέγχου: Ζητήματα (/dashboard/issues), καθώς και επισήμανση ανά κλήση στο Ιστορικό κλήσεων. Δείτε Διαλογή ζητημάτων.

Στο API: /v1/issue-reports.


Αναφορές

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

Στον πίνακα ελέγχου: Αναφορές (/dashboard/reports). Δείτε Αναφορές.


Παρατηρησιμότητα

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

Στον πίνακα ελέγχου: Παρατηρησιμότητα (/dashboard/observability). Δείτε Παρατηρησιμότητα.


Ειδοποιήσεις

Ένας κανόνας ειδοποίησης παρακολουθεί μια μέτρηση (ποσοστό επιτυχίας, ποσοστό αποτυχίας, μέση βαθμολογία, όγκο κλήσεων, παλινδρομήσεις σουιτών) σε ένα χρονικό παράθυρο και ενεργοποιείται όταν υπερβαίνει το όριό σας. Οι ειδοποιήσεις αποστέλλονται μέσω email και Slack και ενεργοποιούν ένα συμβάν alert.triggered στα τελικά σημεία webhook.

Στον πίνακα ελέγχου: Οργανισμός → Ειδοποιήσεις. Δείτε Ειδοποιήσεις.


Διαδικτυακές ειδοποιήσεις

Το ThunderPhone στέλνει διαδικτυακές ειδοποιήσεις HTTP POST στον διακομιστή σας όταν συμβαίνουν γεγονότα κατά τη διάρκεια και μετά από μια κλήση. Δύο μοντέλα παράδοσης:

  • Τελικά σημεία διαδικτυακών ειδοποιήσεων (συνιστάται): διαχειριστείτε πολλές διευθύνσεις URL στο /v1/developer/webhook-endpoints με μυστικά ανά τελικό σημείο και συνδρομές σε συμβάντα ανά τελικό σημείο.
  • Παρωχημένη διαδικτυακή ειδοποίηση μίας διεύθυνσης URL: μία διεύθυνση URL ανά οργανισμό. Διαχειρίζεται από το /v1/webhook ή στην ενότητα Οργανισμός → Γενικά. Διατηρείται για συμβατότητα με προηγούμενες εκδόσεις.

Τα συμβάντα χωρίζονται σε δύο κατηγορίες:

  • Συγχρονισμένα συμβάντα αναμένουν από τον διακομιστή σας να απαντήσει με διαμόρφωση που επηρεάζει την κλήση σε εξέλιξη — τα συμβάντα εισερχόμενης κλήσης (telephony.incoming / web.incoming). Μια τηλεφωνική κλήση αναμένει έως 13 δευτερόλεπτα, συμπεριλαμβανομένης μίας επανάληψης, και μια συνεδρία widget 10 δευτερόλεπτα. Δεν υπάρχει εφεδρικός πράκτορας: χωρίς χρησιμοποιήσιμη διαμόρφωση, η τηλεφωνική κλήση τερματίζεται και η συνεδρία widget αποτυγχάνει.
  • Μη συγχρονισμένα συμβάντα είναι ειδοποιήσεις αποστολής χωρίς αναμονή, με επαναλήψεις με εκθετική καθυστέρηση — δείτε σημασιολογία παράδοσης.

Κάθε αίτημα περιλαμβάνει μια χρονοσημασμένη υπογραφή HMAC-SHA256 στο X-ThunderPhone-Signature-V2, καθώς και την παλαιότερη υπογραφή μόνο για το σώμα X-ThunderPhone-Signature. Δείτε Επαλήθευση υπογραφής.


Εργαλεία συναρτήσεων

Ένα εργαλείο συνάρτησης είναι ένα τελικό σημείο HTTP που ο πράκτοράς σας μπορεί να καλέσει κατά τη διάρκεια της συνομιλίας. Δίνετε στο ThunderPhone ένα σχήμα συνάρτησης τύπου OpenAI μαζί με μια διεύθυνση URL τελικού σημείου· ο πράκτορας αποφασίζει πότε να το καλέσει και το ThunderPhone εκτελεί το υπογεγραμμένο αίτημα HTTP από τους διακομιστές του και επιστρέφει το αποτέλεσμα στον πράκτορα.

Οι πράκτορες περιλαμβάνουν επίσης ενσωματωμένες δυνατότητες κλήσης — μεταφορά της κλήσης, αποστολή εισόδου πληκτρολογίου (DTMF), τερματισμό της κλήσης, αναμονή σε κράτηση — τις οποίες ενεργοποιείτε με απλές γραμμές προτροπής αντί για ορισμούς εργαλείων.

Στον πίνακα ελέγχου: η ενότητα Συνδέσεις API του δημιουργού (δείτε Συνδέσεις).

Στο API: /v1/integrations και οι προδιαγραφές Εργαλείων συναρτήσεων.


Ομάδα και ρόλοι

Κάθε οργανισμός έχει μια λίστα μελών με δύο ρόλους: τα Μέλη δημιουργούν και διαχειρίζονται πράκτορες· οι Διαχειριστές διαχειρίζονται επίσης την ομάδα και τη χρέωση. Προσκαλέστε με email — οι προσκλήσεις λήγουν μετά από 7 ημέρες και μπορούν να ανακληθούν· το μενού ⋯ σε μια γραμμή μέλους αλλάζει ρόλους ή αφαιρεί κάποιον. Η ενιαία σύνδεση μπορεί να ρυθμιστεί για ολόκληρο τον οργανισμό — δείτε SSO.

Στον πίνακα ελέγχου: Οργανισμός → Γενικά. Δείτε Προσκαλέστε την ομάδα σας.

Στο API: /v1/members, /v1/invites.


Χρέωση

Το ThunderPhone είναι προπληρωμένο. Κάθε οργανισμός διατηρεί υπόλοιπο σε USD· κάθε κλήση χρεώνει το κόστος των επιμέρους στοιχείων της στις τιμές καταλόγου των παρόχων μας, συν μια χρέωση υποδομής και περιθώριο 17–25% (βλ. τιμολόγηση). Όταν το υπόλοιπο μηδενιστεί, οι εισερχόμενες κλήσεις απορρίπτονται και οι εξερχόμενες κλήσεις επιστρέφουν 402 Payment Required.

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

Στον πίνακα ελέγχου: Οργανισμός → Ρυθμίσεις χρέωσης και Ιστορικό χρεώσεων. Δείτε Προσθέστε χρήματα και ενεργοποιήστε την αυτόματη προσθήκη χρημάτων, καθώς και την πλήρη αναφορά τιμολόγησης.

Στο API: /v1/billing.


Ο ενσωματωμένος βοηθός

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


Συνδυάζοντάς τα όλα