ThunderPhone v3 اب لائیو ہے۔سیلف سرو، قیمت 2¢ فی منٹ سے شروع۔اعلان پڑھیں

Getting Started

بنیادی تصورات

پلیٹ فارم میں موجود ہر چیز کا نقشہ — ہر آبجیکٹ کیا کرتا ہے، ڈیش بورڈ میں کہاں موجود ہے، اور کون سا API اس سے متعلق ہے۔

ThunderPhone، AI وائس ایجنٹس بنانے، چلانے اور بہتر کرنے کے لیے ایک مکمل پلیٹ فارم ہے۔ یہ صفحہ نقشہ ہے: ہر وہ تصور جس سے آپ کا سامنا ہوگا، ہر ایک کے لیے ایک مختصر سیکشن، ساتھ ہی ڈیش بورڈ اور اسے سہارا دینے والی API۔ اسے ایک بار سرسری دیکھ لیں، پھر جب بھی کسی اصطلاح کی وضاحت درکار ہو واپس آئیں۔

پرانے ڈیش بورڈ ویو کا سائیڈبار اسی ساخت کی عکاسی کرتا ہے:

انگیجمنٹ

لائیو مانیٹرنگ اور آؤٹ باؤنڈ مہمات۔

کنکشنز

ایپس، APIs، MCP سرورز، اور VoIP فراہم کنندگان جنہیں آپ کے ایجنٹس استعمال کر سکتے ہیں۔

ایونٹس

آپ کے اپنے کوڈ کے لیے ویب ہکس اور فنکشن ٹولز۔


تنظیمیں

ایک تنظیم ٹیننسی کی اکائی ہے۔ ہر دوسرا وسیلہ — ایجنٹس، فون نمبرز، کالز، کلیدیں — صرف ایک تنظیم سے تعلق رکھتا ہے۔ آپ کا اکاؤنٹ متعدد تنظیموں سے تعلق رکھ سکتا ہے؛ ہر تنظیم کا اپنا بیلنس، اپنی کلیدیں، اور اپنے اراکین کی فہرست ہوتی ہے۔

جو sk_live_ API کلید آپ انضمامات → API کلیدیں کے تحت بناتے ہیں (تنظیم کا مینو؛ پرانے منظر میں تنظیم → کلیدیں) ایک تنظیم سے منسلک ہوتا ہے۔ یہی وابستگی REST API کو اتنا سادہ بناتی ہے: آپ URL راستوں میں کبھی org id شامل نہیں کرتے، کیونکہ آپ کی کلید اسے پہلے ہی شناخت کرتی ہے۔

ڈیش بورڈ میں: تنظیم سوئچر (سائڈبار فوٹر) اور تنظیم کی ترتیبات — میرا اکاؤنٹ، عمومی، کلیدیں، الرٹس، بلنگ کی ترتیبات، اور بلنگ ہسٹری کے ٹیبز۔ تنظیم کی ترتیبات کے حوالہ کو دیکھیں۔

API میں: /v1/orgs، /v1/developer/api-keys۔


ایجنٹس

ایک ایجنٹ وہ AI کنفیگریشن ہے جو کال چلاتی ہے۔ اس میں شامل ہیں:

  • ایک پرامپٹ جو طے کرتا ہے کہ ایجنٹ کیا کہتا ہے اور کیسے رویہ اختیار کرتا ہے — جس میں کال کی کارروائیاں، جیسے ٹرانسفرز، کی پیڈ دبانا، اور کال ختم کرنا شامل ہیں، جو الگ کنفیگریشن کے بجائے سادہ پرامپٹ لائنیں ہوتی ہیں۔
  • اس کی ترتیبات: ذہانت (Core یا Pro)، سماعت (Lite، Standard، Plus یا Max) اور جواب کی رفتار، جو لاگت، رفتار اور درستگی کے درمیان توازن پیدا کرتی ہیں۔
  • ایک آواز کے ساتھ ایک بنیادی زبان اور اختیاری اضافی زبانیں — کال کرنے والا زبان تبدیل کرے تو ایجنٹ خودکار طور پر تبدیل ہو جاتا ہے۔ دیکھیں معاون زبانیں۔
  • منسلک صلاحیتیں: منسلک ایپس، API کنکشنز، نالج بیسز، MCP سرورز، اور اِن لائن فنکشن ٹولز۔
  • رویے کے کنٹرولز: بولنے کی ترتیب، تصدیقی موڈ، بیک گراؤنڈ ٹریک، ہولڈ ٹائم آؤٹ۔

