Open in
ThunderPhone CLI
Prihláste sa, spravujte hlasových agentov a hovory, konfigurujte klientov MCP a vytvárajte kostry projektov z terminálu.
CLI vyžaduje Node.js 18.18 alebo novší. Spustite ho pomocou npx alebo ho nainštalujte globálne:
npm install -g thunderphone
thunderphone --helpPrihlásenie
npx thunderphone login
thunderphone whoami --jsonPrihlásenie vypíše overovací kód, otvorí prehliadač a čaká na autorizáciu.
Na zariadení bez grafického rozhrania použite --no-browser a vypísanú URL otvorte inde.
Prihlásenie zariadenia vyžaduje nasadenie OAuth device flow rozhrania API. Kľúč API organizácie
v premennej THUNDERPHONE_API_KEY môže tiež autentifikovať príkazy a má prednosť
pred uloženými prihlasovacími údajmi.
Prihlasovacie údaje sa ukladajú podľa profilu do súboru ~/.config/thunderphone/credentials.json
s režimom súboru 0600. Premenné XDG_CONFIG_HOME a THUNDERPHONE_CONFIG_DIR prepíšu
adresár. Prístupové tokeny sa obnovujú automaticky a rotujúce obnovovacie tokeny sa
ukladajú atómovo. Tokeny sa pri prihlásení nikdy nevypisujú.
thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile workTHUNDERPHONE_PROFILE nastavuje predvolený profil. Odhlásenie odstráni lokálne prihlasovacie údaje;
nezruší však oprávnenie na serveri. Zmena alebo obnovenie hesla, prípadne
zmena e-mailu účtu, ho zruší; znova spustite thunderphone login. Predvolené API je https://api.thunderphone.com.
Pre iné API použite --api-base-url alebo THUNDERPHONE_API_BASE_URL. Token profilu
nemožno odoslať na inú nakonfigurovanú adresu URL API; do danej adresy URL sa prihláste pomocou samostatného profilu.
Príkazy
Každý príkaz prijíma parameter --json. Úspešné údaje sa odosielajú do stdout; chyby do stderr
s nenulovým návratovým kódom. Bez parametra --json je výstupom kompaktná tabuľka alebo zoznam polí.
JSON zachováva štruktúru odpovede API s redigovanými poľami prihlasovacích údajov. Obsluha MCP
vyhradzuje stdout pre protokol MCP.
| Príkaz | Účel |
|---|---|
login [--no-browser] [--scope "scopes"] | Autorizovať pomocou kódu zariadenia |
logout, whoami | Odstrániť lokálne prihlasovacie údaje; zobraziť dostupné organizácie |
agents list, agents get ID | Načítať hlasových agentov |
agents create --file agent.json | Vytvoriť hlasového agenta |
agents update ID --file agent.json | Uložiť koncept hlasového agenta |
agents deploy ID, agents delete ID | Nasadiť koncept; odstrániť hlasového agenta |
numbers list | Načítať telefónne čísla |
numbers provision --country US --area-code 415 | Zriadiť americké číslo pre prichádzajúce hovory |
numbers assign NUMBER_ID --agent ID | Priradiť hlasového agenta pre prichádzajúce hovory |
sms send TO --from FROM --body TEXT --idempotency-key KEY | Odoslať SMS cez číslo operátora pripojeného zákazníkom s bezpečným opätovným odoslaním |
sms list [--limit N], sms get UUID | Zobraziť alebo preskúmať záznamy SMS |
call TO --agent ID --from FROM [--wait] | Uskutočniť odchádzajúci hovor; voliteľne počkať na jeho prepis |
calls list [--limit N] [--agent ID] | Zobraziť hovory (limit 1–200) |
calls get ID, calls transcript ID | Načítať jeden hovor alebo jeho prepis |
test run AGENT_ID [--scenario ID] --consent-to-charge | Spustiť spoplatnené uložené scenáre pomocou webového kanála |
test status RUN_ID [--agent ID] | Preskúmať dávku s podrobnosťami scenára, keď je zadaný hlasový agent |
import VENDOR export.json | Pripraviť import JSON od dodávateľa na kontrolu |
imports get UUID, imports commit UUID | Preskúmať import; po kontrole potvrdiť vybraných hlasových agentov |
mcp setup, mcp serve | Nakonfigurovať klienta; spustiť most stdio |
init [directory] | Vytvoriť kostru projektu |
Odchádzajúce hovory vyžadujú číslo s povolenými odchádzajúcimi hovormi. THUNDERPHONE_FROM_NUMBER môže
poskytnúť hodnotu pre --from. Zákaznícke čísla VoIP naďalej podporujú odchádzajúce hovory.
Čísla zriadené službou ThunderPhone sú spočiatku iba pre prichádzajúce hovory; administrátor organizácie môže
požiadať o odchádzajúce hovory na stránke Telefónne čísla, kde sa každá žiadosť
posudzuje manuálne. Parameter --wait má predvolený časový limit jednu hodinu; nastavte
--timeout SECONDS, ak ho chcete zmeniť. Vypršanie časového limitu ukončí čakanie bez ukončenia hovoru.
SMS tiež vyžaduje číslo s podporou SMS vo vašom pripojenom účte Twilio alebo Telnyx. Nikdy sa neodosiela z čísla vlastneného službou ThunderPhone. Kľúč idempotentnosti použite znova iba pri opakovaní odoslania s presne rovnakým odosielateľom, príjemcom a textom.
Importy podporujú vapi, retell, elevenlabs a bland. Druhý argument je
cesta k exportu JSON od dodávateľa, nie vzdialené ID dodávateľa. API pripraví mapovanie
asynchrónne; skontrolujte ho pomocou imports get UUID a potvrďte ho až po jeho pripravení
a po kontrole namapovaných polí a upozornení. Pozrite si importy hlasových agentov.
Nastavenie 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 userKlienti: claude-code, codex, cursor, vscode, gemini, claude-desktop a
windsurf. Predvolené je nastavenie na úrovni projektu. Desktop a Windsurf vyžadujú nastavenie na úrovni používateľa.
Ak vynecháte --client, zistí sa jeden klient z projektu; nejednoznačné zistenie
interaktívne vyžiada výber alebo v neinteraktívnej relácii zlyhá s pokynmi.
Nastavenie vypíše súbor, ktorý zapísalo, a zachová nesúvisiace servery. Existujúci JSON
musí byť platný striktne formátovaný JSON; hodnoty TOML pre Codex sa zachovajú, komentáre však môžu byť preformátované.
Nastavenie uprednostňuje priame vzdialené HTTP. Pri použití --api-key-env zapíše odkaz
na premennú, nikdy nie samotný kľúč. Bez tejto možnosti sa priame HTTP spolieha na podporu
OAuth klienta; nepoužíva súbor poverení CLI. Ak chcete znova použiť poverenia z thunderphone login
v ľubovoľnom klientovi podporujúcom stdio, použite:
{
"mcpServers": {
"thunderphone": {
"command": "npx",
"args": ["-y", "@thunderphone/mcp"]
}
}
}Obal najprv kontroluje THUNDERPHONE_API_KEY, potom aktuálny profil CLI (v prípade potreby ho
obnoví) a následne prenechá OAuth na mcp-remote. THUNDERPHONE_MCP_URL prepíše
koncový bod. Neodosiela žiadnu telemetriu. Samostatné nastavenie je dostupné aj prostredníctvom
npx -y @thunderphone/mcp setup --client cursor alebo thunderphone-mcp setup po
globálnej inštalácii @thunderphone/mcp.
Vytvorenie projektu
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Šablóny sú node a python; typy agentov sú receptionist, outbound a
custom. Predvolený agent je anglicko-španielsky zubársky recepčný s explicitne
uvedenými faktami pre ukážku. Projekty obsahujú agent.json, skripty nasadenia, konfigurácie MCP pre
Claude Code, Cursor a VS Code, pokyny pre agenta, .env.example a README.
Generovanie štruktúry funguje offline a odmietne prepísať neprázdny adresár.
Pred nasadením upravte údaje o firme. Exportujte kľúč API, pripojené číslo volajúceho
a príjemcu testu podľa pokynov v vygenerovanom README. npm run deploy
alebo python deploy.py vytvorí alebo aktualizuje agenta, nasadí jeho koncept a uskutoční
spoplatnený testovací hovor. Skripty používajú overenie pomocou kľúča API; CLI a obal MCP pre
stdio podporujú aj prihlásenie zo zariadenia. Skripty v Pythone vyžadujú Python 3.9 alebo novší.