कॉल करना

कॉल करने के लिए आपका PBX ट्रंक के SIP डोमेन पर एक SIP INVITE भेजता है। Bird रिक्वेस्ट की जाँच करता है, उसे किसी कैरियर तक रूट करता है, और ऑडियो रिले करता है। यह पेज पूर्वापेक्षाएँ, रिक्वेस्ट फ़ील्ड, ऑथेंटिकेशन और लागत को कवर करता है।

अपने एप्लिकेशन से HTTP के ज़रिए कॉल शुरू करने के लिए कॉल बनाने की गाइड देखें। इस तरीके में कॉल का उत्तर मिलने पर प्रकाशित Bird सीक्वेंस चलता है।

कॉल करने से पहले

चार चीज़ें तैयार होनी चाहिए, किसी भी क्रम में, और उनमें से तीन आप सेट करते हैं:

• एक ट्रंक जो आपका ट्रैफ़िक स्वीकार करे। एक SIP ट्रंक बनाएँ और आउटबाउंड कॉलिंग सक्षम करें। अपने उपकरण की IP रेंज, एक allowed API key, या दोनों जोड़ें। जो क्लाइंट कोई लंबे समय तक चलने वाला सीक्रेट नहीं रख सकते, वे सेशन क्रेडेंशियल का उपयोग कर सकते हैं।
• एक पात्र कॉलर ID। इस वर्कस्पेस को वर्तमान में आवंटित कोई Bird नंबर उपयोग करें, या कोई बाहरी नंबर रजिस्टर करें और उसका सत्यापन कॉल पूरा करें। सत्यापन CLI की एंड-टू-एंड डिलीवरी या कॉल के कनेक्शन की गारंटी नहीं देता जहाँ CLI कोई Bird के माध्यम से प्राप्त नंबर नहीं है: CLI सत्यापन और डिलीवरी अस्वीकरण देखें।
• गंतव्य देश सक्षम हो। गंतव्य पेज पर उन देशों को चालू करें जिन्हें आप सेवा देते हैं।
• आपके वर्कस्पेस से रूटिंग जुड़ी हो। Bird यह आपके लिए सेट करता है और चुनता है कि कौन से कैरियर किन गंतव्यों की सेवा करें। जब तक यह तैयार नहीं होता, कॉल routing_not_configured के साथ अस्वीकार की जाती हैं; यह उन कारणों में से एक है जो अस्वीकृत कॉल कवर करता है।

Bird INVITE पर क्या अपेक्षा करता है

रिक्वेस्ट अपने ट्रंक के SIP डोमेन पर उसके किसी समर्थित पोर्ट पर भेजें। दो हेडर वह सब कुछ ले जाते हैं जो Bird को चाहिए:

दोनों हेडर पर E.164 फ़ॉर्मैट में पूर्ण अंतरराष्ट्रीय नंबर उपयोग करें, एक अग्रणी + के बाद देश कोड और राष्ट्रीय नंबर। यही वह रूप है जो Bird कॉल पर रिकॉर्ड करता है और जिसकी इसकी गंतव्य मैचिंग अपेक्षा करती है।

इन दो हेडर के अलावा, यह एक सामान्य SIP कॉल है, किसी भी दिशा में कोई कस्टम हेडर नहीं।

हर कॉल को ऑथेंटिकेट करना

कॉल किस प्रक्रिया से गुज़रती है यह इस पर निर्भर करता है कि ट्रंक कैसे खोला गया है:

• केवल IP allow list। एक ही रिक्वेस्ट। Bird सोर्स एड्रेस को लिस्ट से मिलाता है और कॉल रूट करता है, कोई चैलेंज नहीं।
• केवल allowed API keys। Bird पहले कॉल से पासवर्ड माँगता है, SIP Digest एक्सचेंज के ज़रिए।
• दोनों। अनुमति प्राप्त API कुंजी से की गई कॉल किसी सूचीबद्ध पते से भी आनी चाहिए। सक्षम सेशन क्रेडेंशियल नीचे बताया गया अलग प्रवेश पथ प्रदान करते हैं।
• सेशन क्रेडेंशियल चालू। Bird कॉल को चैलेंज करता है चाहे वह कहीं से भी आई हो, भले ही allow list में न हो, और कुछ मिनट पहले जारी किया गया क्रेडेंशियल उत्तर देता है। जिस ट्रंक पर कोई allowed key नहीं है, उस पर allow list द्वारा पहले से स्वीकृत उपकरण बिना चैलेंज के कनेक्ट होते रहते हैं।

जहाँ ट्रंक में allowed API keys हैं, वहाँ आपका फ़ोन सिस्टम सीक्रेट के बजाय API key सीक्रेट का एक हैश भेजता है, और यही काम SIP Digest ऑथेंटिकेशन करता है:

1. आपका PBX INVITE भेजता है।
2. Bird ट्रंक द्वारा उपलब्ध प्रत्येक एल्गोरिदम के लिए एक चैलेंज लाइन के साथ 407 Proxy Authentication Required का उत्तर देता है, डिफ़ॉल्ट रूप से SHA-256 फिर MD5।
3. आपका PBX INVITE दोबारा भेजता है, एक Proxy-Authorization हेडर के साथ जो username bird और API key के सीक्रेट को पासवर्ड के रूप में उपयोग करके कंप्यूट किया गया है।
4. Bird उत्तर को सत्यापित करता है और रूटिंग जारी रखता है।

