ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Getting Started

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 --help

Prihlásenie

npx thunderphone login
thunderphone whoami --json

Prihlá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 work

THUNDERPHONE_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, whoamiOdstrániť lokálne prihlasovacie údaje; zobraziť dostupné organizácie
agents list, agents get IDNačítať hlasových agentov
agents create --file agent.jsonVytvoriť hlasového agenta
agents update ID --file agent.jsonUložiť koncept hlasového agenta
agents deploy ID, agents delete IDNasadiť koncept; odstrániť hlasového agenta
numbers listNačítať telefónne čísla
numbers provision --country US --area-code 415Zriadiť americké číslo pre prichádzajúce hovory
numbers assign NUMBER_ID --agent IDPriradiť hlasového agenta pre prichádzajúce hovory
sms send TO --from FROM --body TEXT --idempotency-key KEYOdoslať 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 UUIDZobraziť 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 IDNačítať jeden hovor alebo jeho prepis
test run AGENT_ID [--scenario ID] --consent-to-chargeSpustiť 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.jsonPripraviť import JSON od dodávateľa na kontrolu
imports get UUID, imports commit UUIDPreskúmať import; po kontrole potvrdiť vybraných hlasových agentov
mcp setup, mcp serveNakonfigurovať 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 user

Klienti: 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ší.