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 پر جاتا ہے؛ غلطیاں غیر صفر ایگزٹ کوڈ کے ساتھ 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 UUIDSMS ریکارڈز کی فہرست دیکھیں یا ان کا معائنہ کریں
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 یا اس کے بعد کا ورژن درکار ہے۔