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 ડિવાઇસ-ફ્લો રોલઆઉટની જરૂર છે. 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 work

THUNDERPHONE_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 IDdraft deploy કરો; એજન્ટ કાઢી નાખો
numbers listફોન નંબરો વાંચો
numbers provision --country US --area-code 415US inbound નંબર provision કરો
numbers assign NUMBER_ID --agent IDinbound એજન્ટ સોંપો
sms send TO --from FROM --body TEXT --idempotency-key KEYસુરક્ષિત replay સાથે ગ્રાહક-કનેક્ટેડ carrier નંબર દ્વારા SMS મોકલો
sms list [--limit N], sms get UUIDSMS 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-chargeweb channel નો ઉપયોગ કરીને billable saved scenarios ચલાવો
test status RUN_ID [--agent ID]batch તપાસો, એજન્ટ આપેલ હોય ત્યારે scenario વિગતો સાથે
import VENDOR export.jsonસમીક્ષા માટે vendor JSON import તૈયાર કરો
imports get UUID, imports commit UUIDimport તપાસો; સમીક્ષા પછી પસંદ કરેલા એજન્ટ્સ commit કરો
mcp setup, mcp serveclient 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 અથવા પછીનું સંસ્કરણ જરૂરી છે.