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 سرونگ
stdout کو MCP پروٹوکول کے لیے مخصوص رکھتی ہے۔
| کمانڈ | مقصد |
|---|---|
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 | امریکہ کا ان باؤنڈ نمبر فراہم کریں |
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 کی ملکیت والے نمبر سے نہیں بھیجتا۔ 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 یا اس کے بعد کا ورژن درکار ہے۔