Open in
আপনার নিজস্ব নম্বর আনুন (VoIP, API)
Twilio বা Telnyx, অথবা SignalWire, Vonage, Plivo এবং অন্য যেকোনো SIP ট্রাঙ্ক SIP-এর মাধ্যমে সংযুক্ত করুন, আপনার আগে থেকেই থাকা ফোন নম্বরগুলো ইমপোর্ট করুন, এবং ThunderPhone এজেন্টদের সেগুলোতে কলের উত্তর দিতে ও কল করতে দিন।
অনুমোদিত ThunderPhone নম্বরগুলি আউটবাউন্ড কল করতে এবং ক্যাম্পেইন চালাতে পারে। আপনি যদি নিজের VoIP প্রোভাইডারের মাধ্যমে আপনার মালিকানাধীন নম্বর ব্যবহার করতে চান, তাহলে এই গাইডটি আপনাকে সংযোগ প্রবাহের ধাপগুলো দেখাবে: ক্রেডেনশিয়াল পরীক্ষা → সংযোগ তৈরি → নম্বর ইমপোর্ট → যাচাই।
সমর্থিত প্রোভাইডার
| প্রোভাইডার | provider id | নোট |
|---|---|---|
| Twilio | twilio | অ্যাকাউন্ট SID + Auth Token; প্রতি Twilio অ্যাকাউন্ট বা সাবঅ্যাকাউন্টে একটি সংযোগ (Twilio সাবঅ্যাকাউন্ট দেখুন) |
| Telnyx | telnyx | API key; নির্দেশিত অনবোর্ডিং উপলভ্য (setup_method: guided_telnyx) |
| SignalWire | signalwire | কোনো নেটিভ প্রোভাইডার সংযোগ নেই; SignalWire SIP প্রিসেটসহ এটিকে manual হিসেবে সংযুক্ত করুন |
| Vonage | vonage | কোনো নেটিভ প্রোভাইডার সংযোগ নেই; Vonage SIP প্রিসেটসহ এটিকে manual হিসেবে সংযুক্ত করুন |
| ম্যানুয়াল SIP | manual | SignalWire, Vonage এবং Plivo-সহ যেকোনো SIP ট্রাঙ্ক। ড্যাশবোর্ডে ওই প্রোভাইডার টাইলগুলোর যেকোনো একটি থেকে শুরু করলেও, সংযোগটি 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 allowlist, আউটবাউন্ড অনুমোদন) এবং আবার চেষ্টা করুন।
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 object। ক্রেডেনশিয়াল এবং অন্যান্য গোপন সংযোগ মান সার্ভার-সাইডে সংরক্ষিত থাকে এবং পরবর্তী 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 org-এ নেই এমন নম্বরগুলো দেখুন:
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"]}'প্রতিটি ইমপোর্ট আপনার org-এ 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)" — এটি ঠিক করুন (শংসাপত্র, অনুমোদিত সোর্স
IP, প্রোভাইডার ড্যাশবোর্ডে অনুপস্থিত ট্রাঙ্ক অ্যাসাইনমেন্ট) এবং আবার কল করুন।
অনুমোদিত তালিকাভুক্ত ম্যানুয়াল SIP সংযোগের ক্ষেত্রে, ওই অনুমোদিত উৎস IP-গুলো প্রকৃত ইনবাউন্ড কল ব্লক করলে ইনকামিং-কল পরীক্ষাও ব্যর্থ হবে। আপনি যদি আপনার অনুমোদিত তালিকায় ThunderPhone রিলে IP ব্যবহার করেন, তাহলে আপনার সেটআপের জন্য ThunderPhone আপনাকে যে প্রতিটি রিলে IP দেয় সেগুলো অন্তর্ভুক্ত করুন।
5. এজেন্ট অ্যাসাইন করুন এবং একটি কল নিন
নম্বর যাচাই হয়ে গেলে, আপনি ThunderPhone নম্বরের মতোই ইনবাউন্ড / আউটবাউন্ড এজেন্ট অ্যাসাইন করবেন। দেখুন ইনবাউন্ড কল পরিচালনা করুন এবং আউটবাউন্ড কল করুন।
ThunderPhone নম্বর থেকে US ও Canada-এর বাইরের গন্তব্যেও কল করা যায়, যদি সেই দেশ ও লাইন ধরনের জন্য 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 অবজেক্টকে প্লেইন টেক্সটে প্রতিস্থাপন না করেই আপনি নিরাপদে নতুন carrier key লিখতে পারেন।