ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Getting Started

ThunderPhone CLI

Prijavite se, upravljajte glasovne agente in klice, konfigurirajte odjemalce MCP ter ustvarite ogrodja projektov iz terminala.

CLI zahteva Node.js 18.18 ali novejšo različico. Zaženite ga z npx ali ga namestite globalno:

npm install -g thunderphone
thunderphone --help

Prijava

npx thunderphone login
thunderphone whoami --json

Prijava izpiše potrditveno kodo, odpre brskalnik in čaka na avtorizacijo. Na napravi brez grafičnega vmesnika uporabite --no-browser in izpisani URL odprite drugje. Prijava naprave zahteva uvedbo poteka OAuth za naprave v API-ju. Ključ API organizacije v THUNDERPHONE_API_KEY lahko prav tako overi ukaze in ima prednost pred shranjenimi prijavnimi podatki.

Prijavni podatki so shranjeni po profilih v ~/.config/thunderphone/credentials.json z načinom datoteke 0600. XDG_CONFIG_HOME in THUNDERPHONE_CONFIG_DIR preglasita imenik. Žetoni za dostop se samodejno osvežijo, rotacijski žetoni za osvežitev pa se shranijo atomsko. Prijava nikoli ne izpiše žetonov.

thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile work

THUNDERPHONE_PROFILE nastavi privzeti profil. Odjava odstrani lokalne poverilnice; ne prekliče pa odobritve na strežniku. Sprememba ali ponastavitev gesla oziroma sprememba e-poštnega naslova računa odobritev prekliče; znova zaženite thunderphone login. Privzeti API je https://api.thunderphone.com. Za drug API uporabite --api-base-url ali THUNDERPHONE_API_BASE_URL. Žetona profila ni mogoče poslati na drug konfiguriran URL API-ja; v ta URL se prijavite z ločenim profilom.

Ukazi

Vsak ukaz sprejme --json. Uspešni podatki se izpišejo v stdout; napake se izpišejo v stderr z neničelno izhodno kodo. Brez --json je izhod strnjena tabela ali seznam polj. JSON ohrani strukturo odgovora API-ja, pri čemer so polja s poverilnicami redigirana. Streženje MCP rezervira stdout za protokol MCP.

UkazNamen
login [--no-browser] [--scope "scopes"]Avtorizirajte se s kodo naprave
logout, whoamiOdstranite lokalne poverilnice; navedite dostopne organizacije
agents list, agents get IDPreberite agente
agents create --file agent.jsonUstvarite agenta
agents update ID --file agent.jsonShranite osnutek agenta
agents deploy ID, agents delete IDObjavite osnutek; izbrišite agenta
numbers listPreberite telefonske številke
numbers provision --country US --area-code 415Zagotovite dohodno številko v ZDA
numbers assign NUMBER_ID --agent IDDodelite dohodnega agenta
sms send TO --from FROM --body TEXT --idempotency-key KEYPošljite SMS prek številke operaterja, povezanega s stranko, z varnim ponovnim predvajanjem
sms list [--limit N], sms get UUIDNavedite ali preglejte zapise SMS
call TO --agent ID --from FROM [--wait]Opravite odhodni klic; po želji počakajte na njegov prepis
calls list [--limit N] [--agent ID]Navedite klice (omejitev 1–200)
calls get ID, calls transcript IDPreberite en klic ali njegov prepis
test run AGENT_ID [--scenario ID] --consent-to-chargeZaženite plačljive shranjene scenarije prek spletnega kanala
test status RUN_ID [--agent ID]Preglejte paket s podrobnostmi scenarija, kadar je naveden agent
import VENDOR export.jsonPripravite uvoz JSON od ponudnika za pregled
imports get UUID, imports commit UUIDPreglejte uvoz; po pregledu potrdite izbrane agente
mcp setup, mcp serveKonfigurirajte odjemalca; zaženite most stdio
init [directory]Ustvarite osnovno strukturo projekta

