ThunderPhone v3 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo

Getting Started

ThunderPhone CLI

Ingia, simamia ejenti za sauti na simu, sanidi wateja wa MCP, na anzisha miradi kutoka kwenye terminali.

CLI inahitaji Node.js 18.18 au toleo jipya zaidi. Iendeshe kwa npx, au isakinishe kimfumo:

npm install -g thunderphone
thunderphone --help

Ingia

npx thunderphone login
thunderphone whoami --json

Kuingia huchapisha msimbo wa uthibitishaji, hufungua kivinjari, na husubiri idhini. Tumia --no-browser kwenye mashine isiyo na kiolesura cha picha na ufungue URL iliyochapishwa mahali pengine. Kuingia kwa kifaa kunahitaji utekelezwaji wa mtiririko wa kifaa wa OAuth wa API. Ufunguo wa API wa shirika katika THUNDERPHONE_API_KEY unaweza pia kuthibitisha amri na hupewa kipaumbele kuliko stakabadhi za kuingia zilizohifadhiwa.

Stakabadhi huhifadhiwa kwa wasifu katika ~/.config/thunderphone/credentials.json kwa hali ya faili 0600. XDG_CONFIG_HOME na THUNDERPHONE_CONFIG_DIR hubatilisha saraka hiyo. Tokeni za ufikiaji huonyeshwa upya kiotomatiki, na tokeni za kuonyesha upya zinazobadilika huhifadhiwa atomiki. Tokeni hazichapishwi kamwe wakati wa kuingia.

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

THUNDERPHONE_PROFILE huweka profaili chaguomsingi. Kuondoka huondoa stakabadhi za ndani; hakufuti ruhusa ya seva. Kubadilisha au kuweka upya nenosiri lako, au kubadilisha barua pepe ya akaunti yako, hufuta ruhusa hiyo; endesha thunderphone login tena. API chaguomsingi ni https://api.thunderphone.com. Tumia --api-base-url au THUNDERPHONE_API_BASE_URL kwa API nyingine. Tokeni ya profaili haiwezi kutumwa kwa URL tofauti ya API iliyosanidiwa; ingia kwenye URL hiyo kwa profaili tofauti.

Amri

Kila amri inakubali --json. Data iliyofaulu hutumwa kwa stdout; hitilafu hutumwa kwa stderr kwa msimbo wa kutoka usio sifuri. Bila --json, matokeo ni jedwali fupi au orodha ya sehemu. JSON huhifadhi muundo wa jibu la API, huku sehemu za vitambulisho zikifichwa. Utoaji wa MCP huhifadhi stdout kwa itifaki ya MCP.

AmriKusudi
login [--no-browser] [--scope "scopes"]Idhinisha kupitia msimbo wa kifaa
logout, whoamiOndoa vitambulisho vya ndani; orodhesha mashirika yanayoweza kufikiwa
agents list, agents get IDSoma ejenti
agents create --file agent.jsonUnda ejenti
agents update ID --file agent.jsonHifadhi rasimu ya ejenti
agents deploy ID, agents delete IDWeka rasimu hewani; futa ejenti
numbers listSoma nambari za simu
numbers provision --country US --area-code 415Toa nambari ya Marekani ya simu zinazoingia
numbers assign NUMBER_ID --agent IDWeka ejenti wa simu zinazoingia
sms send TO --from FROM --body TEXT --idempotency-key KEYTuma SMS kupitia nambari ya mtoa huduma iliyounganishwa na mteja kwa urudiaji salama
sms list [--limit N], sms get UUIDOrodhesha au kagua rekodi za SMS
call TO --agent ID --from FROM [--wait]Piga simu inayotoka; kwa hiari subiri transkripti yake
calls list [--limit N] [--agent ID]Orodhesha simu (kikomo 1–200)
calls get ID, calls transcript IDSoma simu moja au transkripti yake
test run AGENT_ID [--scenario ID] --consent-to-chargeEndesha hali zilizohifadhiwa zinazotozwa kwa kutumia kituo cha wavuti
test status RUN_ID [--agent ID]Kagua kundi, ukiwa na maelezo ya hali ejenti inapotolewa
import VENDOR export.jsonAndaa uagizaji wa JSON wa mtoa huduma kwa ukaguzi
imports get UUID, imports commit UUIDKagua uagizaji; thibitisha ejenti waliochaguliwa baada ya ukaguzi
mcp setup, mcp serveSanidi mteja; anza daraja la stdio
init [directory]Unda muundo wa awali wa mradi

