ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Getting Started

ThunderPhone CLI

Prisijunkite, valdykite balso agentus ir skambučius, konfigūruokite MCP klientus ir kurkite projektų karkasus iš terminalo.

CLI reikalauja Node.js 18.18 arba naujesnės versijos. Paleiskite jį su npx arba įdiekite visuotinai:

npm install -g thunderphone
thunderphone --help

Prisijunkite

npx thunderphone login
thunderphone whoami --json

Prisijungimas pateikia patvirtinimo kodą, atidaro naršyklę ir laukia autorizacijos. Begalviame įrenginyje naudokite --no-browser, o pateiktą URL atidarykite kitur. Prisijungimui įrenginiu reikia, kad API būtų įdiegta OAuth įrenginio srauto funkcija. Organizacijos API raktas, esantis THUNDERPHONE_API_KEY, taip pat gali autentifikuoti komandas ir turi pirmenybę prieš išsaugotus prisijungimo duomenis.

Prisijungimo duomenys pagal profilį saugomi faile ~/.config/thunderphone/credentials.json su failo režimu 0600. XDG_CONFIG_HOME ir THUNDERPHONE_CONFIG_DIR pakeičia katalogą. Prieigos žetonai atnaujinami automatiškai, o keičiami atnaujinimo žetonai išsaugomi atominiu būdu. Prisijungimas niekada nepateikia žetonų.

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

THUNDERPHONE_PROFILE nustato numatytąjį profilį. Atsijungus pašalinami vietiniai prisijungimo duomenys; tai nepanaikina serverio suteikto leidimo. Pakeitus arba iš naujo nustačius slaptažodį arba pakeitus paskyros el. pašto adresą, leidimas panaikinamas; dar kartą vykdykite thunderphone login. Numatytoji API yra https://api.thunderphone.com. Kitai API naudokite --api-base-url arba THUNDERPHONE_API_BASE_URL. Profilio atpažinimo ženklas negali būti siunčiamas į kitą sukonfigūruotą API URL; prisijunkite prie to URL naudodami atskirą profilį.

Komandos

Kiekviena komanda priima --json. Sėkmingi duomenys siunčiami į stdout, o klaidos – į stderr su nenuliniu užbaigimo kodu. Be --json išvestis yra kompaktiška lentelė arba laukų sąrašas. JSON išlaiko API atsakymo struktūrą, o prisijungimo duomenų laukai užmaskuojami. Teikiant MCP paslaugą stdout rezervuojamas MCP protokolui.

KomandaPaskirtis
login [--no-browser] [--scope "scopes"]Autorizuoti naudojant įrenginio kodą
logout, whoamiPašalinti vietinius prisijungimo duomenis; išvardyti pasiekiamas organizacijas
agents list, agents get IDGauti agentų duomenis
agents create --file agent.jsonSukurti agentą
agents update ID --file agent.jsonIšsaugoti agento juodraštį
agents deploy ID, agents delete IDDiegti juodraštį; ištrinti agentą
numbers listGauti telefono numerių duomenis
numbers provision --country US --area-code 415Parengti JAV įeinančių skambučių numerį
numbers assign NUMBER_ID --agent IDPriskirti įeinančių skambučių agentą
sms send TO --from FROM --body TEXT --idempotency-key KEYSiųsti SMS per kliento prijungto ryšio tiekėjo numerį, saugiai kartojant siuntimą
sms list [--limit N], sms get UUIDIšvardyti arba peržiūrėti SMS įrašus
call TO --agent ID --from FROM [--wait]Atlikti išeinantį skambutį; pasirinktinai laukti jo nuorašo
calls list [--limit N] [--agent ID]Išvardyti skambučius (riba 1–200)
calls get ID, calls transcript IDGauti vieno skambučio arba jo nuorašo duomenis
test run AGENT_ID [--scenario ID] --consent-to-chargeVykdyti apmokestinamus išsaugotus scenarijus naudojant žiniatinklio kanalą
test status RUN_ID [--agent ID]Peržiūrėti paketą ir scenarijų informaciją, kai nurodomas agentas
import VENDOR export.jsonParengti tiekėjo JSON importavimą peržiūrai
imports get UUID, imports commit UUIDPeržiūrėti importavimą; po peržiūros patvirtinti pasirinktus agentus
mcp setup, mcp serveKonfigūruoti klientą; paleisti stdio sąsają
init [directory]Sukurti projekto karkasą