Odhodni klici zahtevajo številko z omogočenimi odhodnimi klici. THUNDERPHONE_FROM_NUMBER lahko zagotovi --from. VoIP-številke strank še naprej podpirajo odhodne klice. Številke, ki jih zagotovi ThunderPhone, so sprva samo dohodne; skrbnik organizacije lahko zahteva odhodne klice na strani Telefonske številke, kjer se vsaka zahteva pregleda ročno. Privzeta vrednost --wait je enourna časovna omejitev; nastavite --timeout SECONDS, da jo spremenite. Časovna omejitev preneha čakati, ne da bi končala klic.

SMS zahteva tudi številko, ki podpira SMS, v vašem povezanem računu Twilio ali Telnyx. Nikoli ne pošilja s številke v lasti ThunderPhone. Ključ idempotentnosti znova uporabite le pri ponovnem poskusu s popolnoma enakim pošiljateljem, prejemnikom in besedilom.

Uvozi podpirajo vapi, retell, elevenlabs in bland. Drugi argument je pot do izvoza JSON ponudnika, ne oddaljeni ID ponudnika. API asinhrono pripravi preslikavo; preglejte jo z imports get UUID in jo potrdite šele, ko je pripravljena ter ste pregledali preslikana polja in opozorila. Oglejte si uvoze agentov.

Nastavitev 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

Odjemalci: claude-code, codex, cursor, vscode, gemini, claude-desktop in windsurf. Obseg projekta je privzet. Desktop in Windsurf zahtevata uporabniški obseg. Izpustite --client, da zaznate enega odjemalca iz projekta; dvoumno zaznavanje interaktivno zahteva izbiro ali pa v neinteraktivni seji ne uspe z navodili. Nastavitev izpiše datoteko, ki jo je zapisala, in ohrani nepovezane strežnike. Obstoječi JSON mora biti veljaven strogi JSON; vrednosti TOML za Codex se ohranijo, vendar se lahko komentarji preoblikujejo.

Nastavitev daje prednost neposrednemu oddaljenemu HTTP. Z --api-key-env zapiše sklic na spremenljivko, nikoli ključa. Brez te možnosti se neposredni HTTP zanaša na podporo odjemalca za OAuth; ne uporablja datoteke s poverilnicami CLI. Če želite poverilnice iz thunderphone login znova uporabiti v katerem koli odjemalcu, ki podpira stdio, uporabite:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": ["-y", "@thunderphone/mcp"]
    }
  }
}

Ovijalnik preveri THUNDERPHONE_API_KEY, nato trenutni profil CLI (po potrebi ga osveži), nato pa OAuth prepusti mcp-remote. THUNDERPHONE_MCP_URL preglasi končno točko. Ne pošilja telemetrije. Samostojna nastavitev je na voljo tudi prek npx -y @thunderphone/mcp setup --client cursor ali thunderphone-mcp setup po globalni namestitvi @thunderphone/mcp.

Ustvarite projekt

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

Predlogi so node in python; vrste agentov so receptionist, outbound in custom. Privzeti agent je angleško-španski zobozdravstveni receptor z izrecnimi dejstvi za predstavitev. Projekti vključujejo agent.json, skripte za uvedbo, konfiguracije MCP za Claude Code, Cursor in VS Code, navodila za agenta, .env.example in README. Ustvarjanje ogrodja deluje brez povezave in ne dovoli prepisovanja nepraznega imenika.

Pred uvedbo uredite podatke o podjetju. Izvozite ključ API, povezano številko klicatelja in prejemnika za testiranje, kot je dokumentirano v ustvarjenem README. npm run deploy ali python deploy.py ustvari ali posodobi agenta, uvede njegov osnutek in izvede plačljiv testni klic. Skripte uporabljajo preverjanje pristnosti s ključem API; CLI in ovijalnik MCP za stdio podpirata tudi prijavo z napravo. Skripte Python zahtevajo Python 3.9 ali novejši.