Simu zinazotoka zinahitaji nambari iliyoidhinishwa kwa simu zinazotoka. THUNDERPHONE_FROM_NUMBER inaweza kutoa --from. Nambari za VoIP za mteja zinaendelea kutumia simu zinazotoka. Nambari zinazotolewa na ThunderPhone huanza zikiwa za simu zinazoingia pekee; msimamizi wa shirika anaweza kuomba simu zinazotoka kutoka kwenye ukurasa wa Nambari za Simu, ambapo kila ombi hukaguliwa mwenyewe. --wait hutumia muda wa kuisha wa saa moja kwa chaguo-msingi; weka --timeout SECONDS ili kuubadilisha. Muda wa kuisha huacha kusubiri bila kumaliza simu.

SMS pia inahitaji nambari yenye uwezo wa SMS kwenye akaunti yako ya Twilio au Telnyx iliyounganishwa. Haitumiwi kamwe kutoka kwenye nambari inayomilikiwa na ThunderPhone. Tumia tena ufunguo wa idempotency tu unapojaribu tena mtumaji, mpokeaji na maudhui yaleyale kabisa.

Uagizaji unaauni vapi, retell, elevenlabs, na bland. Hoja ya pili ni njia ya kuelekea uhamishaji wa JSON wa mtoa huduma, si ID ya mbali ya mtoa huduma. API huandaa ulinganishaji kwa njia isiyosubiri; ukague kwa imports get UUID na uthibitishe tu baada ya kuwa tayari na baada ya kukagua sehemu zilizolinganishwa na maonyo. Tazama uagizaji wa ejenti.

Usanidi wa 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

Wateja ni: claude-code, codex, cursor, vscode, gemini, claude-desktop, na windsurf. Wigo wa mradi ndio chaguomsingi. Desktop na Windsurf zinahitaji wigo wa mtumiaji. Ondoa --client ili kutambua mteja mmoja kutoka kwenye mradi; utambuzi wenye utata utauliza kwa maingiliano au utashindwa na kutoa maelekezo katika kipindi kisicho cha maingiliano. Usanidi huchapisha faili iliyoandikwa na huhifadhi seva zisizohusiana. JSON iliyopo lazima iwe JSON halali ya masharti makali; thamani za TOML za Codex huhifadhiwa lakini maoni yanaweza kuumbizwa upya.

Usanidi hupendelea HTTP ya mbali ya moja kwa moja. Ukiwa na --api-key-env, huandika rejeleo la kigeu, kamwe si ufunguo. Bila chaguo hilo, HTTP ya moja kwa moja hutegemea usaidizi wa OAuth wa mteja; haitumii faili ya stakabadhi ya CLI. Ili kutumia tena stakabadhi za thunderphone login katika mteja wowote unaoweza kutumia stdio, tumia:

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

Kifungashi hukagua THUNDERPHONE_API_KEY, kisha profaili ya sasa ya CLI (huirejesha inapohitajika), kisha hukabidhi OAuth kwa mcp-remote. THUNDERPHONE_MCP_URL hubatilisha endpoint. Haitoi telemetry. Usanidi wa pekee pia unapatikana kupitia npx -y @thunderphone/mcp setup --client cursor au thunderphone-mcp setup baada ya kusakinisha @thunderphone/mcp kwa kiwango cha kimataifa.

Unda mradi

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

Violezo ni node na python; aina za ejenti ni receptionist, outbound, na custom. Ejenti chaguomsingi ni ejenti wa mapokezi wa kliniki ya meno wa Kiingereza/Kihispania yenye taarifa wazi za onyesho. Miradi inajumuisha agent.json, hati za kusambaza, usanidi wa MCP kwa Claude Code, Cursor na VS Code, maelekezo ya ejenti, .env.example, na README. Uundaji wa msingi hufanyika bila mtandao na hukataa kuandika juu ya saraka isiyo tupu.

Hariri taarifa za biashara kabla ya kusambaza. Hamisha ufunguo wa API, nambari ya mpigaji iliyounganishwa, na mpokeaji wako wa majaribio kama ilivyoelezwa katika README iliyotengenezwa. npm run deploy au python deploy.py huunda au husasisha ejenti, husambaza rasimu yake, na hupiga simu ya majaribio inayotozwa. Hati hizi hutumia uthibitishaji wa ufunguo wa API; CLI na kifungashi cha stdio MCP pia vinaunga mkono kuingia kwa kifaa. Hati za Python zinahitaji Python 3.9 au toleo la baadaye.