SIP के माध्यम से कनेक्ट करें (कोई फोन नंबर नहीं)

हर कॉल के लिए एक बार उपयोग होने वाले SIP URI या एक स्थायी SIP पते के साथ, अपने PBX, कैरियर या SIP एप्लिकेशन से कॉल सीधे ThunderPhone एजेंट को भेजें।

अगर आपका अपना सिस्टम पहले से फोन नंबर संभालता है (PBX, कॉन्टैक्ट-सेंटर प्लेटफ़ॉर्म, या कैरियर अकाउंट जहाँ आप नंबर रोटेट करते हैं), तो आप कॉल को साधारण SIP के ज़रिए ThunderPhone एजेंट तक भेज सकते हैं। आपको ThunderPhone पर नंबर इंपोर्ट करने या खरीदने की ज़रूरत नहीं है। आपका सिस्टम SIP पता डायल करता है और एजेंट जवाब देता है।

SIP पते दो प्रकार के होते हैं:

दोनों प्रकार आपके संगठन के एक एजेंट तक रूट होते हैं, और दोनों कॉल हिस्ट्री में किसी भी अन्य इनबाउंड कॉल की तरह दिखते हैं।

प्रति-कॉल SIP URI#

1. कॉल रजिस्टर करें#

curl -X POST https://api.thunderphone.com/v1/calls/register-sip \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 12,
    "to_number": "+14155550142",
    "variables": {"customer_name": "Ada"}
  }'

{
  "call_id": 862197007562,
  "sip_uri": "sip:c-1790372992.Qm3xT8vLk2PzR7nYw4HbJa.uF6sD1gK9eW2cX5vB8nM0q@sip.thunderphone.com",
  "expires_at": "2026-09-25T21:49:52Z",
  "agent_id": 12,
  "to_number": "+14155550142"
}

• to_number (वैकल्पिक) वह नंबर है जिसे कॉलर ने आपकी तरफ डायल किया था। इसे कॉल हिस्ट्री में कॉल के डेस्टिनेशन के रूप में स्टोर किया जाता है, और एजेंट इसे अपने नंबर के रूप में देखता है।
• variables (वैकल्पिक) एजेंट के प्रॉम्प्ट में {{placeholders}} भरते हैं, ठीक उसी तरह जैसे आउटबाउंड कॉल के लिए।
• call_id वह id है जो कनेक्ट होने के बाद कॉल हिस्ट्री में कॉल की होगी (GET /v1/calls/{call_id})।

2. URI डायल करें#

कॉल को 5 मिनट के भीतर sip_uri पर भेजें। URI केवल एक कॉल के लिए काम करता है: किसी कॉल द्वारा इसका इस्तेमाल हो जाने के बाद यह समाप्त हो जाता है, भले ही वह कॉल जल्दी समाप्त हो जाए।

उदाहरण के लिए, Twilio के साथ, जिस कॉल को आप हैंड ओवर करना चाहते हैं उसके लिए यह TwiML लौटाएँ:

<Response>
  <Dial>
    <Sip>sip:c-1790372992.Qm3xT8vLk2PzR7nYw4HbJa.uF6sD1gK9eW2cX5vB8nM0q@sip.thunderphone.com;transport=tcp</Sip>
  </Dial>
</Response>

PBX से, URI को SIP डेस्टिनेशन के रूप में डायल करें। यूज़रनेम या पासवर्ड की ज़रूरत नहीं है; टोकन ही क्रेडेंशियल है, इसलिए URI को इस्तेमाल होने तक पासवर्ड की तरह रखें।

SIP एंडपॉइंट (स्थायी पता)#

1. एंडपॉइंट बनाएं#

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Main PBX"}'

{
  "id": 7,
  "name": "Main PBX",
  "agent_id": 12,
  "sip_uri": "sip:agent-12-jhxmginwjx@sip.thunderphone.com",
  "username": "tp409667538f83",
  "password": "8mJ0…",
  "allowed_source_cidrs": [],
  "status": "active",
  "created_at": "2026-09-25T21:46:18Z"
}

2. अपने सिस्टम को इससे जोड़ें#