بلڈر میں کی گئی ترامیم خودکار طور پر ڈرافٹ میں محفوظ ہو جاتی ہیں؛ جب تک آپ تعینات کریں پر کلک نہیں کرتے، کچھ بھی فعال نہیں ہوتا۔ ہر تعیناتی کا اسنیپ شاٹ بلڈر کے ہسٹری ٹیب میں محفوظ ہوتا ہے، تاکہ آپ کسی بھی سابقہ ورژن کا جائزہ لے سکیں اور اسے بحال کر سکیں۔

ڈیش بورڈ میں: وائس ایجنٹس → ایجنٹ بلڈر (/dashboard/agents)۔ دیکھیں اپنا پہلا وائس ایجنٹ بنائیں۔

API میں: /v1/agents — CRUD، نقل بنانا، ٹرانسفر، ورژن ہسٹری، اور پرامپٹ معاونات۔


آوازیں

وائس لائبریری میں وہ آوازیں شامل ہیں جو ایک ایجنٹ استعمال کر سکتا ہے، ان کے چلائے جا سکنے والے نمونے، موافق زبانیں، جنس اور لہجے کی گروہ بندیاں، اور یہ کہ کون سی آوازیں پریمیم ہیں۔ انتخاب سے پہلے ایک بامعاوضہ سیمپلر آپ کے اپنے 1–500 حروف پر مشتمل فقرے کو سنتھیسائز کر سکتا ہے۔

اہل تنظیمیں مختصر WAV یا MP3 نمونے سے حسب ضرورت آوازیں بھی بنا سکتی ہیں۔ حسب ضرورت آوازوں کی ایک کوٹہ حد اور غیر ہم وقت تخلیق کی حالت ہوتی ہے؛ تیار ہونے پر، وہ لائبریری آوازوں کے ساتھ اسی ایجنٹ چننے والے میں ظاہر ہوتی ہیں۔

ڈیش بورڈ میں: آوازیں (/dashboard/voices)۔ وائس لائبریری اور حسب ضرورت آوازیں دیکھیں۔

API میں: /v1/voices، وائس نمونے، اور حسب ضرورت آوازیں۔


فون نمبرز

ایک فون نمبر کسی تنظیم سے متعلق ہوتا ہے اور آنے والی کالز کو ایک ایجنٹ تک روٹ کرتا ہے (اور باہر جانے والی کالز بھی سنبھال سکتا ہے)۔ دو ذرائع:

  • ThunderPhone نمبرز — ThunderPhone کے پول سے فراہم کیے گئے حقیقی امریکی نمبرز، جو چند سیکنڈز میں فعال ہو جاتے ہیں، $1 فی ماہ؛ ان کے کال منٹس کا بل فون لائن کے طور پر لیا جاتا ہے۔ ابتدا میں یہ صرف آنے والی کالز کے لیے ہوتے ہیں۔ تنظیم کا منتظم فون نمبرز صفحے سے باہر جانے والی کالنگ کی درخواست کر سکتا ہے؛ ThunderPhone ہر درخواست کا دستی طور پر جائزہ لیتا ہے، اور منظور شدہ نمبرز کالز کر سکتے ہیں اور مہمات چلا سکتے ہیں۔ ایک تنظیم بطور ڈیفالٹ 25 نمبرز رکھ سکتی ہے۔
  • VoIP نمبرز — آپ کے اپنے فراہم کنندہ سے VoIP کنکشن کے ذریعے لائے جاتے ہیں۔ Twilio اور Telnyx براہِ راست API کلید کے ساتھ منسلک ہوتے ہیں (Telnyx میں رہنمائی کے ساتھ نیا اکاؤنٹ سیٹ اپ بھی شامل ہے)؛ SignalWire، Vonage، Plivo اور کوئی بھی دیگر SIP ٹرنک SIP سیٹ اپ، یعنی دستی SIP کنفیگریشن، کے ذریعے منسلک ہوتے ہیں۔ درآمد اور تصدیق کے بعد، VoIP نمبرز آنے والی اور باہر جانے والی کالز کی معاونت کرتے ہیں۔

