ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Getting Started

ThunderPhone CLI

Prijavite se, upravljajte glasovnim agentima i pozivima, konfigurirajte MCP klijente i postavite kostur projekata iz terminala.

CLI zahtijeva Node.js 18.18 ili noviji. Pokrenite ga pomoću npx ili ga instalirajte globalno:

npm install -g thunderphone
thunderphone --help

Prijava

npx thunderphone login
thunderphone whoami --json

Prijava ispisuje kontrolni kôd, otvara preglednik i čeka autorizaciju. Na računalu bez grafičkog sučelja upotrijebite --no-browser i ispisani URL otvorite na drugom mjestu. Prijava uređaja zahtijeva uvođenje OAuth tijeka za uređaje API-ja. Organizacijski API ključ u THUNDERPHONE_API_KEY također može autentificirati naredbe i ima prednost pred pohranjenim vjerodajnicama za prijavu.

Vjerodajnice se po profilima pohranjuju u ~/.config/thunderphone/credentials.json s načinom rada datoteke 0600. Varijable XDG_CONFIG_HOME i THUNDERPHONE_CONFIG_DIR nadjačavaju direktorij. Pristupni tokeni automatski se osvježavaju, a rotirajući tokeni za osvježavanje spremaju se atomski. Tokeni se nikada ne ispisuju pri prijavi.

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

THUNDERPHONE_PROFILE postavlja zadani profil. Odjava uklanja lokalne vjerodajnice; ne opoziva autorizaciju poslužitelja. Promjena ili ponovno postavljanje lozinke ili promjena e-adrese računa opoziva je; ponovno pokrenite thunderphone login. Zadani API je https://api.thunderphone.com. Za drugi API upotrijebite --api-base-url ili THUNDERPHONE_API_BASE_URL. Token profila ne može se poslati na drugi konfigurirani API URL; prijavite se na taj URL putem zasebnog profila.

Naredbe

Svaka naredba prihvaća --json. Uspješni podaci šalju se na stdout; pogreške na stderr s izlaznim kodom različitim od nule. Bez --json, izlaz je sažeta tablica ili popis polja. JSON zadržava strukturu API odgovora, pri čemu su polja vjerodajnica skrivena. MCP poslužitelj rezervira stdout za MCP protokol.

NaredbaSvrha
login [--no-browser] [--scope "scopes"]Autorizirajte se putem koda uređaja
logout, whoamiUklonite lokalne vjerodajnice; prikažite dostupne organizacije
agents list, agents get IDDohvatite agente
agents create --file agent.jsonStvorite agenta
agents update ID --file agent.jsonSpremite skicu agenta
agents deploy ID, agents delete IDObjavite skicu; izbrišite agenta
numbers listDohvatite telefonske brojeve
numbers provision --country US --area-code 415Dodijelite američki broj za dolazne pozive
numbers assign NUMBER_ID --agent IDDodijelite agenta za dolazne pozive
sms send TO --from FROM --body TEXT --idempotency-key KEYPošaljite SMS putem broja operatera povezanog s korisnikom uz sigurno ponavljanje
sms list [--limit N], sms get UUIDPrikažite ili pregledajte SMS zapise
call TO --agent ID --from FROM [--wait]Uputite odlazni poziv; po želji pričekajte njegov prijepis
calls list [--limit N] [--agent ID]Prikažite pozive (ograničenje 1–200)
calls get ID, calls transcript IDDohvatite jedan poziv ili njegov prijepis
test run AGENT_ID [--scenario ID] --consent-to-chargePokrenite spremljene scenarije koji se naplaćuju putem web-kanala
test status RUN_ID [--agent ID]Pregledajte skup, s pojedinostima scenarija kada je naveden agent
import VENDOR export.jsonPripremite uvoz JSON-a dobavljača za pregled
imports get UUID, imports commit UUIDPregledajte uvoz; potvrdite odabrane agente nakon pregleda
mcp setup, mcp serveKonfigurirajte klijent; pokrenite stdio most
init [directory]Stvorite kostur projekta

