Sign inGet Started

SIP क्लाइंट सेटअप

जो भी SIP क्लाइंट किसी प्रॉक्सी के ज़रिए कॉल कर सकता है, वह Bird ट्रंक का उपयोग कर सकता है। इसमें PBX, डेस्कटॉप सॉफ़्टफ़ोन और कमांड-लाइन टूल शामिल हैं। यह पेज ट्रंक के कनेक्शन विवरण को सामान्य क्लाइंट फ़ील्ड और प्रमाणीकरण सेटिंग्स से मिलाता है।

क्लाइंट को क्या चाहिए

चार मान, जो सभी ट्रंक पेज पर मिलते हैं:

क्लाइंट फ़ील्डक्या दर्ज करें
SIP सर्वर, डोमेन, होस्ट या प्रॉक्सीट्रंक का SIP डोमेन
पोर्ट और ट्रांसपोर्टट्रंक के समर्थित पोर्ट में से कोई एक
ऑथेंटिकेशन उपयोगकर्ता, ऑथ उपयोगकर्ता या लॉगिनbird
पासवर्ड या सीक्रेटट्रंक पर अनुमत किसी API कुंजी का सीक्रेट

जो ट्रंक केवल अपनी IP अनुमति सूची का उपयोग करता है, उसे केवल पहले दो मानों की ज़रूरत होती है। क्रेडेंशियल वह हिस्सा हैं जो API कुंजी ऑथेंटिकेशन जोड़ता है।

उदाहरणों में YOUR_TRUNK_DOMAIN, YOUR_CALLER_ID और YOUR_API_KEY_SECRET का उपयोग किया गया है। ट्रंक पेज से पूरा डोमेन कॉपी करें। Bird किसी दूसरे डोमेन पर की गई कॉल को आपके कॉल लॉग तक पहुँचने से पहले ही अस्वीकार कर देता है। Bird CLI से साइन इन होने पर, इन मानों को baresip खाता पंक्ति के रूप में प्रिंट करने के लिए bird voice tools test-call --dry-run चलाएँ।

realm या authentication domain को खाली छोड़ें, ताकि क्लाइंट Bird के चैलेंज में दिए गए realm का उपयोग करे। अगर क्लाइंट को कोई मान चाहिए, तो वर्कस्पेस ID को उसके ws_ उपसर्ग के बिना लिखें और उसके बाद .sip.bird.com जोड़ें। वर्कस्पेस realm ट्रंक के SIP डोमेन से अलग होता है।

रजिस्टर किए बिना कॉल करें

Bird हर INVITE को ट्रंक की IP अनुमति सूची से या पासवर्ड चैलेंज के ज़रिए प्रमाणित करता है। क्लाइंट ट्रंक के साथ रजिस्टर नहीं करते।

कॉल करने से पहले रजिस्ट्रेशन की सेटिंग जाँचें:

  • PBX में Bird को ट्रंक के रूप में कॉन्फ़िगर करें और रजिस्ट्रेशन बंद रखें। Asterisk में इसका मतलब है कि कोई type=registration सेक्शन न हो; FreeSWITCH में गेटवे पर register=false सेट करना; FreePBX और 3CX में रजिस्ट्रेशन मोड होता है, जिसे none पर सेट करें।
  • सॉफ़्टफ़ोन में, अगर विकल्प मिले तो खाते की उन्नत सेटिंग में रजिस्ट्रेशन बंद करें। जहाँ यह विकल्प नहीं है, वहाँ रजिस्ट्रेशन का विफल प्रयास केवल दिखावटी है और डायल करना फिर भी काम करता है, क्योंकि हम रजिस्ट्रेशन पर नहीं, बल्कि INVITE पर कार्रवाई करते हैं।

दो पहचानें, दो फ़ील्ड

आपके क्लाइंट को दो अलग-अलग पहचानें भेजनी होंगी:

  • कॉलर आईडी From हेडर में जाती है। ऐसा Bird नंबर इस्तेमाल करें जो इस वर्कस्पेस को आवंटित हो और आउटबाउंड कॉल के योग्य हो, या कोई ऐसा बाहरी नंबर जिसे आपने सत्यापित किया हो। E.164 प्रारूप का उपयोग करें: शुरुआत में +, उसके बाद देश कोड और राष्ट्रीय नंबर। अधिकांश क्लाइंट में यह खाते का यूज़र या कॉलर आईडी फ़ील्ड होता है।
  • डाइजेस्ट यूज़रनेम हमेशा bird होता है। अधिकांश क्लाइंट में यह ऑथेंटिकेशन यूज़र या लॉगिन फ़ील्ड होता है।

डायल भी E.164 में करें, क्योंकि Bird इसी के आधार पर रूट करता है और कीमत तय करता है।

सॉफ़्टफ़ोन

प्रोडक्शन ट्रैफ़िक भेजने से पहले नए ट्रंक की जाँच करने का सबसे तेज़ तरीका सॉफ़्टफ़ोन है।