Išeinantiems skambučiams reikalingas numeris su įgalintais išeinančiais skambučiais. THUNDERPHONE_FROM_NUMBER gali nurodyti --from. Klientų VoIP numeriai ir toliau palaiko išeinančius skambučius. ThunderPhone parengti numeriai iš pradžių skirti tik įeinantiems skambučiams; organizacijos administratorius gali pateikti užklausą dėl išeinančių skambučių Telefono numerių puslapyje, kuriame kiekviena užklausa peržiūrima rankiniu būdu. Numatytoji --wait laukimo laiko riba yra viena valanda; ją pakeiskite naudodami --timeout SECONDS. Pasibaigus laukimo laikui laukti nustojama, tačiau skambutis nenutraukiamas.

SMS taip pat reikalingas SMS palaikantis numeris jūsų prijungtoje Twilio arba Telnyx paskyroje. SMS niekada nesiunčiamos iš ThunderPhone priklausančio numerio. Pakartotinio siuntimo raktą naudokite pakartotinai tik bandydami iš naujo siųsti su visiškai tais pačiais siuntėjo, gavėjo ir turinio duomenimis.

Importavimas palaiko vapi, retell, elevenlabs ir bland. Antrasis argumentas yra kelias į tiekėjo JSON eksportą, o ne nuotolinis tiekėjo ID. API parengia susiejimą asinchroniškai; peržiūrėkite jį naudodami imports get UUID ir patvirtinkite tik tada, kai jis parengtas ir peržiūrėjote susietus laukus bei įspėjimus. Žr. agentų importavimą.

MCP nustatymas

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

Klientai: claude-code, codex, cursor, vscode, gemini, claude-desktop ir windsurf. Projekto apimtis naudojama pagal numatytuosius nustatymus. Darbalaukio ir Windsurf klientams reikalinga naudotojo apimtis. Praleiskite --client, kad aptiktumėte vieną klientą projekte; dviprasmiškas aptikimas interaktyviai pateikia užklausą arba neinteraktyvioje sesijoje baigiasi su instrukcijomis. Nustatant išspausdinamas įrašytas failas ir išsaugomi nesusiję serveriai. Esamas JSON turi būti galiojantis griežtas JSON; Codex TOML reikšmės išsaugomos, tačiau komentarai gali būti performatuoti.

Nustatymas teikia pirmenybę tiesioginiam nuotoliniam HTTP ryšiui. Naudojant --api-key-env, įrašoma kintamojo nuoroda, bet niekada ne pats raktas. Be šios parinkties tiesioginis HTTP remiasi kliento OAuth palaikymu; jis nenaudoja CLI kredencialų failo. Norėdami pakartotinai naudoti thunderphone login kredencialus bet kuriame stdio palaikančiame kliente, naudokite:

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

Apvalkalas patikrina THUNDERPHONE_API_KEY, tada dabartinį CLI profilį (prireikus jį atnaujina), o tada perduoda OAuth valdymą mcp-remote. THUNDERPHONE_MCP_URL pakeičia galinį tašką. Jis nesiunčia telemetrijos. Atskiras nustatymas taip pat pasiekiamas naudojant npx -y @thunderphone/mcp setup --client cursor arba thunderphone-mcp setup, įdiegus @thunderphone/mcp globaliai.

Sukurkite 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

Šablonai yra node ir python; agentų tipai yra receptionist, outbound ir custom. Numatytasis agentas yra anglų ir ispanų kalbomis veikiantis odontologijos registratūros balso agentas su aiškiai nurodytais demonstraciniais faktais. Projektuose yra agent.json, diegimo scenarijai, MCP konfigūracijos, skirtos Claude Code, Cursor ir VS Code, agentui skirtos instrukcijos, .env.example ir README. Karkaso sukūrimas vykdomas neprisijungus ir neleidžia perrašyti netuščio katalogo.

Prieš diegdami redaguokite verslo faktus. Eksportuokite API raktą, prijungtą skambintojo numerį ir testavimo gavėją, kaip nurodyta sugeneruotame README. npm run deploy arba python deploy.py sukuria arba atnaujina agentą, įdiegia jo juodraštį ir atlieka apmokestinamą testinį skambutį. Scenarijai naudoja API rakto autentifikavimą; CLI ir stdio MCP apvalkalas taip pat palaiko prisijungimą įrenginiu. Python scenarijams reikalinga Python 3.9 arba naujesnė versija.