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 પર જાય છે; ભૂલો nonzero exit code સાથે stderr પર જાય છે.
--json વિના, આઉટપુટ સંક્ષિપ્ત ટેબલ અથવા ફીલ્ડ સૂચિ હોય છે.
JSON API પ્રતિસાદનું માળખું જાળવે છે, જેમાં credential ફીલ્ડ્સ redacted હોય છે. MCP serving
MCP protocol માટે stdout અનામત રાખે છે.
| કમાન્ડ | હેતુ |
|---|---|
login [--no-browser] [--scope "scopes"] | device code દ્વારા અધિકૃત કરો |
logout, whoami | સ્થાનિક credentials દૂર કરો; ઍક્સેસ કરી શકાય તેવી organizations ની સૂચિ આપો |
agents list, agents get ID | એજન્ટ્સ વાંચો |
agents create --file agent.json | એજન્ટ બનાવો |
agents update ID --file agent.json | એજન્ટ draft સાચવો |
agents deploy ID, agents delete ID | draft deploy કરો; એજન્ટ કાઢી નાખો |
numbers list | ફોન નંબરો વાંચો |
numbers provision --country US --area-code 415 | US inbound નંબર provision કરો |
numbers assign NUMBER_ID --agent ID | inbound એજન્ટ સોંપો |
sms send TO --from FROM --body TEXT --idempotency-key KEY | સુરક્ષિત replay સાથે ગ્રાહક-કનેક્ટેડ carrier નંબર દ્વારા SMS મોકલો |
sms list [--limit N], sms get UUID | SMS records ની સૂચિ આપો અથવા તપાસો |
call TO --agent ID --from FROM [--wait] | outbound કૉલ કરો; વૈકલ્પિક રીતે તેના transcript ની રાહ જુઓ |
calls list [--limit N] [--agent ID] | કૉલ્સની સૂચિ આપો (limit 1–200) |
calls get ID, calls transcript ID | એક કૉલ અથવા તેનો transcript વાંચો |
test run AGENT_ID [--scenario ID] --consent-to-charge | web channel નો ઉપયોગ કરીને billable saved scenarios ચલાવો |
test status RUN_ID [--agent ID] | batch તપાસો, એજન્ટ આપેલ હોય ત્યારે scenario વિગતો સાથે |
import VENDOR export.json | સમીક્ષા માટે vendor JSON import તૈયાર કરો |
imports get UUID, imports commit UUID | import તપાસો; સમીક્ષા પછી પસંદ કરેલા એજન્ટ્સ commit કરો |
mcp setup, mcp serve | client configure કરો; stdio bridge શરૂ કરો |
init [directory] | project scaffold કરો |
outbound કૉલ્સ માટે outbound-enabled નંબર જરૂરી છે. THUNDERPHONE_FROM_NUMBER
--from આપી શકે છે. ગ્રાહકના VoIP નંબરો outbound કૉલ્સને સમર્થન આપવાનું ચાલુ રાખે છે.
ThunderPhone દ્વારા provision કરાયેલા નંબરો શરૂઆતમાં માત્ર inbound હોય છે; organization admin
Phone Numbers પેજ પરથી outbound calling માટે વિનંતી કરી શકે છે, જ્યાં દરેક વિનંતીની
મેન્યુઅલી સમીક્ષા થાય છે. --wait મૂળભૂત રીતે એક કલાકના timeout પર સેટ હોય છે; તેને બદલવા માટે
--timeout SECONDS સેટ કરો. timeout કૉલ સમાપ્ત કર્યા વિના રાહ જોવાનું બંધ કરે છે.
SMS માટે તમારા કનેક્ટેડ Twilio અથવા Telnyx account પર SMS-capable નંબર પણ જરૂરી છે. તે ક્યારેય ThunderPhone-માલિકીના નંબર પરથી મોકલાતો નથી. idempotency key નો ફરીથી ઉપયોગ ફક્ત ચોક્કસ એ જ sender, recipient અને body ને retry કરતી વખતે કરો.
Imports vapi, retell, elevenlabs, અને bland ને સમર્થન આપે છે. બીજું argument
vendor JSON export નો path છે, remote vendor ID નથી. API mapping
asynchronously તૈયાર કરે છે; તેને imports get UUID વડે તપાસો અને તે તૈયાર થયા પછી જ
અને તમે mapped fields તથા warnings ની સમીક્ષા કરી લો પછી જ commit કરો. agent imports જુઓ.
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 ક્રેડેન્શિયલ ફાઇલનો ઉપયોગ કરતું નથી. કોઈપણ
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 અથવા પછીનું સંસ્કરણ જરૂરી છે.