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 सेट करा. टाइमआउट कॉल समाप्त न करता प्रतीक्षा थांबवतो.
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. प्रोजेक्ट स्कोप डीफॉल्ट आहे. डेस्कटॉप आणि 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 किंवा नंतरची आवृत्ती आवश्यक आहे.