Open in
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 --helpIngia
npx thunderphone login
thunderphone whoami --jsonKuingia 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 workTHUNDERPHONE_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.
| Amri | Kusudi |
|---|---|
login [--no-browser] [--scope "scopes"] | Idhinisha kupitia msimbo wa kifaa |
logout, whoami | Ondoa vitambulisho vya ndani; orodhesha mashirika yanayoweza kufikiwa |
agents list, agents get ID | Soma ejenti |
agents create --file agent.json | Unda ejenti |
agents update ID --file agent.json | Hifadhi rasimu ya ejenti |
agents deploy ID, agents delete ID | Weka rasimu hewani; futa ejenti |
numbers list | Soma nambari za simu |
numbers provision --country US --area-code 415 | Toa nambari ya Marekani ya simu zinazoingia |
numbers assign NUMBER_ID --agent ID | Weka ejenti wa simu zinazoingia |
sms send TO --from FROM --body TEXT --idempotency-key KEY | Tuma SMS kupitia nambari ya mtoa huduma iliyounganishwa na mteja kwa urudiaji salama |
sms list [--limit N], sms get UUID | Orodhesha 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 ID | Soma simu moja au transkripti yake |
test run AGENT_ID [--scenario ID] --consent-to-charge | Endesha 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.json | Andaa uagizaji wa JSON wa mtoa huduma kwa ukaguzi |
imports get UUID, imports commit UUID | Kagua uagizaji; thibitisha ejenti waliochaguliwa baada ya ukaguzi |
mcp setup, mcp serve | Sanidi 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 userWateja 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 receptionistViolezo 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.