SIP क्लाइंट सेटअप
कोई भी SIP क्लाइंट जो प्रॉक्सी के ज़रिए कॉल कर सकता है, वह Bird ट्रंक का उपयोग कर सकता है। इसमें PBX, डेस्कटॉप सॉफ्टफ़ोन और कमांड-लाइन टूल शामिल हैं। यह पेज ट्रंक की कनेक्शन जानकारी को सामान्य क्लाइंट फ़ील्ड और ऑथेंटिकेशन सेटिंग्स से मैप करता है।
क्लाइंट को क्या चाहिए
चार वैल्यू, सभी ट्रंक पेज से:
| क्लाइंट फ़ील्ड | क्या भरें |
|---|---|
| SIP server, domain, host, या proxy | ट्रंक का SIP डोमेन |
| Port और transport | ट्रंक के समर्थित पोर्ट में से एक |
| Authentication user, auth user, या login | bird |
| Password या secret | ट्रंक पर अनुमत API key का secret |
जो ट्रंक केवल अपनी IP allow list का उपयोग करता है, उसे पहले दो ही चाहिए। क्रेडेंशियल वह हैं जो API key ऑथेंटिकेशन जोड़ता है।
उदाहरणों में 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 का उपयोग करें, उसके wsp_ प्रीफ़िक्स के बिना, उसके बाद .sip.bird.com लगाएँ। वर्कस्पेस realm ट्रंक के SIP डोमेन से अलग होता है।
बिना रजिस्टर किए कॉल करें
Bird हर INVITE को ट्रंक की IP allow list या पासवर्ड चैलेंज के ज़रिए ऑथेंटिकेट करता है। क्लाइंट ट्रंक के साथ रजिस्टर नहीं करते।
कॉल करने से पहले रजिस्ट्रेशन जाँचें:
- PBX में, Bird को trunk के रूप में कॉन्फ़िगर करें और रजिस्ट्रेशन बंद रखें। Asterisk में इसका मतलब कोई type=registration सेक्शन नहीं; FreeSWITCH में गेटवे पर register=false; FreePBX और 3CX में रजिस्ट्रेशन मोड को none पर सेट करें।
- सॉफ्टफ़ोन में, अकाउंट की एडवांस्ड सेटिंग्स में रजिस्ट्रेशन बंद करें अगर वह विकल्प उपलब्ध हो। जहाँ नहीं है, वहाँ विफल रजिस्ट्रेशन प्रयास केवल दिखावटी है और डायलिंग फिर भी काम करती है, क्योंकि हम रजिस्ट्रेशन पर नहीं बल्कि INVITE पर कार्रवाई करते हैं।
दो पहचान, दो फ़ील्ड
आपके क्लाइंट को दो अलग-अलग पहचान भेजनी होंगी:
- कॉलर ID From हेडर में जाती है, और यह एक ऐसा नंबर होना चाहिए जो आपने सत्यापित किया हो, E.164 फ़ॉर्मेट में: शुरू में + उसके बाद कंट्री कोड और नेशनल नंबर। अधिकांश क्लाइंट में यह अकाउंट का user या caller-ID फ़ील्ड होता है।
- डाइजेस्ट यूज़रनेम हमेशा bird होता है। अधिकांश क्लाइंट में यह authentication user या login फ़ील्ड होता है।
डायल भी E.164 में करें, क्योंकि Bird इसी पर रूटिंग और प्राइसिंग करता है।
सॉफ्टफ़ोन
प्रोडक्शन ट्रैफ़िक भेजने से पहले नए ट्रंक की जाँच करने का सबसे तेज़ तरीका सॉफ्टफ़ोन है।
baresip
~/.baresip/accounts में एक लाइन जोड़ें, अपनी कॉलर ID को अकाउंट यूज़र और bird को auth यूज़र के रूप में:
कोड उदाहरण
<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 को अपनी सत्यापित कॉलर ID पर, और Password को API key secret पर सेट करें। एडवांस्ड सेटिंग्स में, Auth username को bird पर सेट करें, स्टार्टअप पर रजिस्ट्रेशन बंद करें, और ट्रांसपोर्ट चुनें।
Linphone
bird को SIP identity के auth यूज़र के रूप में और अपनी कॉलर ID को उसके यूज़रनेम के रूप में सेट करके एक अकाउंट जोड़ें, फिर अकाउंट पर रजिस्ट्रेशन बंद करें। linphonerc में वही अकाउंट एक [proxy_N] सेक्शन है जिसमें reg_sendregister=0 होता है।
MicroSIP
Account में: SIP server ट्रंक का SIP डोमेन है, Username आपकी सत्यापित कॉलर ID, Login bird, Password API key secret। Domain को SIP server के समान ही रहने दें।
PBX
Asterisk
pjsip.conf में, outbound auth वाला और बिना registration सेक्शन वाला एक endpoint:
कोड उदाहरण
[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_DOMAINfrom_user वह कॉलर ID है जो Bird जाँचता है, इसलिए यह एक सत्यापित नंबर होना चाहिए। Dial(PJSIP/+31612345678@bird) से डायल करें।
FreePBX
Connectivity > Trunks में, एक SIP (chan_pjsip) ट्रंक जोड़ें। इसकी pjsip Settings में, Username को bird पर, Secret को API key secret पर, SIP Server को ट्रंक के SIP डोमेन पर, Authentication को outbound पर, और Registration को none पर सेट करें। ट्रंक की outbound कॉलर ID एक सत्यापित नंबर पर सेट करें।
FreeSWITCH
conf/sip_profiles/external/bird.xml में एक gateway:
कोड उदाहरण
<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 सेट होने पर, लेग पर कॉलर ID From नंबर बन जाती है, इसलिए ओरिजिनेट करते समय इसे एक सत्यापित नंबर पर सेट करें।
3CX
एक जेनेरिक SIP ट्रंक जोड़ें और रजिस्ट्रेशन बंद करें। इसका host ट्रंक के SIP डोमेन पर, authentication ID bird पर, और password API key secret पर सेट करें। Outbound कॉलर ID एक सत्यापित नंबर पर सेट करें।
अगले कदम
| पेज | क्या शामिल है |
|---|---|
| वॉइस ट्रबलशूटिंग | किसी ऐसी कॉल की समस्या निदान जो पूरी नहीं हुई, उसके लक्षण से शुरू करके |
| SIP ट्रंक | कनेक्शन जानकारी, allow lists, और Digest ऑफ़र |
| कॉल करना | Bird INVITE पर क्या अपेक्षा करता है, और कॉल की कीमत कैसे तय होती है |
| कॉलर ID | नंबर रजिस्टर करना और सत्यापन कॉल से उसका स्वामित्व सिद्ध करना |
| कॉल लॉग | यह पुष्टि करना कि कॉल गई, और उसकी लागत कितनी रही |
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।