ہر نمبر کی قطار میں آپ روٹنگ موڈ سیٹ کر سکتے ہیں، آنے والی کالز کے لیے ایجنٹ منتخب کر سکتے ہیں، اور نمبر کو لیبل دے سکتے ہیں۔

ڈیش بورڈ میں: فون نمبرز (/dashboard/phone-numbers)۔ فون نمبر حاصل کریں دیکھیں۔

API میں: /v1/phone-numbers، /v1/voip-connections، /v1/phone-number-labels۔


کالز

ہر آنے والی کال، باہر جانے والی کال، سیمولیشن، اور ویجیٹ سیشن ایک کال لاگ بن جاتا ہے۔ ایک کال میں مکمل کردار-ٹیگ شدہ ٹرانسکرپٹ، ساختہ ٹرن ہسٹری (بشمول ٹول کالز)، ریکارڈنگ، بلنگ کا کل، اور اختیاری AI گریڈنگ اور مسئلے کی رپورٹس شامل ہوتی ہیں۔

جب کوئی کال لائیو ہو، تو آپ اسے کھول کر سنیں — آپ خاموشی سے شامل ہوتے ہیں، اور کال پر موجود کوئی بھی آپ کو نہیں سنتا۔ سننے کے بعد، آپ سرگوشی کر سکتے ہیں: کال کے دوران اپنے ایجنٹ کو براہ راست جانے والی ہدایت لکھیں؛ کال کرنے والا اسے کبھی نہیں سنتا، اور ایجنٹ اس پر فوراً عمل کرتا ہے۔

ڈیش بورڈ میں: آرکائیو اور ہر کال کی تفصیل کے لیے کال ہسٹری (/dashboard/call-history)؛ جاری کالز کے لیے لائیو۔ اپنی کالز کا جائزہ لیں، سنیں، اور رہنمائی کریں دیکھیں۔

API میں: /v1/calls — فہرست، ٹرانسکرپٹ، ہسٹری، آڈیو، گریڈنگ، ایکسپورٹ؛ /v1/issue-reports۔


کلائنٹ پورٹلز

ایک کلائنٹ پورٹل بیرونی کلائنٹ کے لیے برانڈڈ، صرف پڑھنے کے قابل کال ہسٹری منظر ہے۔ تنظیم کے منتظمین ان ایجنٹس کا انتخاب کرتے ہیں جن کی کالز ظاہر ہوں، منظور شدہ دیکھنے والوں کے ای میلز شامل کرتے ہیں، لوگو اور ایکسنٹ رنگ اپ لوڈ کرتے ہیں، اور اختیاری طور پر حسب ضرورت ڈومین کی تصدیق کرتے ہیں۔ پورٹل دیکھنے والے ڈیش بورڈ تک رسائی حاصل کیے بغیر کال کی تفصیلات، ٹرانسکرپٹس، اور دستیاب ریکارڈنگز کا جائزہ لے سکتے ہیں۔

ڈیش بورڈ میں: کلائنٹ پورٹلز (/dashboard/client-portals)۔ کلائنٹ پورٹلز دیکھیں۔

API میں: انتظامی مینجمنٹ سطح کے لیے /v1/client-portals۔

ویب ویجیٹس

