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 డివైస్-ఫ్లో విడుదల అవసరం. THUNDERPHONE_API_KEYలోని సంస్థ API
కీ కూడా కమాండ్లను ప్రామాణీకరించగలదు మరియు నిల్వ చేసిన లాగిన్ క్రెడెన్షియల్ల కంటే ప్రాధాన్యత పొందుతుంది.
క్రెడెన్షియల్లు ప్రొఫైల్ వారీగా ~/.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 కోసం --api-base-url లేదా THUNDERPHONE_API_BASE_URLను ఉపయోగించండి. ఒక ప్రొఫైల్ టోకెన్ను
వేరుగా కాన్ఫిగర్ చేసిన API URLకు పంపలేరు; ఆ URLలో ప్రత్యేక ప్రొఫైల్తో లాగ్ ఇన్ చేయండి.
కమాండ్లు
ప్రతి కమాండ్ --jsonను స్వీకరిస్తుంది. విజయవంతమైన డేటా stdoutకు వెళ్తుంది; లోపాలు సున్నా కాని ఎగ్జిట్ కోడ్తో stderrకు వెళ్తాయి. --json లేకుండా, అవుట్పుట్ సంక్షిప్త పట్టిక లేదా ఫీల్డ్ జాబితాగా ఉంటుంది. JSON, క్రెడెన్షియల్ ఫీల్డ్లను తొలగించి, API ప్రతిస్పందన నిర్మాణాన్ని అలాగే ఉంచుతుంది. MCP సర్వింగ్, MCP ప్రోటోకాల్ కోసం stdoutను కేటాయిస్తుంది.
| కమాండ్ | ఉద్దేశ్యం |
|---|---|
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 | US ఇన్బౌండ్ నంబర్ను ప్రొవిజన్ చేయండి |
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ను సెట్ చేయండి. టైమ్అవుట్ కాల్ను ముగించకుండా వేచి ఉండడాన్ని ఆపుతుంది.
మీ కనెక్ట్ చేసిన Twilio లేదా Telnyx ఖాతాలో SMS-సామర్థ్యం గల నంబర్ కూడా SMS కోసం అవసరం. ఇది ThunderPhone యాజమాన్యంలోని నంబర్ నుండి ఎప్పుడూ పంపదు. ఖచ్చితంగా అదే పంపినవారు, స్వీకర్త, మరియు బాడీని మళ్లీ ప్రయత్నిస్తున్నప్పుడు మాత్రమే ఐడెంపోటెన్సీ కీని మళ్లీ ఉపయోగించండి.
దిగుమతులు vapi, retell, elevenlabs, మరియు blandకు మద్దతు ఇస్తాయి. రెండవ ఆర్గ్యుమెంట్
రిమోట్ వెండర్ ID కాదు, వెండర్ JSON ఎగుమతికి సంబంధించిన పాత్. 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. ప్రాజెక్ట్ స్కోప్ డిఫాల్ట్. డెస్క్టాప్ మరియు Windsurfకు యూజర్ స్కోప్ అవసరం.
ప్రాజెక్ట్ నుంచి ఒకే క్లయింట్ను గుర్తించడానికి --clientను వదిలివేయండి; గుర్తింపులో అస్పష్టత ఉంటే
ఇంటరాక్టివ్గా ప్రాంప్ట్ చేస్తుంది లేదా నాన్-ఇంటరాక్టివ్ సెషన్లో సూచనలతో విఫలమవుతుంది.
సెటప్ తాను రాసిన ఫైల్ను చూపిస్తుంది మరియు సంబంధం లేని సర్వర్లను అలాగే ఉంచుతుంది. ఇప్పటికే ఉన్న JSON
చెల్లుబాటు అయ్యే కఠినమైన JSON అయి ఉండాలి; Codex TOML విలువలు భద్రపరచబడతాయి, కానీ వ్యాఖ్యలు మళ్లీ ఫార్మాట్ కావచ్చు.
సెటప్ నేరుగా రిమోట్ HTTPని ప్రాధాన్యంగా ఎంచుకుంటుంది. --api-key-envతో, కీని ఎప్పుడూ రాయకుండా
వేరియబుల్ రిఫరెన్స్ను రాస్తుంది. ఆ ఎంపిక లేకుండా, నేరుగా HTTP క్లయింట్ యొక్క
OAuth మద్దతుపై ఆధారపడుతుంది; ఇది CLI క్రెడెన్షియల్ ఫైల్ను ఉపయోగించదు. ఏదైనా stdio-సామర్థ్యం ఉన్న క్లయింట్లో
thunderphone login క్రెడెన్షియల్స్ను మళ్లీ ఉపయోగించడానికి, వీటిని ఉపయోగించండి:
{
"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ను గ్లోబల్గా ఇన్స్టాల్ చేసిన తర్వాత
thunderphone-mcp setup ద్వారా అందుబాటులో ఉంటుంది.
ప్రాజెక్ట్ను సృష్టించండి
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, డిప్లాయ్ స్క్రిప్ట్లు, Claude Code, Cursor మరియు VS Code కోసం MCP కాన్ఫిగరేషన్లు,
ఏజెంట్ సూచనలు, .env.example, మరియు ఒక README ఉంటాయి. స్కాఫోల్డింగ్ ఆఫ్లైన్లో జరుగుతుంది మరియు ఖాళీ కాని డైరెక్టరీని
ఓవర్రైట్ చేయడానికి నిరాకరిస్తుంది.
డిప్లాయ్మెంట్కు ముందు వ్యాపార వివరాలను సవరించండి. రూపొందించిన READMEలో డాక్యుమెంట్ చేసిన విధంగా API కీ, కనెక్ట్ చేసిన కాలర్
నంబర్, మరియు మీ పరీక్ష స్వీకర్తను ఎక్స్పోర్ట్ చేయండి. npm run deploy
లేదా python deploy.py ఏజెంట్ను సృష్టిస్తుంది లేదా అప్డేట్ చేస్తుంది, దాని డ్రాఫ్ట్ను డిప్లాయ్ చేస్తుంది, మరియు బిల్ అయ్యే పరీక్ష కాల్ను చేస్తుంది.
స్క్రిప్ట్లు API-కీ ఆథెంటికేషన్ను ఉపయోగిస్తాయి; CLI మరియు stdio MCP
ర్యాపర్ పరికర లాగిన్కు కూడా మద్దతు ఇస్తాయి. Python స్క్రిప్ట్లకు Python 3.9 లేదా తదుపరి వెర్షన్ అవసరం.