इन सेटिंग्स के साथ SIP ट्रंक या डेस्टिनेशन कॉन्फ़िगर करें:

ये ट्रांसपोर्ट और कोडेक सेटिंग्स प्रति-कॉल URI पर भी लागू होती हैं। दोनों प्रकार के पतों के लिए दो नेटवर्क विवरण महत्वपूर्ण हैं:

• Record-Route का पालन करें। पहले INVITE के बाद, कॉल की बाकी सिग्नलिंग (ACK, हैंग-अप, ट्रांसफर) उस विशिष्ट ThunderPhone सर्वर पर जाती है जिसने जवाब दिया था, जिसका नाम Record-Route हेडर में होता है (sip-1.thunderphone.com या sip-2.thunderphone.com, या उसका IP पता)। अगर आप आउटबाउंड SIP को प्रतिबंधित करते हैं, तो sip.thunderphone.com के साथ इन होस्ट को भी अनुमति दें: 172.170.39.202 (sip), 13.86.104.121 (sip-1) और 20.80.98.90 (sip-2)।
• ऑडियो कहीं और जाता है। sip.thunderphone.com केवल सिग्नलिंग संभालता है। SDP उत्तर में दिए गए पतों और पोर्ट्स के लिए मीडिया (RTP) की अनुमति दें।

पते पर आने वाली हर कॉल एंडपॉइंट के एजेंट तक पहुंचती है, चाहे कॉलर ने आपकी ओर से कोई भी नंबर डायल किया हो। आप कभी नंबर इंपोर्ट नहीं करते, इसलिए अपनी ओर से उन्हें रोटेट करने पर ThunderPhone में कोई बदलाव नहीं चाहिए।

डायल किया गया नंबर भेजें (वैकल्पिक)#

कॉलर ने आपका कौन-सा नंबर डायल किया था, यह रिकॉर्ड करने के लिए उसे INVITE में X-Original-To हेडर (उदाहरण के लिए X-Original-To: +14155550142) या एक स्टैंडर्ड Diversion हेडर में भेजें। ThunderPhone इसे कॉल के डेस्टिनेशन के रूप में स्टोर करता है।

डेस्टिनेशन इस क्रम में चुना जाता है: प्रति-कॉल URI रजिस्टर करते समय दिया गया to_number, फिर X-Original-To में दिया गया नंबर, फिर Diversion में दिया गया नंबर। अगर इनमें से किसी में नंबर नहीं है, तो एंडपॉइंट के लिए इसे sip:agent-12-jhxmginwjx (एंडपॉइंट का पता), या प्रति-कॉल URI के लिए sip:call के रूप में दिखाया जाता है।

Twilio के साथ आप SIP URI में हेडर जोड़ सकते हैं: sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tcp?X-Original-To=%2B14155550142.

सोर्स IP प्रतिबंधित करें (वैकल्पिक)#

यूज़रनेम और पासवर्ड के अतिरिक्त, केवल अपने सिग्नलिंग पतों से कॉल स्वीकार करने के लिए allowed_source_cidrs सेट करें:

curl -X PATCH https://api.thunderphone.com/v1/sip-endpoints/7 \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allowed_source_cidrs": ["203.0.113.0/28"]}'

किसी अन्य पते से आने वाली कॉल को एजेंट तक पहुंचने से पहले अस्वीकार कर दिया जाता है। उन पतों का उपयोग करें जिनसे आपका सिस्टम SIP सिग्नलिंग भेजता है (Twilio जैसे कैरियर के लिए, उसकी प्रकाशित सिग्नलिंग IP रेंज), अपने मीडिया पतों का नहीं।

कॉलर और आपका सिस्टम क्या देखते हैं#