चैलेंज से पहले ही Proxy-Authorization हेडर भेजा जाता है, इसलिए आपके उपकरण को ट्रंक के उपलब्ध एल्गोरिदम में से एक चुनना होगा। API कुंजी से प्रमाणीकरण करते समय, IP अनुमति सूची वाला ट्रंक अभी भी सूचीबद्ध पते से अनुरोध आने की शर्त रखता है।

Bird असफल हैंडशेक का उत्तर SIP लेयर पर देता है, इसलिए प्रयास प्लेटफ़ॉर्म द्वारा कॉल रिकॉर्ड बनाने से पहले ही वापस कर दिया जाता है। यदि आपकी कॉल कॉल लॉग में बिल्कुल दिखाई नहीं दे रहीं, तो रूटिंग के बजाय क्रेडेंशियल जाँचें।

कॉल अटेस्टेशन

संयुक्त राज्य अमेरिका और फ़्रांस को की जाने वाली कॉल STIR/SHAKEN अटेस्टेशन ले जाती हैं। कैरियर कॉल लेबल करते समय इस सिग्नेचर का उपयोग करते हैं। Bird बिना किसी अतिरिक्त कॉन्फ़िगरेशन के डिफ़ॉल्ट रूप से level B लागू करता है। Level A के लिए सपोर्ट से संपर्क करें।

जब कोई कॉल अस्वीकार की जाती है

Bird कैरियर को डायल करने से पहले कॉलर ID, गंतव्य, सीमाएँ और वॉलेट बैलेंस की जाँच करता है। अस्वीकृति आपके फ़ोन सिस्टम तक SIP 503 के रूप में पहुँचती है; विशिष्ट कारण ऑथेंटिकेटेड कॉल रिकॉर्ड पर रहता है। कॉल को कॉल लॉग में खोलें, या हर कारण और समाधान के लिए अस्वीकृत कॉल देखें।

फिर से प्रयास करने से पहले रिकॉर्ड किए गए कारण को हल करें। उदाहरण के लिए, calls_per_second_exceeded तब तक जारी रहता है जब तक आप डायल दर धीमी नहीं करते।

आपातकालीन कॉल नहीं ले जाई जातीं

Bird Voice आपातकालीन सेवाओं को कॉल नहीं ले जाता। 112, 911, 999 या किसी अन्य आपातकालीन नंबर पर कॉल अस्वीकार कर दी जाती है, हर ट्रंक पर, हर देश में। आपके फ़ोन सिस्टम को किसी अन्य मार्ग से आपातकालीन सेवाओं तक पहुँचना चाहिए।

यह व्यवहार आपके प्लान, बैलेंस या गंतव्यों पर निर्भर नहीं करता। अपने फ़ोन सिस्टम को आपातकालीन कॉल ऐसी सेवा के ज़रिए रूट करने के लिए कॉन्फ़िगर करें जो उन्हें सपोर्ट करती हो, जैसे कोई लोकल PSTN लाइन, ऑन-प्रिमाइसेस गेटवे, या कोई अन्य प्रोवाइडर। उस मार्ग का परीक्षण करें। Bird अस्वीकृत आपातकालीन कॉल के लिए 503 लौटाता है, जिससे किसी अन्य डायल-प्लान रूट वाला फ़ोन सिस्टम उसे आज़मा सके।

आपातकालीन सेवाएँ कॉलर के पंजीकृत स्थान पर निर्भर करती हैं, जो Bird किसी ट्रंक के लिए स्टोर नहीं करता। आपातकालीन कॉलिंग के लिए Bird रूट पर भरोसा न करें।

लागत और बिलिंग

Voice अन्य चैनलों की तरह आपके संगठन के वॉलेट से प्रीपेड है:

• बिल योग्य समय उत्तर से अंत तक चलता है, कॉल पहले कितनी भी देर तक रिंग हुई हो। कॉल रिकॉर्ड इसे कुल अवधि के साथ दिखाता है, जो उस क्षण से चलता है जब Bird ने कॉल प्राप्त की।
• दर गंतव्य देश पर निर्भर करती है। आपका रेट कार्ड प्रत्येक देश की कीमत वॉलेट की मुद्रा में बताता है। एक दर न्यूनतम बिल समय और उस न्यूनतम के बाद उपयोग होने वाले इंक्रीमेंट को परिभाषित करती है। उदाहरण के लिए, एक मिनट के न्यूनतम और छह सेकंड के इंक्रीमेंट वाली दर 10 सेकंड की कॉल का बिल एक मिनट के रूप में बनाती है।
• कैरियर को डायल करने से पहले वॉलेट की जाँच होती है। जो कॉल आपका बैलेंस कवर नहीं कर सकता, वह बाद में बिल करने के बजाय पहले ही insufficient_balance के साथ अस्वीकार कर दी जाती है। एक बफ़र रखें, या ऑटोमैटिक टॉप-अप चालू करें।
• दैनिक वॉइस खर्च सीमा लागू होती है। इसके पार जाने पर, अगले UTC दिन शुरू होने तक कॉल daily_spend_exceeded के साथ अस्वीकार की जाती हैं। राशि आपके प्लान पर निर्भर करती है।
• लागत कॉल पर दिखाई देती है एक बार रेटिंग हो जाने पर, पूर्ण सटीकता में, कर रहित।

सभी कॉल का कुल खर्च जानने के लिए, लेग पेज से फ़िल्टर की गई कॉल सूची को CSV के रूप में एक्सपोर्ट करें, या अपने इनवॉइस और उपयोग देखें।

अगले कदम