कॉल करना
कॉल करने के लिए आपका PBX, बिज़नेस फ़ोन सिस्टम जो कॉल रूट करता है, ट्रंक के SIP डोमेन पर एक SIP INVITE भेजता है। Bird रिक्वेस्ट की जाँच करता है, उसे किसी कैरियर तक रूट करता है, और ऑडियो रिले करता है। यह पेज पूर्वापेक्षाएँ, रिक्वेस्ट फ़ील्ड, ऑथेंटिकेशन और लागत को कवर करता है।
कॉल करने से पहले
चार चीज़ें तैयार होनी चाहिए, किसी भी क्रम में, और उनमें से तीन आप सेट करते हैं:
- एक ट्रंक जो आपका ट्रैफ़िक स्वीकार करे। एक SIP ट्रंक बनाएँ और आउटबाउंड कॉलिंग सक्षम करें। अपने उपकरण की IP रेंज, एक allowed API key, या दोनों जोड़ें। जो क्लाइंट कोई लंबे समय तक चलने वाला सीक्रेट नहीं रख सकते, वे सेशन क्रेडेंशियल का उपयोग कर सकते हैं।
- एक सत्यापित caller ID। वह नंबर रजिस्टर करें जो आप प्रस्तुत करते हैं और उसका सत्यापन कॉल पूरा करें, इसी तरह एक वर्कस्पेस साबित करता है कि वह प्रस्तुत किए जाने वाले नंबरों का मालिक है। सत्यापन CLI की एंड-टू-एंड डिलीवरी या कॉल के कनेक्शन की गारंटी नहीं देता जहाँ CLI कोई Bird के माध्यम से प्राप्त नंबर नहीं है: CLI सत्यापन और डिलीवरी अस्वीकरण देखें।
- गंतव्य देश सक्षम हो। Destinations पेज पर उन देशों को चालू करें जिन्हें आप सेवा देते हैं।
- आपके वर्कस्पेस से रूटिंग जुड़ी हो। Bird यह आपके लिए सेट करता है और चुनता है कि कौन से कैरियर किन गंतव्यों की सेवा करें। जब तक यह तैयार नहीं होता, कॉल routing_not_configured के साथ अस्वीकार की जाती हैं; यह उन कारणों में से एक है जो अस्वीकृत कॉल कवर करता है।
Bird INVITE पर क्या अपेक्षा करता है
रिक्वेस्ट अपने ट्रंक के SIP डोमेन पर उसके किसी समर्थित पोर्ट पर भेजें। दो हेडर वह सब कुछ ले जाते हैं जो Bird को चाहिए:
| हेडर | Bird इसके साथ क्या करता है |
|---|---|
| To | जिस नंबर पर कॉल की जा रही है। Bird कैरियर चुनने और कॉल की कीमत तय करने के लिए इसका देश पढ़ता है |
| From | वह नंबर जो आप कॉलर के रूप में प्रस्तुत कर रहे हैं। यह इस वर्कस्पेस में एक सत्यापित caller ID होना चाहिए |
दोनों हेडर पर E.164 फ़ॉर्मैट में पूर्ण अंतरराष्ट्रीय नंबर उपयोग करें, एक अग्रणी + के बाद देश कोड और राष्ट्रीय नंबर। यही वह रूप है जो Bird कॉल पर रिकॉर्ड करता है और जिसकी इसकी गंतव्य मैचिंग अपेक्षा करती है।
इन दो हेडर के अलावा, यह एक सामान्य SIP कॉल है, किसी भी दिशा में कोई कस्टम हेडर नहीं।
हर कॉल को ऑथेंटिकेट करना
कॉल किस प्रक्रिया से गुज़रती है यह इस पर निर्भर करता है कि ट्रंक कैसे खोला गया है:
- केवल IP allow list। एक ही रिक्वेस्ट। Bird सोर्स एड्रेस को लिस्ट से मिलाता है और कॉल रूट करता है, कोई चैलेंज नहीं।
- केवल allowed API keys। Bird पहले कॉल से पासवर्ड माँगता है, SIP Digest एक्सचेंज के ज़रिए।
- दोनों। Bird चैलेंज करने से पहले सोर्स एड्रेस की जाँच होती है, इसलिए किसी अनलिस्टेड एड्रेस से आने वाली कॉल अस्वीकार की जाती है, चाहे उसके पास कोई भी क्रेडेंशियल हों।
- सेशन क्रेडेंशियल चालू। Bird कॉल को चैलेंज करता है चाहे वह कहीं से भी आई हो, भले ही allow list में न हो, और कुछ मिनट पहले जारी किया गया क्रेडेंशियल उत्तर देता है। जिस ट्रंक पर कोई allowed key नहीं है, उस पर allow list द्वारा पहले से स्वीकृत उपकरण बिना चैलेंज के कनेक्ट होते रहते हैं।
जहाँ ट्रंक में allowed API keys हैं, वहाँ आपका फ़ोन सिस्टम सीक्रेट के बजाय API key सीक्रेट का एक हैश भेजता है, और यही काम SIP Digest ऑथेंटिकेशन करता है:
- आपका PBX INVITE भेजता है।
- Bird ट्रंक द्वारा उपलब्ध प्रत्येक एल्गोरिदम के लिए एक चैलेंज लाइन के साथ 407 Proxy Authentication Required का उत्तर देता है, डिफ़ॉल्ट रूप से SHA-256 फिर MD5।
- आपका PBX INVITE दोबारा भेजता है, एक Proxy-Authorization हेडर के साथ जो username bird और API key के सीक्रेट को पासवर्ड के रूप में उपयोग करके कंप्यूट किया गया है।
- Bird उत्तर को सत्यापित करता है और रूटिंग जारी रखता है।
एक preemptive Proxy-Authorization हेडर चैलेंज से पहले भेजा जाता है, इसलिए आपके उपकरण को ऐसा एल्गोरिदम चुनना होगा जो ट्रंक प्रदान करता है। यदि ट्रंक में IP allow list भी है, तो रिक्वेस्ट फिर भी किसी लिस्टेड एड्रेस से आनी चाहिए।
Bird असफल हैंडशेक का उत्तर SIP लेयर पर देता है, इसलिए प्रयास प्लेटफ़ॉर्म द्वारा कॉल रिकॉर्ड बनाने से पहले ही वापस कर दिया जाता है। यदि आपकी कॉल Call log में बिल्कुल दिखाई नहीं दे रहीं, तो रूटिंग के बजाय क्रेडेंशियल जाँचें।
कॉल अटेस्टेशन
संयुक्त राज्य अमेरिका और फ़्रांस को की जाने वाली कॉल STIR/SHAKEN अटेस्टेशन ले जाती हैं। कैरियर कॉल लेबल करते समय इस सिग्नेचर का उपयोग करते हैं। Bird बिना किसी अतिरिक्त कॉन्फ़िगरेशन के डिफ़ॉल्ट रूप से level B लागू करता है। Level A के लिए सपोर्ट से संपर्क करें।
जब कोई कॉल अस्वीकार की जाती है
Bird कैरियर को डायल करने से पहले caller ID, गंतव्य, सीमाएँ और वॉलेट बैलेंस की जाँच करता है। अस्वीकृति आपके फ़ोन सिस्टम तक SIP 503 के रूप में पहुँचती है; विशिष्ट कारण ऑथेंटिकेटेड कॉल रिकॉर्ड पर रहता है। कॉल को call log में खोलें, या हर कारण और समाधान के लिए अस्वीकृत कॉल देखें।
फिर से प्रयास करने से पहले रिकॉर्ड किए गए कारण को हल करें। उदाहरण के लिए, calls_per_second_exceeded तब तक जारी रहता है जब तक आप डायल दर धीमी नहीं करते।
आपातकालीन कॉल नहीं ले जाई जातीं
Bird Voice आपातकालीन सेवाओं को कॉल नहीं ले जाता। 112, 911, 999 या किसी अन्य आपातकालीन नंबर पर कॉल अस्वीकार कर दी जाती है, हर ट्रंक पर, हर देश में। आपके फ़ोन सिस्टम को किसी अन्य मार्ग से आपातकालीन सेवाओं तक पहुँचना चाहिए।
यह व्यवहार आपके प्लान, बैलेंस या गंतव्यों पर निर्भर नहीं करता। अपने फ़ोन सिस्टम को आपातकालीन कॉल ऐसी सेवा के ज़रिए रूट करने के लिए कॉन्फ़िगर करें जो उन्हें सपोर्ट करती हो, जैसे कोई लोकल PSTN लाइन, ऑन-प्रिमाइसेस गेटवे, या कोई अन्य प्रोवाइडर। उस मार्ग का परीक्षण करें। Bird अस्वीकृत आपातकालीन कॉल के लिए 503 लौटाता है, जिससे किसी अन्य डायल-प्लान रूट वाला फ़ोन सिस्टम उसे आज़मा सके।
आपातकालीन सेवाएँ कॉलर के पंजीकृत स्थान पर निर्भर करती हैं, जो Bird किसी ट्रंक के लिए स्टोर नहीं करता। आपातकालीन कॉलिंग के लिए Bird रूट पर भरोसा न करें।
लागत और बिलिंग
Voice अन्य चैनलों की तरह आपके संगठन के वॉलेट से प्रीपेड है:
- बिल योग्य समय उत्तर से अंत तक चलता है, कॉल पहले कितनी भी देर तक रिंग हुई हो। कॉल रिकॉर्ड इसे Total duration के साथ दिखाता है, जो उस क्षण से चलता है जब Bird ने कॉल प्राप्त की।
- दर गंतव्य देश पर निर्भर करती है। आपका रेट कार्ड प्रत्येक देश की कीमत वॉलेट की मुद्रा में बताता है। एक दर न्यूनतम बिल समय और उस न्यूनतम के बाद उपयोग होने वाले इंक्रीमेंट को परिभाषित करती है। उदाहरण के लिए, एक मिनट के न्यूनतम और छह सेकंड के इंक्रीमेंट वाली दर 10 सेकंड की कॉल का बिल एक मिनट के रूप में बनाती है।
- कैरियर को डायल करने से पहले वॉलेट की जाँच होती है। जो कॉल आपका बैलेंस कवर नहीं कर सकता, वह बाद में बिल करने के बजाय पहले ही insufficient_balance के साथ अस्वीकार कर दी जाती है। एक बफ़र रखें, या ऑटोमैटिक टॉप-अप चालू करें।
- दैनिक वॉइस खर्च सीमा लागू होती है। इसके पार जाने पर, अगले UTC दिन शुरू होने तक कॉल daily_spend_exceeded के साथ अस्वीकार की जाती हैं। राशि आपके प्लान पर निर्भर करती है।
- लागत कॉल पर दिखाई देती है एक बार रेटिंग हो जाने पर, पूर्ण सटीकता में, कर रहित।
कॉल पर कुल खर्च जोड़ने के लिए, Calls पेज से फ़िल्टर की गई कॉल सूची CSV के रूप में एक्सपोर्ट करें, या अपने इनवॉइस और उपयोग पढ़ें।
अगले कदम
| पेज | क्या कवर करता है |
|---|---|
| Call log | अपने कॉल रिकॉर्ड ब्राउज़ करना, फ़िल्टर करना और एक्सपोर्ट करना |
| Voice events | कॉल परिणामों को अपने सिस्टम में पुश करवाना |
| Payment methods & wallet | टॉप-अप, ऑटोमैटिक टॉप-अप, और वॉलेट से कैसे कटौती होती है |
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।