ویب ویجیٹ آپ کی سائٹ کے وزیٹرز کو مائیک کے ذریعے ایجنٹ کے ساتھ گفتگو فراہم کرتا ہے — فون نمبر کی ضرورت نہیں۔ یہ ایک قابلِ اشاعت کلید (pk_live_...) کے ذریعے توثیق کرتا ہے جسے براؤزر صرف آپ کے اجازت یافتہ ڈومینز سے استعمال کر سکتے ہیں، لہٰذا یہ کلائنٹ سائیڈ کوڈ میں محفوظ ہے۔ ڈومین کی فہرست توثیق نہیں ہے، اور صفحہ جو سیشن سیٹنگز بھیج سکتا ہے وہ اس وقت تک بند رہتی ہیں جب تک آپ انہیں کلید پر اجازت نہ دیں۔

کلیدیں دو میں سے ایک موڈ میں چلتی ہیں: agent (ایک ایجنٹ کے ساتھ جامد طور پر منسلک) یا webhook (آپ کا سرور ہر وزٹر کے لیے کنفیگریشن منتخب کرتا ہے — ہر کال کے لیے متحرک کنفیگریشن دیکھیں)۔ ویجیٹ سیشنز فون کالز جیسی ہی کال انفراسٹرکچر کے ذریعے گزرتے ہیں۔

ڈیش بورڈ میں: ویب ویجیٹس (/dashboard/web-widgets) — ویجیٹس بنائیں، موڈ اور ایجنٹ سیٹ کریں، منظور شدہ ڈومینز کا انتظام کریں، اور embed snippet کاپی کریں۔ دیکھیں ویب ویجیٹ بنائیں۔

API میں: /v1/publishable-key، /v1/mic-session، اور ویجیٹ SDK دستاویزات۔


نالج بیسز

ایک نالج بیس دستاویزات کا ایسا مجموعہ ہے جس میں آپ کا ایجنٹ اپنے جوابات کو بنیاد دینے کے لیے کال کے دوران تلاش کر سکتا ہے — فائلیں اپ لوڈ کریں، متن پیسٹ کریں، یا URL کے ذریعے ویب صفحات درآمد کریں، پھر builder میں نالج بیس کو کسی ایجنٹ کے ساتھ منسلک کریں۔ گفتگو کے تقاضے کے وقت ایجنٹ بلٹ اِن سرچ ٹول کے ذریعے اس سے استفسار کرتا ہے۔

اگر دستاویز کا درآمد ناکام ہو جائے، تو آپ اسے دوبارہ آزما سکتے ہیں۔ ویب صفحے کی دستاویزات کے لیے، آپ صفحہ دوبارہ حاصل کرنے کے لیے اسے ریفریش بھی کر سکتے ہیں۔ اگر آپ کسی نالج بیس کو حذف کرتے ہیں، تو اس کی دستاویزات محفوظ رہتی ہیں اور اس بیس سے الگ ہو جاتی ہیں۔ جو ایجنٹس اس بیس کو استعمال کرتے تھے وہ ان دستاویزات کو دیکھنا بند کر دیتے ہیں، جب تک کہ آپ انہیں براہِ راست منسلک نہ کریں۔

ڈیش بورڈ میں: دستاویز لائبریری کے لیے نالج (/dashboard/knowledge)؛ کسی ایجنٹ کے ساتھ منسلک کرنے کے لیے builder کا نالج سیکشن۔ دیکھیں اپنے ایجنٹ کو نالج بیس دیں۔


کنکشنز

