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-க்குச் சொந்தமான எண்ணிலிருந்து ஒருபோதும் அனுப்பாது. ஒரே அனுப்புநர், பெறுநர் மற்றும் உடலுடன் துல்லியமாக மீண்டும் முயற்சிக்கும்போது மட்டுமே idempotency விசையை மீண்டும் பயன்படுத்தவும்.
இறக்குமதிகள் 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 சான்று கோப்பைப் பயன்படுத்தாது. எந்த 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 அல்லது அதற்குப் பிந்தைய பதிப்பு தேவை.