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

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

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

مشغولیت

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

کنکشنز

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

ایونٹس

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


تنظیمیں

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

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

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

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


ایجنٹس

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

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

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

API میں: /v1/agents — CRUD، ڈپلیکیٹ، ٹرانسفر، ورژن ہسٹری، اور prompt ہیلپرز۔


وائسز

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

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

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

API میں: /v1/voices، وائس نمونے، اور کسٹم وائسز۔


فون نمبرز

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

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

ڈیش بورڈ میں: فون نمبرز (/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_...) کے ذریعے تصدیق کرتا ہے جو آپ کے مجاز ڈومینز کے لیے origin-locked ہوتی ہے، اس لیے اسے کلائنٹ سائڈ کوڈ میں استعمال کرنا محفوظ ہے۔

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

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

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


نالج بیسز

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

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


کنکشنز

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

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

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


کیمپینز

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

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

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

براہِ راست نگرانی

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

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


سمولیشنز

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

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

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

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


توثیقی سیٹس

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

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

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


تجربات

ایک تجربہ لائیو ٹریفک پر ایجنٹ configurations کی A/B جانچ کرتا ہے: variants مقرر کریں (مختلف prompts، engines، یا settings)، ان کے درمیان ٹریفک تقسیم کریں، اور ہر variant کے نتائج کا موازنہ کریں۔ webhook میں bucket logic خود بنانے کے بجائے اسے استعمال کریں۔

ڈیش بورڈ میں: تجربات (/dashboard/experiments) اور ایجنٹ بلڈر میں A/B ٹیب۔ دیکھیں تجربات (A/B جانچ)۔


مسائل

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

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

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


رپورٹس

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

ڈیش بورڈ میں: رپورٹس (/dashboard/reports)۔ دیکھیں رپورٹس۔


مشاہدہ پذیری

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

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


الرٹس

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

ڈیش بورڈ میں: ادارہ → الرٹس۔ دیکھیں الرٹس۔


ویب ہکس

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

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

ہر درخواست X-ThunderPhone-Signature میں HMAC-SHA256 دستخط رکھتی ہے۔ دیکھیں دستخط کی توثیق۔


فنکشن ٹولز

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

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

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

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


ٹیم اور رولز

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

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

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


بلنگ

ThunderPhone پری پیڈ ہے۔ ہر تنظیم کے پاس USD بیلنس ہوتا ہے؛ کالز ایجنٹ کی فی منٹ شرح پر اس میں سے رقم منہا کرتی ہیں (انجن ٹئیر کے علاوہ اضافی چارجز — بلڈر آپ کی سیٹنگز تبدیل کرنے پر مکمل شرح براہ راست دکھاتا ہے، اور منتخب اضافی زبانیں 3¢ فی منٹ کا اضافہ کرتی ہیں)۔ جب بیلنس صفر ہو جاتا ہے تو ان باؤنڈ کالز مسترد کر دی جاتی ہیں اور آؤٹ باؤنڈ کالز 402 Payment Required لوٹاتی ہیں۔

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

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

API میں: /v1/billing۔


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

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


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