کنکشنز کے ذریعے ایجنٹس بیرونی دنیا تک پہنچتے ہیں۔ چار اقسام، ایک سائیڈبار گروپ:

  • ایپس (/dashboard/app-connections) — HubSpot، Salesforce، Google Calendar، Google Sheets، اور Cal.com سے کنکشنز۔ ایک بار کنیکٹ کریں، پھر ہر آپریشن کے لیے ٹولز (HubSpot رابطہ اپ سرٹ کرنا، Cal.com سلاٹ بُک کرنا…) کسی بھی ایجنٹ پر فعال کریں۔ ایپس کنیکٹ کریں دیکھیں۔
  • APIز (/dashboard/api-connections) — کسی بھی HTTP API کو ایک ایجنٹ ایکشن میں تبدیل کریں۔ cURL کمانڈ پیسٹ کریں اور AI وزرڈ ٹول کی تعریف کا مسودہ تیار کرے گا، یا اسے دستی طور پر بنائیں؛ ٹیسٹ ریکویسٹ بٹن لانچ کرنے سے پہلے سینڈ باکس کال چلاتا ہے۔ API کنکشنز دیکھیں — یہ /v1/integrations کا ڈیش بورڈ انٹرفیس ہے۔
  • MCP (/dashboard/mcp-connections) — URL کے ذریعے ماڈل کانٹیکسٹ پروٹوکول سرور شامل کریں اور ایجنٹ کو اس کے فراہم کردہ ٹولز استعمال کرنے دیں۔ MCP سرور شامل کریں دیکھیں۔
  • VoIP (/dashboard/voip-connections) — اپنے فون نمبرز لانے کے لیے فراہم کنندہ کی اسناد۔ VoIP فراہم کنندہ کنیکٹ کریں دیکھیں۔

ThunderPhone اپنا MCP endpoint بھی فراہم کرتا ہے تاکہ ایک بیرونی MCP کلائنٹ ایجنٹس کی فہرست دیکھ سکے، کالز اور ٹرانسکرپٹس کا جائزہ لے سکے، اور کالز کر سکے۔ دیکھیں ThunderPhone کو MCP سرور کے طور پر استعمال کریں۔

API میں: /v1/integrations، /v1/mcp-servers، اور /v1/voip-connections؛ نیز دیکھیں ٹول انٹیگریشن بنائیں۔


مہمات

ایک مہم بڑے پیمانے پر آؤٹ باؤنڈ کالز کرتی ہے: رابطوں کی CSV اپ لوڈ کریں، ایجنٹ اور from-number منتخب کریں، اور کالنگ ونڈو (دن اور گھنٹے، ٹائم زون کے لحاظ سے)، بیک وقت کالز، اور دوبارہ کوشش کی پالیسی سیٹ کریں (زیادہ سے زیادہ کوششیں اور کن نتائج — جواب نہ ملنا، وائس میل، ناکام — پر دوبارہ کوشش کی جائے)۔ مہم فہرست میں آگے بڑھتی ہے اور ہر کال کو کال ہسٹری میں ریکارڈ کرتی ہے۔

ڈیش بورڈ میں: مہمات (/dashboard/campaigns)۔ دیکھیں آؤٹ باؤنڈ کالنگ مہم چلائیں۔

ایک بار کی پروگراماتی کالز کے لیے: آؤٹ باؤنڈ کالز API۔

لائیو مانیٹرنگ

لائیو تنظیم بھر میں جاری ہر کال دکھاتا ہے، اور آپ کو ان میں سے کسی کو بھی کھول کر حقیقی وقت میں سننے اور سرگوشی کرنے دیتا ہے۔ یہ نگرانی کا منظر ہے: کسی نئے prompt کو اپنی پہلی حقیقی ٹریفک سنبھالتے ہوئے دیکھیں، یا جاری مہم پر نظر رکھیں۔

ڈیش بورڈ میں: لائیو (/dashboard/live)۔ لائیو کالز دیکھیں اور ان کی نگرانی کریں ملاحظہ کریں۔


سیمولیشنز

ایک سیمولیشن میں AI کالر آپ کے ایجنٹ کے ساتھ حقیقی گفتگو کرتا ہے — وہی ٹیلی فونی راستہ، حقیقی ٹرانسکرپٹ، حقیقی گریڈنگ — تاکہ آپ جاری کرنے سے پہلے (اور بعد میں بھی) ٹیسٹ کر سکیں۔ اسے کسی ایجنٹ یا فون نمبر پر مقرر کریں، کالر کا منظرنامہ خود لکھیں یا ایجنٹ کے prompt سے AI کے ذریعے منظرنامے تیار کریں (اگر آپ کہیں تو غیر معمولی کیسز بھی شامل ہوں گے)، اور کال کو لائیو دیکھیں۔