baresip

~/.baresip/accounts में एक पंक्ति जोड़ें, जिसमें आपकी कॉलर आईडी खाते के यूज़र के रूप में और bird ऑथ यूज़र के रूप में हो:

कोड उदाहरण
<sip:YOUR_CALLER_ID@YOUR_TRUNK_DOMAIN>;auth_user=bird;auth_pass=YOUR_API_KEY_SECRET;regint=0;outbound="sip:YOUR_TRUNK_DOMAIN;transport=udp"

regint=0 ही baresip को रजिस्टर करने से रोकता है। इसे शुरू करें और /dial +31612345678 से डायल करें।

Zoiper

मैन्युअल रूप से एक SIP खाता जोड़ें। Domain में ट्रंक का SIP डोमेन, Username में अपनी योग्य कॉलर आईडी और Password में API कुंजी का सीक्रेट डालें। उन्नत सेटिंग्स में Auth username को bird पर सेट करें, स्टार्टअप पर रजिस्ट्रेशन बंद करें और ट्रांसपोर्ट चुनें।

Linphone

एक खाता जोड़ें, जिसमें SIP पहचान का ऑथ उपयोगकर्ता bird हो और उपयोगकर्ता नाम आपकी कॉलर आईडी हो। फिर उस खाते पर पंजीकरण बंद करें। linphonerc में यही खाता reg_sendregister=0 वाला एक [proxy_N] सेक्शन होता है।

MicroSIP

Account के अंतर्गत: SIP server में ट्रंक का SIP डोमेन, Username में आपकी योग्य कॉलर आईडी, Login में bird और Password में API कुंजी का सीक्रेट डालें। Domain को SIP सर्वर जैसा ही रहने दें।

PBX

Asterisk

pjsip.conf में, आउटबाउंड प्रमाणीकरण वाला और बिना पंजीकरण सेक्शन वाला एक एंडपॉइंट:

कोड उदाहरण
[bird-auth]
type=auth
auth_type=userpass
username=bird
password=YOUR_API_KEY_SECRET

[bird-aor]
type=aor
contact=sip:YOUR_TRUNK_DOMAIN:5060

[bird]
type=endpoint
context=from-internal
outbound_auth=bird-auth
aors=bird-aor
from_user=YOUR_CALLER_ID
from_domain=YOUR_TRUNK_DOMAIN

Bird जिस कॉलर आईडी की जाँच करता है, वह from_user है, इसलिए योग्य कॉलर आईडी का उपयोग करें। Dial(PJSIP/+31612345678@bird) से डायल करें।

FreePBX

Connectivity > Trunks के अंतर्गत एक SIP (chan_pjsip) ट्रंक जोड़ें। उसकी pjsip Settings में Username को bird, Secret को API कुंजी का सीक्रेट, SIP Server को ट्रंक का SIP डोमेन, Authentication को outbound और Registration को none पर सेट करें। ट्रंक की आउटबाउंड कॉलर आईडी को किसी योग्य नंबर पर सेट करें।

FreeSWITCH

conf/sip_profiles/external/bird.xml में एक गेटवे:

कोड उदाहरण
<include>
  <gateway name="bird">
    <param name="proxy" value="YOUR_TRUNK_DOMAIN"/>
    <param name="register" value="false"/>
    <param name="username" value="bird"/>
    <param name="password" value="YOUR_API_KEY_SECRET"/>
    <param name="from-domain" value="YOUR_TRUNK_DOMAIN"/>
    <param name="caller-id-in-from" value="true"/>
  </gateway>
</include>

caller-id-in-from सेट होने पर लेग का कॉलर आईडी From नंबर बन जाता है, इसलिए कॉल शुरू करते समय इसे किसी योग्य नंबर पर सेट करें।

3CX

एक सामान्य SIP ट्रंक जोड़ें और पंजीकरण बंद करें। इसका होस्ट ट्रंक के SIP डोमेन पर, इसका प्रमाणीकरण आईडी bird पर, और इसका पासवर्ड API कुंजी के सीक्रेट पर सेट करें। आउटबाउंड कॉलर आईडी किसी योग्य नंबर पर सेट करें।

अगले चरण

पेजइसमें क्या शामिल है
वॉइस समस्या निवारणजो कॉल कनेक्ट नहीं होती, उसके लक्षण से उसका निदान करना
SIP ट्रंककनेक्शन विवरण, अनुमति सूचियाँ और Digest प्रमाणीकरण का विकल्प
कॉल करनाBird INVITE में क्या अपेक्षा करता है, और कॉल की कीमत कैसे तय होती है
कॉलर आईडीनंबर पंजीकृत करना और सत्यापन कॉल से यह साबित करना कि वह नंबर आपका है
कॉल लॉगयह पुष्टि करना कि कॉल बाहर गई, और उसकी लागत कितनी रही

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।