Open in
ThunderPhone CLI
Συνδεθείτε, διαχειριστείτε φωνητικούς πράκτορες και κλήσεις, ρυθμίστε πελάτες MCP και δημιουργήστε σκελετούς έργων από το τερματικό.
Το CLI απαιτεί Node.js 18.18 ή νεότερη έκδοση. Εκτελέστε το με npx ή εγκαταστήστε το καθολικά:
npm install -g thunderphone
thunderphone --helpΣύνδεση
npx thunderphone login
thunderphone whoami --jsonΗ σύνδεση εμφανίζει έναν κωδικό επαλήθευσης, ανοίγει το πρόγραμμα περιήγησης και αναμένει εξουσιοδότηση.
Χρησιμοποιήστε το --no-browser σε μηχάνημα χωρίς γραφικό περιβάλλον και ανοίξτε το εμφανιζόμενο URL αλλού.
Η σύνδεση συσκευής απαιτεί την κυκλοφορία της ροής συσκευής OAuth του API. Ένα κλειδί API οργανισμού
στο THUNDERPHONE_API_KEY μπορεί επίσης να πιστοποιήσει εντολές και έχει προτεραιότητα
έναντι των αποθηκευμένων διαπιστευτηρίων σύνδεσης.
Τα διαπιστευτήρια αποθηκεύονται ανά προφίλ στο ~/.config/thunderphone/credentials.json
με δικαιώματα αρχείου 0600. Τα XDG_CONFIG_HOME και THUNDERPHONE_CONFIG_DIR παρακάμπτουν τον
κατάλογο. Τα διακριτικά πρόσβασης ανανεώνονται αυτόματα και τα εναλλασσόμενα διακριτικά ανανέωσης
αποθηκεύονται ατομικά. Τα διακριτικά δεν εμφανίζονται ποτέ από τη σύνδεση.
thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile workΤο THUNDERPHONE_PROFILE ορίζει το προεπιλεγμένο προφίλ. Η αποσύνδεση καταργεί τα τοπικά διαπιστευτήρια·
δεν ανακαλεί την εξουσιοδότηση του διακομιστή. Η αλλαγή ή επαναφορά του κωδικού πρόσβασής σας ή
η αλλαγή του email του λογαριασμού σας την ανακαλεί· εκτελέστε ξανά το thunderphone login. Το προεπιλεγμένο API είναι το https://api.thunderphone.com.
Χρησιμοποιήστε το --api-base-url ή το THUNDERPHONE_API_BASE_URL για άλλο API. Ένα διακριτικό προφίλ
δεν μπορεί να σταλεί σε διαφορετικό ρυθμισμένο URL API· συνδεθείτε σε εκείνο το URL με ξεχωριστό προφίλ.
Εντολές
Κάθε εντολή δέχεται --json. Τα επιτυχή δεδομένα μεταφέρονται στο stdout· τα σφάλματα στο stderr
με μη μηδενικό κωδικό εξόδου. Χωρίς --json, η έξοδος είναι ένας συμπαγής πίνακας ή λίστα πεδίων.
Το JSON διατηρεί τη δομή απόκρισης του API, με τα πεδία διαπιστευτηρίων αποκρυμμένα. Η εξυπηρέτηση MCP
δεσμεύει το stdout για το πρωτόκολλο MCP.
| Εντολή | Σκοπός |
|---|---|
login [--no-browser] [--scope "scopes"] | Εξουσιοδότηση μέσω κωδικού συσκευής |
logout, whoami | Αφαίρεση τοπικών διαπιστευτηρίων· εμφάνιση προσβάσιμων οργανισμών |
agents list, agents get ID | Ανάγνωση πρακτόρων |
agents create --file agent.json | Δημιουργία πράκτορα |
agents update ID --file agent.json | Αποθήκευση προσχεδίου πράκτορα |
agents deploy ID, agents delete ID | Ανάπτυξη προσχεδίου· διαγραφή πράκτορα |
numbers list | Ανάγνωση τηλεφωνικών αριθμών |
numbers provision --country US --area-code 415 | Παροχή εισερχόμενου αριθμού στις ΗΠΑ |
numbers assign NUMBER_ID --agent ID | Ανάθεση εισερχόμενου πράκτορα |
sms send TO --from FROM --body TEXT --idempotency-key KEY | Αποστολή SMS μέσω αριθμού παρόχου συνδεδεμένου από πελάτη με ασφαλή επανάληψη |
sms list [--limit N], sms get UUID | Εμφάνιση ή επιθεώρηση εγγραφών SMS |
call TO --agent ID --from FROM [--wait] | Πραγματοποίηση εξερχόμενης κλήσης· προαιρετική αναμονή για την απομαγνητοφώνησή της |
calls list [--limit N] [--agent ID] | Εμφάνιση κλήσεων (όριο 1–200) |
calls get ID, calls transcript ID | Ανάγνωση μίας κλήσης ή της απομαγνητοφώνησής της |
test run AGENT_ID [--scenario ID] --consent-to-charge | Εκτέλεση χρεώσιμων αποθηκευμένων σεναρίων μέσω του καναλιού ιστού |
test status RUN_ID [--agent ID] | Επιθεώρηση παρτίδας, με λεπτομέρειες σεναρίων όταν παρέχεται πράκτορας |
import VENDOR export.json | Προετοιμασία εισαγωγής JSON προμηθευτή για έλεγχο |
imports get UUID, imports commit UUID | Επιθεώρηση εισαγωγής· οριστικοποίηση επιλεγμένων πρακτόρων μετά τον έλεγχο |
mcp setup, mcp serve | Διαμόρφωση πελάτη· εκκίνηση της γέφυρας stdio |
init [directory] | Δημιουργία βασικής δομής έργου |
Οι εξερχόμενες κλήσεις απαιτούν αριθμό με ενεργοποιημένες εξερχόμενες κλήσεις. Το THUNDERPHONE_FROM_NUMBER μπορεί
να παρέχει το --from. Οι αριθμοί VoIP πελατών συνεχίζουν να υποστηρίζουν εξερχόμενες κλήσεις.
Οι αριθμοί που παρέχονται από το ThunderPhone ξεκινούν μόνο για εισερχόμενες κλήσεις· ένας διαχειριστής οργανισμού μπορεί
να ζητήσει εξερχόμενες κλήσεις από τη σελίδα Αριθμοί τηλεφώνου, όπου κάθε αίτημα
εξετάζεται χειροκίνητα. Το --wait έχει προεπιλεγμένο χρονικό όριο μίας ώρας· ορίστε
--timeout SECONDS για να το αλλάξετε. Ένα χρονικό όριο σταματά την αναμονή χωρίς να τερματίζει την κλήση.
Το SMS απαιτεί επίσης έναν αριθμό με δυνατότητα SMS στον συνδεδεμένο λογαριασμό σας Twilio ή Telnyx. Δεν στέλνει ποτέ από αριθμό που ανήκει στο ThunderPhone. Επαναχρησιμοποιήστε ένα κλειδί idempotency μόνο όταν επαναλαμβάνετε ακριβώς τον ίδιο αποστολέα, παραλήπτη και σώμα.
Οι εισαγωγές υποστηρίζουν vapi, retell, elevenlabs και bland. Το δεύτερο όρισμα είναι μια
διαδρομή προς εξαγωγή JSON προμηθευτή, όχι ένα απομακρυσμένο αναγνωριστικό προμηθευτή. Το API προετοιμάζει μια αντιστοίχιση
ασύγχρονα· επιθεωρήστε την με imports get UUID και οριστικοποιήστε μόνο αφού είναι έτοιμη
και έχετε ελέγξει τα αντιστοιχισμένα πεδία και τις προειδοποιήσεις. Δείτε εισαγωγές πρακτόρων.
Ρύθμιση MCP
thunderphone mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client codex --scope user --api-key-env THUNDERPHONE_API_KEY
thunderphone mcp setup --client claude-desktop --scope userΠελάτες: claude-code, codex, cursor, vscode, gemini, claude-desktop και
windsurf. Το εύρος έργου είναι το προεπιλεγμένο. Το Desktop και το Windsurf απαιτούν εύρος χρήστη.
Παραλείψτε το --client για να εντοπίσετε έναν μόνο πελάτη από το έργο· η αμφίσημη ανίχνευση
ζητά διαδραστικά επιλογή ή αποτυγχάνει με οδηγίες σε μη διαδραστική συνεδρία.
Η ρύθμιση εμφανίζει το αρχείο που έγραψε και διατηρεί άσχετους διακομιστές. Το υπάρχον JSON
πρέπει να είναι έγκυρο αυστηρό JSON· οι τιμές TOML του Codex διατηρούνται, αλλά τα σχόλια ενδέχεται να αναδιαμορφωθούν.
Η ρύθμιση προτιμά απευθείας απομακρυσμένο HTTP. Με το --api-key-env, γράφει αναφορά
μεταβλητής, ποτέ το κλειδί. Χωρίς αυτή την επιλογή, το απευθείας HTTP βασίζεται στην
υποστήριξη OAuth του πελάτη· δεν χρησιμοποιεί το αρχείο διαπιστευτηρίων του CLI. Για να επαναχρησιμοποιήσετε
τα διαπιστευτήρια του thunderphone login σε οποιονδήποτε πελάτη που υποστηρίζει stdio, χρησιμοποιήστε:
{
"mcpServers": {
"thunderphone": {
"command": "npx",
"args": ["-y", "@thunderphone/mcp"]
}
}
}Το περιτύλιγμα ελέγχει το THUNDERPHONE_API_KEY, έπειτα το τρέχον προφίλ CLI (ανανεώνοντάς το
όταν χρειάζεται) και στη συνέχεια αναθέτει το OAuth στο mcp-remote. Το THUNDERPHONE_MCP_URL παρακάμπτει
το τελικό σημείο. Δεν εκπέμπει τηλεμετρία. Η αυτόνομη ρύθμιση είναι επίσης διαθέσιμη μέσω
του npx -y @thunderphone/mcp setup --client cursor ή του thunderphone-mcp setup μετά την
καθολική εγκατάσταση του @thunderphone/mcp.
Δημιουργία έργου
npx create-thunderphone-agent my-receptionist
npx create-thunderphone-agent my-outbound --template python --agent-type outbound
# Equivalent:
thunderphone init my-receptionist --template node --agent-type receptionistΤα πρότυπα είναι node και python· οι τύποι πρακτόρων είναι receptionist, outbound και
custom. Ο προεπιλεγμένος πράκτορας είναι ένας αγγλόφωνος/ισπανόφωνος φωνητικός πράκτορας υποδοχής οδοντιατρείου με σαφή
στοιχεία επίδειξης. Τα έργα περιλαμβάνουν agent.json, σενάρια ανάπτυξης, διαμορφώσεις MCP για
Claude Code, Cursor και VS Code, οδηγίες για τον πράκτορα, .env.example και ένα README.
Η δημιουργία σκελετού λειτουργεί εκτός σύνδεσης και αρνείται να αντικαταστήσει έναν μη κενό κατάλογο.
Επεξεργαστείτε τα στοιχεία της επιχείρησης πριν από την ανάπτυξη. Εξαγάγετε το κλειδί API, τον συνδεδεμένο αριθμό
καλούντος και τον παραλήπτη δοκιμών σας όπως τεκμηριώνεται στο παραγόμενο README. Το npm run deploy
ή το python deploy.py δημιουργεί ή ενημερώνει τον πράκτορα, αναπτύσσει το πρόχειρό του και πραγματοποιεί μια
χρεώσιμη δοκιμαστική κλήση. Τα σενάρια χρησιμοποιούν έλεγχο ταυτότητας με κλειδί API· το CLI και το περιτύλιγμα MCP
stdio υποστηρίζουν επίσης σύνδεση συσκευής. Τα σενάρια Python απαιτούν Python 3.9 ή νεότερη έκδοση.