منظرنامے سوئٹس میں گروپ ہوتے ہیں جو کم از کم پاس ریٹ مقرر کرتے ہیں اور CI میں ریلیزز کو روک سکتے ہیں؛ منظور شدہ بنیادی معیار کے مقابلے میں ہونے والی خرابیوں کی رپورٹ ہر منظرنامے کے لحاظ سے دی جاتی ہے۔

ڈیش بورڈ میں: سیمولیشنز (/dashboard/simulations)، نیز ایجنٹ بلڈر کے اندر سیمولیشن بٹن۔ ایک کال سیمولیٹ کریں ملاحظہ کریں۔

API میں: /v1/test-calls اور سوئٹ رنر — ایجنٹ کو ابتدا سے انتہا تک ٹیسٹ کریں ملاحظہ کریں۔


توثیقی سیٹس

ایک توثیقی سیٹ حقیقی کال کے لمحات کو دہرائے جا سکنے والے، سنگل ٹرن ریگریشن چیکس میں تبدیل کرتا ہے۔ ہر مثال گفتگو کا سیاق، متعلقہ کالر آڈیو، اصل جواب، اور متوقع رویہ منجمد کر دیتی ہے۔ ری پلے کوئی دوسری کال کیے بغیر موجودہ ایجنٹ ڈرافٹ کے خلاف چلتے ہیں، اور ڈپلائے ڈائیلاگ دکھا سکتا ہے کہ آیا تازہ ترین رن اب بھی اس ڈرافٹ سے مطابقت رکھتا ہے۔

ڈیش بورڈ میں: تنظیم کے ڈیٹاسیٹ کے لیے توثیقی سیٹس (/dashboard/validation) اور رنز کے لیے ایجنٹ بلڈر کا توثیق ٹیب۔ توثیقی سیٹس ملاحظہ کریں۔

API میں: /v1/validation-sets اور اسی ریفرنس صفحے پر ایجنٹ/مثال ری پلے اینڈ پوائنٹس۔


تجربات

ایک تجربہ لائیو ٹریفک پر ایجنٹ کنفیگریشنز کا A/B ٹیسٹ کرتا ہے: ویریئنٹس مقرر کریں (مختلف prompts، انجنز، یا سیٹنگز)، ان کے درمیان ٹریفک تقسیم کریں، اور ہر ویریئنٹ کے نتائج کا موازنہ کریں۔ ویب ہک میں بکٹ لاجک خود بنانے کے بجائے اسے استعمال کریں۔

ڈیش بورڈ میں: تجربات (/dashboard/experiments) اور ایجنٹ بلڈر میں A/B ٹیب۔ تجربات (A/B ٹیسٹنگ) ملاحظہ کریں۔


مسائل

ایک مسئلہ کسی مخصوص کال میں نشان زدہ خرابی ہے — جسے انسانی جائزہ کار نے درج کیا ہو یا AI گریڈنگ نے شناخت کیا ہو۔ مسائل میں شدت، ماخذ، اور اسٹیٹس شامل ہوتے ہیں، اور مسائل کا صفحہ ٹرائیج قطار ہے: فلٹر کریں، مسئلہ والی کال کا جائزہ لیں، اور اصلاحات کو ٹریک کریں۔

ڈیش بورڈ میں: مسائل (/dashboard/issues)، نیز کال ہسٹری میں ہر کال کے لیے نشان زد کرنا۔ مسائل کی ٹرائیج ملاحظہ کریں۔

API میں: /v1/issue-reports۔


رپورٹس

ایک رپورٹ آپ کے کال ڈیٹا سے متعلق قدرتی زبان کے سوال کا جواب دیتی ہے ("گزشتہ ہفتے کالرز نے انسانی نمائندے کے لیے سب سے زیادہ کون سی تین وجوہات پوچھی تھیں؟")، جس میں AI کی تحریر کردہ تجزیاتی رپورٹ ہوتی ہے اور دائرہ آپ کے منتخب کردہ ایجنٹس اور تاریخ کی حد تک محدود ہوتا ہے۔

