ThunderPhone v3 је сада доступан.Почните самостално, већ од 2 ¢/мин.Прочитајте објаву

Getting Started

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 work

THUNDERPHONE_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 или новију верзију.