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

Getting Started

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 ή νεότερη έκδοση.