ڈیش بورڈ میں: رپورٹس (/dashboard/reports)۔ رپورٹس ملاحظہ کریں۔


مشاہدہ پذیری

مشاہدہ پذیری میٹرکس کا منظر ہے: وقت کے ساتھ کال کا حجم، نتائج، اور معیار، جنہیں ایجنٹ اور وقت کی ونڈو کے لحاظ سے فلٹر کیا جا سکتا ہے، اور بعد کے تجزیے کے لیے ایکسپورٹ بھی دستیاب ہے۔

ڈیش بورڈ میں: مشاہدہ پذیری (/dashboard/observability)۔ مشاہدہ پذیری ملاحظہ کریں۔


الرٹس

ایک الرٹ رول کسی میٹرک (کامیابی کی شرح، ناکامی کی شرح، اوسط اسکور، کال کا حجم، سوئٹ ریگریشنز) کو وقت کی ایک ونڈو میں دیکھتا ہے اور آپ کی حد عبور ہونے پر فعال ہو جاتا ہے۔ نوٹیفکیشن ای میل اور Slack پر جاتے ہیں، اور آپ کے ویب ہک اینڈ پوائنٹس کو alert.triggered ایونٹ بھیجتے ہیں۔

ڈیش بورڈ میں: تنظیم → الرٹس۔ الرٹس ملاحظہ کریں۔


ویب ہکس

ThunderPhone آپ کے سرور کو HTTP POST ویب ہکس بھیجتا ہے جب کال کے دوران یا بعد میں کوئی واقعہ پیش آئے۔ ڈیلیوری کے دو ماڈلز ہیں:

  • ویب ہک اینڈ پوائنٹس (تجویز کردہ): متعدد URLs کو /v1/developer/webhook-endpoints پر فی اینڈ پوائنٹ رازوں اور فی اینڈ پوائنٹ ایونٹ سبسکرپشنز کے ساتھ منظم کریں۔
  • لیگیسی واحد-URL ویب ہک: ہر تنظیم کے لیے ایک URL۔ اسے /v1/webhook پر یا تنظیم → عمومی کے تحت منظم کریں۔ پسماندہ مطابقت کے لیے برقرار رکھا گیا ہے۔

ایونٹس دو اقسام میں تقسیم ہوتے ہیں:

  • بلاکنگ ایونٹس آپ کے سرور سے ایسی کنفیگریشن کے ساتھ جواب کی توقع کرتے ہیں جو جاری کال کو تشکیل دے — یعنی ان کمنگ کال ایونٹس (telephony.incoming / web.incoming)۔ فون کال زیادہ سے زیادہ 13 سیکنڈ تک انتظار کرتی ہے، جس میں ایک دوبارہ کوشش شامل ہے، اور ویجیٹ سیشن 10 سیکنڈ تک۔ کوئی متبادل ایجنٹ موجود نہیں ہے: قابلِ استعمال کنفیگریشن کے بغیر فون کال ختم کر دی جاتی ہے اور ویجیٹ سیشن ناکام ہو جاتا ہے۔
  • نان بلاکنگ ایونٹس فائر اینڈ فارگیٹ اطلاعات ہیں، جن کی دوبارہ کوشش ایکسپونینشل بیک آف کے ساتھ کی جاتی ہے — ملاحظہ کریں ڈیلیوری سیمینٹکس۔

ہر درخواست میں X-ThunderPhone-Signature-V2 میں ٹائم اسٹیمپ والا HMAC-SHA256 دستخط، اور سابقہ صرف باڈی والا X-ThunderPhone-Signature شامل ہوتا ہے۔ ملاحظہ کریں دستخط کی توثیق۔


فنکشن ٹولز

