Open in
ThunderPhone CLI
Пријавите се, управљајте гласовним агентима и позивима, конфигуришите MCP клијенте и креирајте основу за пројекте из терминала.
CLI захтева Node.js 18.18 или новији. Покрените га помоћу npx или га инсталирајте глобално:
npm install -g thunderphone
thunderphone --helpПријавите се
npx thunderphone login
thunderphone whoami --jsonПријава приказује верификациони код, отвара прегледач и чека ауторизацију.
На рачунару без графичког окружења користите --no-browser, а приказани URL отворите на другом месту.
Пријава уређаја захтева да API подржава OAuth ток за уређаје. API кључ организације
у THUNDERPHONE_API_KEY такође може да аутентификује команде и има предност
у односу на сачуване акредитиве за пријаву.
Акредитиви се чувају по профилу у ~/.config/thunderphone/credentials.json
са режимом датотеке 0600. XDG_CONFIG_HOME и THUNDERPHONE_CONFIG_DIR мењају
директоријум. Приступни токени се аутоматски освежавају, а ротирајући токени за освежавање
се чувају атомски. Пријава никада не приказује токене.
thunderphone login --profile work
thunderphone agents list --profile work --json
thunderphone logout --profile workTHUNDERPHONE_PROFILE поставља подразумевани профил. Одјављивање уклања локалне акредитиве;
не опозива овлашћење сервера. Промена или ресетовање лозинке, или
промена е-адресе налога, опозива га; поново покрените thunderphone login. Подразумевани API је https://api.thunderphone.com.
Користите --api-base-url или THUNDERPHONE_API_BASE_URL за други API. Токен профила
не може да се пошаље на другу конфигурисану API URL адресу; пријавите се на тај URL помоћу засебног профила.
Команде
Свака команда прихвата --json. Успешни подаци се шаљу на stdout; грешке се шаљу на stderr
са излазним кодом различитим од нуле. Без --json, излаз је компактна табела или листа поља.
JSON задржава структуру API одговора, са редигованим пољима акредитива. MCP послуживање
резервише stdout за MCP протокол.
| Команда | Сврха |
|---|---|
login [--no-browser] [--scope "scopes"] | Ауторизујте се путем кода уређаја |
logout, whoami | Уклоните локалне акредитиве; прикажите доступне организације |
agents list, agents get ID | Прикажите агенте |
agents create --file agent.json | Креирајте агента |
agents update ID --file agent.json | Сачувајте нацрт агента |
agents deploy ID, agents delete ID | Објавите нацрт; избришите агента |
numbers list | Прикажите бројеве телефона |
numbers provision --country US --area-code 415 | Обезбедите амерички долазни број |
numbers assign NUMBER_ID --agent ID | Доделите долазног агента |
sms send TO --from FROM --body TEXT --idempotency-key KEY | Пошаљите SMS преко броја оператера повезаног са налогом клијента, уз безбедно понављање |
sms list [--limit N], sms get UUID | Прикажите или прегледајте SMS записе |
call TO --agent ID --from FROM [--wait] | Упутите одлазни позив; по жељи сачекајте његов транскрипт |
calls list [--limit N] [--agent ID] | Прикажите позиве (ограничење 1–200) |
calls get ID, calls transcript ID | Прикажите један позив или његов транскрипт |
test run AGENT_ID [--scenario ID] --consent-to-charge | Покрените сачуване сценарије који се наплаћују помоћу веб канала |
test status RUN_ID [--agent ID] | Прегледајте пакет, са детаљима сценарија када је наведен агент |
import VENDOR export.json | Припремите увоз JSON датотеке добављача за преглед |
imports get UUID, imports commit UUID | Прегледајте увоз; потврдите изабране агенте након прегледа |
mcp setup, mcp serve | Конфигуришите клијент; покрените stdio мост |
init [directory] | Креирајте основу пројекта |
За одлазне позиве је потребан број омогућен за одлазне позиве. THUNDERPHONE_FROM_NUMBER може
да обезбеди --from. VoIP бројеви клијената и даље подржавају одлазне позиве.
Бројеви које је обезбедио ThunderPhone у почетку су само за долазне позиве; администратор организације може
да затражи одлазне позиве на страници Бројеви телефона, где се сваки захтев
ручно прегледа. --wait подразумевано има временско ограничење од једног сата; подесите
--timeout SECONDS да бисте га променили. Временско ограничење престаје да чека без прекида позива.
За SMS је такође потребан број који подржава SMS на вашем повезаном Twilio или Telnyx налогу. SMS се никада не шаље са броја у власништву ThunderPhone-а. Кључ идемпотентности поново користите само када покушавате поново да пошаљете потпуно исти број пошиљаоца, примаоца и текст поруке.
Увоз подржава vapi, retell, elevenlabs и bland. Други аргумент је
путања до JSON извоза добављача, а не удаљени ID добављача. API асинхроно припрема
мапирање; прегледајте га помоћу imports get UUID и потврдите га тек када буде спремно
и након што прегледате мапирана поља и упозорења. Погледајте увоз агената.
Подешавање 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Клијенти: claude-code, codex, cursor, vscode, gemini, claude-desktop и
windsurf. Опсег пројекта је подразумевани. Desktop и Windsurf захтевају кориснички опсег.
Изоставите --client да бисте открили један клијент из пројекта; нејасно откривање
интерактивно тражи избор или не успева са упутствима у неинтерактивној сесији.
Подешавање исписује датотеку коју је уписало и чува неповезане сервере. Постојећи JSON
мора бити важећи строги JSON; Codex TOML вредности се чувају, али коментари могу бити поново форматирани.
Подешавање даје предност директном удаљеном HTTP-у. Са --api-key-env, уписује референцу
на променљиву, никада кључ. Без те опције, директни HTTP се ослања на OAuth подршку
клијента; не користи датотеку CLI акредитива. Да бисте поново користили акредитиве из thunderphone login
у било ком клијенту који подржава stdio, користите:
{
"mcpServers": {
"thunderphone": {
"command": "npx",
"args": ["-y", "@thunderphone/mcp"]
}
}
}Омотач проверава THUNDERPHONE_API_KEY, затим тренутни CLI профил (освежавајући га
када је потребно), а затим делегира OAuth услузи mcp-remote. THUNDERPHONE_MCP_URL замењује
крајњу тачку. Не шаље телеметрију. Самостално подешавање је такође доступно преко
npx -y @thunderphone/mcp setup --client cursor или thunderphone-mcp setup након
глобалне инсталације пакета @thunderphone/mcp.
Креирајте пројекат
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Шаблони су node и python; типови агента су receptionist, outbound и
custom. Подразумевани агент је стоматолошки рецепционар на енглеском и шпанском са изричито
наведеним демо чињеницама. Пројекти укључују agent.json, скрипте за примену, MCP конфигурације за
Claude Code, Cursor и VS Code, упутства за агента, .env.example и README.
Генерисање структуре ради ван мреже и одбија да препише непразан директоријум.
Пре примене измените пословне чињенице. Извезите API кључ, повезани број позиваоца
и примаоца за тестирање, како је документовано у генерисаном README-ју. npm run deploy
или python deploy.py креира или ажурира агента, примењује његов нацрт и упућује
наплативи пробни позив. Скрипте користе аутентификацију API кључем; CLI и stdio MCP
омотач такође подржавају пријављивање уређајем. Python скрипте захтевају Python 3.9 или новију верзију.