Open in
ان باؤنڈ کالز سنبھالیں (API)
ابتدا سے انتہا تک: ایک ایجنٹ کنفیگر کریں، اسے فون نمبر سے منسلک کریں، کال لیں، اور ٹرانسکرپٹ کا جائزہ لیں۔
آپ کے ٹرمینل سے فون کا جواب AI کے ذریعے دینے کا معیاری فلو۔ آپ یہ کریں گے:
- prompt اور آواز کے ساتھ ایک ایجنٹ بنائیں۔
- فون نمبر پروویژن کریں (یا اپنا نمبر لائیں) اور ایجنٹ کو اس کے اِن باؤنڈ ہینڈلر کے طور پر مقرر کریں۔
- نمبر پر کال کریں۔ کال لاگ، ٹرانسکرپٹ اور ریکارڈنگ دیکھیں۔
API کالز کی کل تعداد: چار۔ کل وقت: پانچ منٹ سے کم۔
1. ایک ایجنٹ بنائیں
ایک ایجنٹ prompt، آواز اور پروڈکٹ سطح کو یکجا کرتا ہے جو کال کو چلاتے ہیں۔ آپ ایجنٹ پر کال کی حدود بھی مقرر کر سکتے ہیں، مثلاً max_call_duration_seconds
اور ring_duration_seconds۔ آؤٹ باؤنڈ کالز کے لیے، آپ
max_hold_seconds بھی مقرر کر سکتے ہیں تاکہ ایجنٹ کال ختم کرنے سے پہلے ہولڈ پر انتظار کے وقت کو محدود کیا جا سکے۔ Bolt ایجنٹس سننے اور جواب دینے کے طریقے کو کنٹرول کرنے کے لیے audio_tier، endpointing، اور intelligence
بھی سپورٹ کرتے ہیں: intelligence core یا pro ہوتا ہے،
اور audio_tier (سننے کے لیے) lite، standard، plus یا max ہوتا ہے (Max عام طور پر دستیاب نہیں ہے)۔ پرانی قدریں (lite اور standard
برائے intelligence؛ lean، hearing اور deep_hearing برائے سننے کے لیے) اب بھی
قبول کی جاتی ہیں۔ فل ڈوپلیکس ایجنٹس معاون زبانوں میں ایک ہی آواز برقرار رکھتے ہیں،
اس لیے ان کالز پر فی زبان آواز کی تبدیلی لاگو نہیں ہوتی۔ ایجنٹس
ریکارڈ شدہ تعارف اور ایجنٹ کے بولنے سے پہلے زیادہ سے زیادہ دو رنگ بجانے کے لیے intro_clip اور intro_ring_count بھی سپورٹ کرتے ہیں۔ نئے ایجنٹس کے لیے ٹائم زون بھی درکار ہوتا ہے۔ اگر
آپ کا ایجنٹ کثیر لسانی ہے، تو آپ language_switching مقرر کر سکتے ہیں تاکہ یہ کنٹرول ہو سکے
کہ ایجنٹ زبان تبدیل کرنے سے پہلے پوچھتا ہے یا کال کرنے والے کی زبان کی پیروی کرتا ہے۔
آپ ایجنٹ پر words بھی مقرر کر سکتے ہیں تاکہ مخصوص اصطلاحات کے ادا کرنے کے طریقے
اور ان اصطلاحات کو کنٹرول کیا جا سکے جنہیں ایجنٹ سنتا ہے۔
ہر کنفیگریشن فیلڈ کے لیے ایجنٹس دیکھیں؛
کم از کم یہ ہے:
curl -X POST https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Support",
"prompt": "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
"voice": "john",
"product": "bolt"
}'واپس آنے والا id محفوظ کر لیں — آپ کو مرحلہ 2 میں اس کی ضرورت ہوگی۔
2. فون نمبر حاصل کریں
اگر آپ کو صرف ڈائل کرنے کے لیے کچھ درکار ہے، تو ThunderPhone کے پول سے ThunderPhone نمبر حاصل کریں:
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"area_code": "415"}'جواب میں E.164 فارمیٹ میں ایک id اور ایک number شامل ہوتا ہے۔ ThunderPhone
نمبر status="provisioning" سے شروع ہوتے ہیں اور چند سیکنڈز کے اندر active
ہو جاتے ہیں — اگر آپ کو ضرورت ہو تو تبدیلی دیکھنے کے لیے
GET /v1/phone-numbers/{id}
کو پول کریں۔
3. ایجنٹ مقرر کریں
مرحلہ 1 کے ایجنٹ کو نمبر کی اِن باؤنڈ سمت کے ساتھ منسلک کریں:
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'بس اتنا ہی — نمبر فعال ہے۔ آپ کی تنظیم کے لیے آؤٹ باؤنڈ کالنگ کی منظوری کے بعد،
آپ اسی PATCH میں outbound_agent_id بھی مقرر کر سکتے ہیں۔ اس وقت تک، API اس
اسائنمنٹ کو 400 کے ساتھ مسترد کرتی ہے۔
اگر آپ مقررہ inbound_agent_id کے بجائے config webhook کے ذریعے آنے والی کالز روٹ کرتے ہیں، تو یہ webhook اب agent_id اور variables کے ساتھ ہر کال کے لیے timezone واپس کر سکتا ہے۔ Bolt ایجنٹس کے لیے، آپ API writes میں ایجنٹ پر audio_tier، endpointing، اور intelligence بھی سیٹ کر سکتے ہیں۔ API اب بھی پرانے eagerness نام کو endpointing کے عرف کے طور پر قبول کرتا ہے۔ اگر آپ کا ایجنٹ trigger="call_start" کے ساتھ API connections استعمال کرتا ہے، تو ThunderPhone ہر فون کال کے آغاز پر، سلام سے پہلے، ان کے محفوظ کردہ call_start_arguments استعمال کرتے ہوئے ان ٹولز کو ایک بار چلا سکتا ہے۔
آپ کی آؤٹ باؤنڈ کالز پر واپس آنے والی کالز
جب کوئی شخص ایسے نمبر پر واپس کال کرتا ہے جس نے گزشتہ 30 دنوں میں اسے کال کی تھی، تو جواب دینے والے ایجنٹ کو اس کال کے بارے میں ایک مختصر پس منظر نوٹ ملتا ہے: یہ کب کی گئی، کس ایجنٹ نے کی، اور کیا ہوا تھا (کوئی جواب نہیں، وائس میل، یا گفتگو)۔ جس نمبر کے لیے کوئی اِن باؤنڈ ایجنٹ مقرر نہ ہو، وہ یہی تفصیلات آپ کے config webhook کو returning_call کے طور پر بھیجتا ہے۔ اگر اس نمبر کے لیے کوئی webhook نہ ہو، یا webhook کا وقت ختم ہو جائے یا اس تک رسائی نہ ہو سکے، تو کال ختم ہونے کے بجائے اس ایجنٹ کو منتقل کر دی جاتی ہے جس نے پہلے والی کال کی تھی۔ کالر ID جعلی ہو سکتی ہے، اس لیے پہلے والی کال کا خلاصہ اور متغیرات صرف اسی صورت میں شیئر کیے جاتے ہیں جب کوئی ایڈمن Organization → General → Callbacks کے تحت پہلے والی کال کی تفصیلات شیئر کریں کو فعال کرے۔ Callbacks دیکھیں۔
4. کال لیں
اپنے فون سے نمبر ڈائل کریں۔ ایجنٹ کال اٹھاتا ہے، آپ کے prompt کے مطابق اپنا تعارف کراتا ہے، اور گفتگو شروع ہو جاتی ہے۔
جب کال جاری ہو، تو وہ
GET /v1/calls میں
status="in_progress" کے ساتھ ظاہر ہوتی ہے۔ کال ختم ہونے پر، ریکارڈ میں
end_reason، duration_seconds، billable_minutes، اور بالآخر ایک ریکارڈنگ
URL اور AI گریڈ کے ساتھ اپ ڈیٹ ہو جاتا ہے۔
آنے والی کالیں آپ کی تنظیم کی
بیک وقت کالوں کی حد میں شمار ہوتی ہیں (بطور ڈیفالٹ 20
کالیں جاری ہو سکتی ہیں، جو آؤٹ باؤنڈ، ویب اور ٹیسٹ
کالوں کے ساتھ مشترک ہیں)۔ حد پر آنے والی کال کو ایجنٹ کے
جواب دینے سے پہلے مسترد کر کے منقطع کر دیا جاتا ہے، اس کا بل نہیں لیا جاتا، اور اسے
concurrent_call_limit_reached اختتامی وجہ کے ساتھ ناکام کال کے طور پر ریکارڈ کیا جاتا ہے۔ اگر آپ کو
زیادہ حد درکار ہو تو support@thunderphone.com پر ای میل کریں۔
5. نتائج کا جائزہ لیں
حالیہ کالز کی فہرست حاصل کریں:
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"ٹرانسکرپٹ حاصل کریں:
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"اور ریکارڈنگ کا URL حاصل کریں (مختصر مدت کے لیے فعال، دستخط شدہ):
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"اگر آپ نے
telephony.complete ویب ہک
کو سبسکرائب کیا ہے تو آپ کو یہی ڈیٹا آپ کے سرور پر POST کی صورت میں موصول ہوگا — دیکھیں
call.complete۔
اگر آپ کے ایجنٹ میں استخراجی فیلڈز ترتیب دیے گئے ہیں، تو مکمل شدہ کال کے payload میں منظم استخراج شدہ ڈیٹا بھی شامل ہو سکتا ہے۔ کال کے خلاصے اس زبان میں لکھے جاتے ہیں جو آپ کی تنظیم ThunderPhone میں استعمال کرتی ہے، جب تک ایجنٹ اس ترتیب کو تبدیل نہ کرے۔
اگلے مراحل
فون نمبر یا ویب ہک میں موجود کسٹم منطق کی بنیاد پر ہر کالر کے لیے مختلف ایجنٹ منتخب کریں۔
ایجنٹ کو گفتگو کے دوران آپ کے APIs کال کرنے دیں۔
کالرز کو براہِ راست منتقل کریں یا انہیں منسلک کرنے سے پہلے منزل کی جانچ کریں۔
ہر مکمل شدہ کال کو اپنے CRM / تجزیاتی پائپ لائن میں اسٹریم کریں۔
ہر کال کو خودکار طور پر اسکور کریں اور نشان زدہ کالز کو جائزے کے لیے بھیجیں۔