ایک فنکشن ٹول ایک HTTP اینڈ پوائنٹ ہے جسے آپ کا ایجنٹ گفتگو کے دوران کال کر سکتا ہے۔ آپ ThunderPhone کو OpenAI طرز کا فنکشن اسکیما اور ایک اینڈ پوائنٹ URL دیتے ہیں؛ ایجنٹ فیصلہ کرتا ہے کہ اسے کب کال کرنا ہے، اور ThunderPhone اپنے سرورز سے دستخط شدہ HTTP درخواست کرتا ہے اور نتیجہ واپس ایجنٹ کو دیتا ہے۔

ایجنٹس میں بلٹ اِن کال صلاحیتیں بھی شامل ہیں — کال منتقل کرنا، کی پیڈ (DTMF) ان پٹ بھیجنا، کال ختم کرنا، ہولڈ پر انتظار کرنا — جنہیں آپ ٹول تعریفوں کے بجائے سادہ پرامپٹ لائنز کے ذریعے فعال کرتے ہیں۔

ڈیش بورڈ میں: بلڈر کا API کنکشنز سیکشن (دیکھیں کنکشنز)۔

API میں: /v1/integrations اور فنکشن ٹولز کی وضاحت۔


ٹیم اور کردار

ہر تنظیم میں دو کرداروں کے ساتھ اراکین کی فہرست ہوتی ہے: اراکین ایجنٹس بناتے اور چلاتے ہیں؛ ایڈمنز ٹیم اور بلنگ بھی منظم کرتے ہیں۔ ای میل کے ذریعے مدعو کریں — دعوت نامے 7 دن بعد ختم ہو جاتے ہیں اور منسوخ کیے جا سکتے ہیں؛ کسی رکن کی قطار میں ⋯ مینو کردار تبدیل کرتا ہے یا کسی کو ہٹاتا ہے۔ سنگل سائن آن کو پوری تنظیم کے لیے کنفیگر کیا جا سکتا ہے — دیکھیں SSO۔

ڈیش بورڈ میں: تنظیم → عمومی۔ دیکھیں اپنی ٹیم کو مدعو کریں۔

API میں: /v1/members، /v1/invites۔


بلنگ

ThunderPhone پیشگی ادائیگی پر مبنی ہے۔ ہر تنظیم کے پاس USD بیلنس ہوتا ہے؛ ہر کال ہمارے فراہم کنندگان کی فہرستی قیمتوں کے مطابق اپنے اجزا کی لاگت، انفراسٹرکچر فیس، اور 17–25% مارجن کے ساتھ منہا کرتی ہے (قیمتیں دیکھیں)۔ جب بیلنس صفر ہو جائے تو آنے والی کالیں مسترد کر دی جاتی ہیں اور جانے والی کالیں 402 Payment Required واپس کرتی ہیں۔

دستی طور پر رقم شامل کریں، یا بیلنس کی حد، ری فل رقم، اور اختیاری ماہانہ خرچ کی حد کے ساتھ آٹو ٹاپ اپ فعال کریں — تاکہ کال کبھی جملے کے درمیان منقطع نہ ہو۔

ڈیش بورڈ میں: تنظیم → بلنگ کی ترتیبات اور بلنگ ہسٹری۔ دیکھیں رقم شامل کریں اور آٹو ٹاپ اپ فعال کریں، نیز مکمل قیمتوں کا حوالہ۔

API میں: /v1/billing۔


اِن ایپ کوپائلٹ

ڈیش بورڈ میں ایک بلٹ اِن کوپائلٹ شامل ہے — اس سے پوچھیں "میں X کیسے کروں" اور یہ ان دستاویزات سے جواب دیتا ہے، کلک بہ کلک رہنمائی فراہم کرتا ہے جو اصل کنٹرولز کو نمایاں کرتی ہے، اور کسی بھی رہنمائی والے ٹور کو دوبارہ چلا سکتا ہے۔ اس صفحے میں مذکور کسی کنٹرول کو تلاش کرنے کا یہ تیز ترین طریقہ ہے۔ دیکھیں اِن ایپ کوپائلٹ سے پوچھیں۔


سب کو یکجا کرنا