Open in
اپنے نمبر استعمال کریں (VoIP، API)
Twilio، Telnyx، SignalWire، Vonage، Plivo اور کسی بھی دوسرے SIP ٹرنک کو SIP کے ذریعے منسلک کریں، اپنے پہلے سے موجود فون نمبرز درآمد کریں، اور ThunderPhone ایجنٹس کو ان پر کالوں کے جواب دینے اور کالیں کرنے دیں۔
منظور شدہ ThunderPhone نمبرز آؤٹ باؤنڈ کالز کر سکتے ہیں اور مہمات چلا سکتے ہیں۔ اگر آپ اپنے VoIP فراہم کنندہ کے ذریعے اپنے نمبرز استعمال کرنا چاہتے ہیں، تو یہ گائیڈ آپ کو کنکشن کے عمل سے گزارتی ہے: اسناد آزمائیں → کنکشن بنائیں → نمبرز درآمد کریں → تصدیق کریں۔
معاونت یافتہ فراہم کنندگان
| فراہم کنندہ | provider آئی ڈی | نوٹس |
|---|---|---|
| Twilio | twilio | اکاؤنٹ SID + Auth Token؛ ہر Twilio اکاؤنٹ یا ذیلی اکاؤنٹ کے لیے ایک کنکشن (Twilio ذیلی اکاؤنٹس دیکھیں) |
| Telnyx | telnyx | API کلید؛ رہنمائی کے ساتھ آن بورڈنگ دستیاب ہے (setup_method: guided_telnyx) |
| SignalWire | signalwire | فراہم کنندہ کا مقامی کنکشن موجود نہیں؛ اسے SignalWire SIP پری سیٹ کے ساتھ manual کے طور پر کنیکٹ کریں |
| Vonage | vonage | فراہم کنندہ کا مقامی کنکشن موجود نہیں؛ اسے Vonage SIP پری سیٹ کے ساتھ manual کے طور پر کنیکٹ کریں |
| دستی SIP | manual | کوئی بھی SIP ٹرنک، بشمول SignalWire، Vonage اور Plivo۔ اگر آپ ڈیش بورڈ میں ان فراہم کنندگان میں سے کسی ٹائل سے شروع کرتے ہیں، تو کنکشن پھر بھی manual ہوتا ہے اور انتخاب کو sip_config.preset میں محفوظ کرتا ہے (signalwire، vonage یا plivo) |
1. اسناد آزمائیں
محفوظ شدہ VoIP کنکشن بنانے سے پہلے، فراہم کنندہ کی
اسناد کی جانچ کریں تاکہ تصدیق ہو سکے کہ وہ کام کرتی ہیں۔ اس سے ایک
verification_evidence_id ملتا ہے جسے آپ تخلیق کے مرحلے میں بھیجتے ہیں تاکہ
آزمائش کے لیے اسناد پر دو بار چارج نہ لگے۔
curl -X POST https://api.thunderphone.com/v1/voip-connections/test \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "telnyx",
"credentials": { "apiKey": "KEY...", "connectionId": "123456" },
"sip_config": { "domain": "acme.sip.telnyx.com" }
}'{
"status": "pass",
"verification_evidence_id": "b9a2...",
"suggested_connection_name": "Telnyx: Acme Main (+15550001234)",
"checks": {
"credentials_valid": true,
"inbound_reachable": true,
"outbound_authorized": true
}
}اگر کوئی جانچ ناکام ہو جائے تو جواب کا status fail ہوگا اور checks
دکھائے گا کہ کس مرحلے میں خرابی ہوئی۔ فراہم کنندہ کی جانب والی کنفیگریشن
(ٹرنک اسائنمنٹ، IP اجازت فہرست، آؤٹ باؤنڈ اجازت) درست کریں اور دوبارہ کوشش کریں۔
2. کنکشن بنائیں
ابھی حاصل کردہ verification_evidence_id منتقل کریں:
curl -X POST https://api.thunderphone.com/v1/voip-connections \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Telnyx Main",
"provider": "telnyx",
"setup_method": "api_key",
"credentials": { "apiKey": "KEY...", "connectionId": "123456" },
"sip_config": { "domain": "acme.sip.telnyx.com" },
"verification_evidence_id": "b9a2..."
}'جواب status="connected" میں ایک VoipConnection آبجیکٹ ہے۔ اسناد اور کنکشن کی دیگر خفیہ قدریں سرور کی جانب محفوظ کی جاتی ہیں اور بعد کی GET درخواستوں میں کبھی سادہ متن میں واپس نہیں کی جاتیں — تبدیل کرنے کے لیے نیا test چلائیں اور نئے ثبوت کے ساتھ PATCH کریں۔
Twilio ذیلی اکاؤنٹس
ایک Twilio کنکشن اسی واحد Twilio اکاؤنٹ سے منسلک ہوتا ہے جس کا Account SID اور Auth Token اس کے پاس ہوتا ہے۔ Twilio فون نمبرز اور SIP ٹرنکس کو ہر ذیلی اکاؤنٹ کے اندر رکھتا ہے، اس لیے پیرنٹ اکاؤنٹ کے ساتھ بنایا گیا کنکشن صرف پیرنٹ کے اپنے نمبرز دیکھتا ہے، اور موجودہ کنکشن کو بعد میں کسی دوسرے ذیلی اکاؤنٹ پر تبدیل نہیں کیا جا سکتا۔
ذیلی اکاؤنٹس میں موجود نمبرز تک رسائی کے لیے، ہر ذیلی اکاؤنٹ کے لیے ایک کنکشن بنائیں۔ ڈیش بورڈ یہ آپ کے لیے کرتا ہے: جب آپ ایسے پیرنٹ اکاؤنٹ کو کنیکٹ کرتے ہیں جس میں فعال ذیلی اکاؤنٹس ہوں، سیٹ اپ ڈائیلاگ انہیں فہرست میں دکھاتا ہے، آپ مطلوبہ اکاؤنٹس منتخب کرتے ہیں، اور ThunderPhone ہر ایک میں ایک کنکشن (اور ایک SIP ٹرنک) بناتا ہے۔ یہی عمل API کے ذریعے بھی دستیاب ہے:
# Discover active subaccounts visible to the parent credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/twilio/subaccounts \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"credentials": {"accountSid": "ACparent...", "authToken": "..."}}'{
"discovery_id": "7c1e...",
"parent": { "sid": "ACparent...", "friendly_name": "Acme" },
"subaccounts": [
{ "sid": "ACsupport...", "friendly_name": "Acme Support", "already_connected": false, "connection_id": null },
{ "sid": "ACsales...", "friendly_name": "Acme Sales", "already_connected": true, "connection_id": 5 }
]
}# Create a connection for each selected subaccount
curl -X POST https://api.thunderphone.com/v1/voip-connections/twilio/subaccounts/connect \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"discovery_id": "7c1e...", "subaccount_sids": ["ACsupport..."]}'جواب میں ہر ذیلی اکاؤنٹ کے لیے ایک قطار شامل ہوتی ہے، جس میں status
created، skipped (پہلے سے منسلک) یا failed ہوتا ہے، اور ساتھ ایک error
ہوتی ہے جس پر آپ کارروائی کر سکتے ہیں۔ قطاریں ایک دوسرے سے آزاد ہیں، اس لیے ایک ذیلی اکاؤنٹ
میں ناکامی دوسرے اکاؤنٹس کو کبھی نہیں روکتی، اور discovery_id 30
منٹ تک درست رہتا ہے، لہٰذا ناکام قطار کو آسانی سے دوبارہ آزمایا جا سکتا ہے۔ ذیلی اکاؤنٹ کے ٹوکن
دریافت کے وقت Twilio سے پڑھے جاتے ہیں اور نئی کنکشن پر محفوظ کیے جاتے ہیں؛
انہیں کبھی API کے ذریعے واپس نہیں کیا جاتا۔ پھر ہر نئی کنکشن نمبرز کو بالکل اسی طرح درآمد
اور تصدیق کرتی ہے جیسے آپ نے دستی طور پر بنائی ہوئی کنکشن میں ہوتا ہے۔
ہر نئی کنکشن کے SIP ٹرنک کے لیے کال ٹرانسفر بھی فعال کرنے کے لیے "enable_transfers": true شامل کریں؛
اس صورت میں ناکامی اس کنکشن کے test_result.transfer_enable_error میں رپورٹ ہوتی ہے اور قطار
ناکام نہیں ہوتی۔
3. نمبرز کی فہرست اور درآمد
اپنی اسناد کے لیے نظر آنے والے ان نمبرز کا جائزہ لیں جو پہلے سے ThunderPhone تنظیم میں موجود نہیں ہیں:
curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"پھر مطلوبہ نمبرز درآمد کریں:
curl -X POST https://api.thunderphone.com/v1/voip-connections/5/import-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"numbers": ["+15550001234", "+15550009999"]}'ہر درآمد آپ کی تنظیم میں ایک فون نمبر ریسورس بن جاتی ہے
جس میں number_type="voip" اور status="provisioning" ہوتے ہیں۔
اپنی کال روٹنگ برقرار رکھیں
Twilio پر، امپورٹ کرنے سے نمبر آپ کے اکاؤنٹ میں ThunderPhone کے SIP ٹرنک پر آ جاتا ہے؛ Telnyx پر، یہ نمبر ThunderPhone کے SIP کنکشن کو تفویض ہو جاتا ہے۔ دونوں صورتوں میں، ہر کال پھر براہِ راست آپ کے ایجنٹ تک جاتی ہے۔
اس کے بجائے خود کالز روٹ کرنے کے لیے (مثلاً، پہلے کسی شخص کی گھنٹی بجائیں اور صرف جواب نہ ملنے پر کال ایجنٹ کو بھیجیں)، امپورٹ کرنے کے بعد اپنے فراہم کنندہ کے پاس نمبر کی وائس سیٹنگز تبدیل کریں، یا API کے ذریعے "call_routing": "customer" کے ساتھ امپورٹ کریں تاکہ ThunderPhone انہیں بالکل تبدیل نہ کرے۔ ThunderPhone انہیں کبھی واپس تبدیل نہیں کرتا۔ ایجنٹ سے جواب دلوانے کے لیے، کال کو نمبر کے SIP ایڈریس پر بھیجیں:
<Response>
<Dial>
<Sip>sip:+15550001234@sip.thunderphone.com</Sip>
</Dial>
</Response>نمبر کے ذریعے ٹیکسٹنگ دونوں صورتوں میں یکساں کام کرتی ہے۔ آنے والی کال کا ٹیسٹ نمبر پر کال کرتا ہے، اس لیے وہ پہلے اسی شخص تک پہنچتی ہے جسے آپ کی روٹنگ کالز بھیجتی ہے۔
کنکشنز کے درمیان نمبر منتقل کرنا
ایسا نمبر امپورٹ کرنا جو پہلے ہی آپ کے کسی دوسرے کنکشن پر موجود ہو، اسے اس کے ایجنٹس اور ہسٹری سمیت نئے کنکشن پر منتقل کر دیتا ہے۔ ایسا نمبر جسے Twilio یا Telnyx کنکشن ThunderPhone کو بھیجتا ہے، پہلے اس کنکشن سے ہٹانا ضروری ہے، کیونکہ اس کا فراہم کنندہ کالز وہیں بھیجتا رہے گا۔
4. ہر درآمد شدہ نمبر کی تصدیق کریں
امپورٹ کرنے سے نمبر دستیاب کے طور پر رجسٹر ہو جاتا ہے؛ تاہم اس کے ذریعے کالز روٹ کرنے کے لیے تصدیق درکار ہوتی ہے۔ پرووائیڈر کنکشنز (Twilio، Telnyx) کے لیے یہ پرووائیڈر کی اسناد اور SIP تک رسائی کو دوبارہ جانچتا ہے۔ دستی SIP کنکشن کے لیے یہ پہلے ایک لوپ بیک سیلف کال آزماتا ہے: ThunderPhone نمبر سے، آپ کے SIP ٹرنک کے ذریعے، اسی نمبر پر واپس ایک مختصر جانچ کال کرتا ہے۔ اگر اس سے ان باؤنڈ راستے کی تصدیق نہ ہو، تو یہ نمبر سے، آپ کے SIP ٹرنک کے ذریعے، ThunderPhone کے ایک نمبر پر مختصر جانچ کال پر واپس آ جاتا ہے۔ یہ ٹیسٹ ٹرنک کا صارف نام، پاس ورڈ، ٹرانسپورٹ، آؤٹ باؤنڈ روٹنگ، اور ان باؤنڈ ڈیلیوری چیک کرتے ہیں۔ آپ کا کیریئر ان کالز کا بل کسی بھی دوسری کال کی طرح کرتا ہے۔
curl -X POST https://api.thunderphone.com/v1/phone-numbers/{id}/verify-voip \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"کامیابی پر، voip_verification_status تبدیل ہو کر verified ہو جاتا ہے اور
نمبر status="active" میں داخل ہو جاتا ہے۔ آپ کے اپنے Telnyx اکاؤنٹ میں موجود نمبر
اپنی ٹیسٹ کال ناکام ہونے یا آؤٹ باؤنڈ ابھی ترتیب نہ دیے جانے کی صورت میں بھی آنے والی کالز وصول کرتا رہتا ہے:
وہ voip_verification_status کو unverified پر سیٹ کرتے ہوئے status="active" ہو جاتا ہے،
اور جواب وجہ بتاتا ہے۔ ناکامی کی صورت میں، جواب واضح طور پر
بتاتا ہے کہ کیا ناکام ہوا — دستی ٹرنک کے لیے یہ کیریئر کا SIP جواب ہوتا ہے، مثلاً
"ThunderPhone کی اسناد مسترد کر دی گئیں (SIP 401)" یا "کال روٹ نہیں کی جا سکی (SIP 404)" — اسے درست کریں (اسناد، مجاز ماخذ IPs، فراہم کنندہ کے ڈیش بورڈ میں غائب ٹرنک کی تخصیص) اور دوبارہ کال کریں۔
الاؤلسٹ کی گئی دستی SIP کنکشن کے لیے، اگر وہ مجاز سورس IPs حقیقی آنے والی کال کو روک دیں تو آنے والی کال کا ٹیسٹ بھی ناکام ہو جاتا ہے۔ اگر آپ اپنی الاؤلسٹ میں ThunderPhone ریلے IPs استعمال کرتے ہیں، تو اپنے سیٹ اپ کے لیے ThunderPhone کی فراہم کردہ ہر ریلے IP شامل کریں۔
5. ایجنٹس اسائن کریں اور کال کریں
نمبر کی تصدیق ہونے کے بعد، آپ آنے والی / جانے والی کالز کے ایجنٹس کو اسی طرح اسائن کرتے ہیں جیسے ThunderPhone نمبر کے لیے کرتے ہیں۔ ملاحظہ کریں آنے والی کالز سنبھالیں اور جانے والی کالز کریں۔
ThunderPhone نمبروں سے کالیں امریکہ اور کینیڈا سے باہر کی منزلوں پر بھی کی جا سکتی ہیں، جب ThunderPhone کے پاس اس ملک اور لائن کی قسم کے لیے شرح موجود ہو۔ ان کالوں کے لیے منزل کی شرح کے مطابق چارج کیا جاتا ہے۔
اسناد کی تبدیلی
جب پرووائیڈر کلید تبدیل ہو، تو پہلے جانچنے اور پھر اپ ڈیٹ کرنے کا عمل دوبارہ چلائیں:
# 1. Test the new credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/test ...
# 2. PATCH the connection with the new evidence
curl -X PATCH https://api.thunderphone.com/v1/voip-connections/{id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"credentials": { "apiKey": "NEW_KEY..." },
"verification_evidence_id": "fresh-evidence-id"
}'کنکشن برقرار رہتا ہے — نمبرز دوبارہ امپورٹ کرنے کی ضرورت نہیں۔ ڈیش بورڈ کے دوبارہ کنیکٹ کرنے کے فلو میں، آپ محفوظ طریقے سے نئی کیریئر کلید درج کر سکتے ہیں، بغیر سادہ متن میں محفوظ کردہ مکمل credentials آبجیکٹ کو تبدیل کیے۔