Odlazni pozivi zahtijevaju broj s omogućenim odlaznim pozivima. THUNDERPHONE_FROM_NUMBER može navesti --from. Korisnički VoIP brojevi i dalje podržavaju odlazne pozive. Brojevi koje je dodijelio ThunderPhone u početku podržavaju samo dolazne pozive; administrator organizacije može zatražiti odlazne pozive na stranici Telefonski brojevi, gdje se svaki zahtjev ručno pregledava. --wait prema zadanim postavkama ima vremensko ograničenje od jednog sata; postavite --timeout SECONDS da biste ga promijenili. Istek vremena prekida čekanje bez završavanja poziva.

SMS također zahtijeva broj koji podržava SMS na vašem povezanom Twilio ili Telnyx računu. SMS se nikada ne šalje s broja u vlasništvu ThunderPhonea. Ključ idempotentnosti ponovno upotrijebite samo kada ponavljate potpuno istog pošiljatelja, primatelja i sadržaj poruke.

Uvozi podržavaju vapi, retell, elevenlabs i bland. Drugi argument je put do izvoza JSON-a dobavljača, a ne udaljeni ID dobavljača. API asinkrono priprema mapiranje; pregledajte ga s imports get UUID i potvrdite ga tek kada bude spremno i kada pregledate mapirana polja i upozorenja. Pogledajte uvoze agenata.

Postavljanje MCP-a

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

Klijenti: claude-code, codex, cursor, vscode, gemini, claude-desktop i windsurf. Opseg projekta zadani je. Desktop i Windsurf zahtijevaju korisnički opseg. Izostavite --client kako biste otkrili jednog klijenta iz projekta; dvosmisleno otkrivanje interaktivno traži odabir ili ne uspijeva s uputama u neinteraktivnoj sesiji. Postavljanje ispisuje datoteku koju je zapisalo i zadržava nepovezane poslužitelje. Postojeći JSON mora biti valjan strogi JSON; vrijednosti Codex TOML-a zadržavaju se, ali komentari se mogu preoblikovati.

Postavljanje preferira izravni udaljeni HTTP. Uz --api-key-env zapisuje referencu na varijablu, nikada ključ. Bez te opcije izravni HTTP oslanja se na podršku klijenta za OAuth; ne koristi datoteku vjerodajnica CLI-ja. Za ponovnu upotrebu vjerodajnica iz thunderphone login u bilo kojem klijentu koji podržava stdio, upotrijebite:

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

Omotač provjerava THUNDERPHONE_API_KEY, zatim trenutačni CLI profil (osvježavajući ga po potrebi), a zatim delegira OAuth na mcp-remote. THUNDERPHONE_MCP_URL nadjačava krajnju točku. Ne šalje telemetriju. Samostalno postavljanje dostupno je i putem npx -y @thunderphone/mcp setup --client cursor ili thunderphone-mcp setup nakon globalne instalacije paketa @thunderphone/mcp.

Izradite 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

Predlošci su node i python; vrste agenata su receptionist, outbound i custom. Zadani agent je englesko-španjolski stomatološki glasovni agent za prijem s eksplicitnim činjenicama za demonstraciju. Projekti uključuju agent.json, skripte za implementaciju, MCP konfiguracije za Claude Code, Cursor i VS Code, upute za agenta, .env.example i README. Generiranje kostura radi izvan mreže i odbija prepisati neprazan direktorij.

Uredite poslovne činjenice prije implementacije. Izvezite API ključ, povezani broj pozivatelja i primatelja testnog poziva kako je dokumentirano u generiranom README-u. npm run deploy ili python deploy.py stvara ili ažurira agenta, implementira njegov nacrt i upućuje naplativ testni poziv. Skripte koriste autentifikaciju API ključem; CLI i stdio MCP omotač također podržavaju prijavu uređajem. Python skripte zahtijevaju Python 3.9 ili noviji.