• कॉलर ID: From हेडर का यूज़र भाग कॉलर के रूप में स्टोर किया जाता है। फ़ोन नंबर (अंकों के साथ, वैकल्पिक रूप से +, स्पेस, डैश, डॉट या ब्रैकेट सहित) को E.164 में नॉर्मलाइज़ किया जाता है; SIP यूज़रनेम जैसी कोई भी अन्य चीज़ भेजे गए रूप में ही रखी जाती है। अधिकतम 32 कैरेक्टर रखे जाते हैं, और अनुपस्थित कॉलर को anonymous के रूप में स्टोर किया जाता है।
• अस्वीकृत कॉल: अज्ञात या समाप्त हो चुकी प्रति-कॉल URI पर SIP 404 Not Found मिलता है। पहले से इस्तेमाल की जा चुकी प्रति-कॉल URI, डिसेबल किया गया एंडपॉइंट, या अलाउलिस्ट के बाहर का स्रोत (अलाउलिस्ट वाले एंडपॉइंट पर कोई भी UDP कॉल सहित) एजेंट शुरू होने से पहले डिस्कनेक्ट कर दिया जाता है: आपका सिस्टम कॉल को विफल होते हुए देख सकता है, या कनेक्ट होकर तुरंत समाप्त होते हुए देख सकता है। ये अस्वीकृतियां कॉल हिस्ट्री एंट्री नहीं बनातीं। यदि आपके संगठन का क्रेडिट समाप्त हो गया है या वह अपनी खर्च सीमा तक पहुंच गया है, तो कॉल अस्वीकार कर दी जाती है और कॉल हिस्ट्री में बिना किसी शुल्क के विफल कॉल के रूप में दिखाई देती है। प्रति-कॉल प्रयास को फिर से करने के लिए, नई URI रजिस्टर करें।
• ट्रांसफर: एजेंट के कोल्ड ट्रांसफर काम करते हैं (ThunderPhone एक SIP REFER भेजता है, जिसे आपके सिस्टम को स्वीकार करना होगा)। SIP-एड्रेस कॉल पर वॉर्म ट्रांसफर उपलब्ध नहीं हैं, क्योंकि दूसरे लेग के लिए कॉलर ID के रूप में दिखाने हेतु कोई ThunderPhone नंबर नहीं होता। Twilio के साथ, ऊपर दिया गया TwiML एजेंट को कनेक्ट करता है लेकिन ट्रांसफर हैंडल नहीं करता: <Dial> में referUrl="https://YOUR_SERVER/sip-transfer" जोड़ें, और उस वेबहुक से ReferTransferTarget पढ़वाएं तथा ट्रांसफर डेस्टिनेशन को डायल करने वाला TwiML लौटाएं (Twilio की SIP REFER गाइड देखें)।
• टेक्स्ट मैसेज: SIP एड्रेस और डायल किया गया नंबर टेक्स्ट नहीं भेज सकते। एजेंट SIP-एड्रेस कॉल के दौरान केवल तभी टेक्स्ट कर सकता है, जब टेक्स्टिंग के लिए अलग SMS-सक्षम नंबर सेट अप किया गया हो; अन्यथा उसका SMS टूल उपलब्ध नहीं होता।
• रजिस्ट्रेशन: ThunderPhone SIP REGISTER स्वीकार नहीं करता। कॉल को एड्रेस पर भेजें; उस पर रजिस्टर न करें।

मूल्य निर्धारण#

SIP-एड्रेस कॉल पर एजेंट की सामान्य प्रति-मिनट दर से बिल किया जाता है। कोई फ़ोन-नंबर शुल्क नहीं है, क्योंकि कॉल किसी ThunderPhone नंबर से नहीं जाती। आपका अपना कैरियर कॉल के अपने हिस्से का बिल सामान्य रूप से करता है। देखें मूल्य निर्धारण।

इसे टेस्ट करें#

1. ऊपर बताए अनुसार प्रति-कॉल URI या एंडपॉइंट बनाएं।
2. इसे अपने सिस्टम से, या किसी भी SIP सॉफ्टफोन से डायल करें (एंडपॉइंट के लिए, यूज़रनेम और पासवर्ड दर्ज करें)।
3. कॉल समाप्त करने के बाद, डैशबोर्ड में कॉल्स में कॉल खोलें, या उसे GET /v1/calls/{call_id} से फ़ेच करें। इसमें कॉलर, डेस्टिनेशन ("डायल किया गया नंबर पास करें" के अंतर्गत क्रम देखें) और ट्रांसक्रिप्ट दिखाई देता है।

API विवरण: SIP एड्रेस API रेफरेंस।