कॉल करना

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

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

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

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

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

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

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

हेडर	Bird इसका क्या करता है
`To`	जिस नंबर पर कॉल की जा रही है। Bird कैरियर चुनने और कॉल की कीमत तय करने के लिए इसका देश पढ़ता है
`From`	वह नंबर जिसे आप कॉलर के रूप में दिखा रहे हैं। यह इस वर्कस्पेस में एक योग्य Bird नंबर या सत्यापित बाहरी कॉलर ID होना चाहिए

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

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

हर कॉल का प्रमाणीकरण

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

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

जहाँ ट्रंक में अनुमत API कुंजियाँ हैं, वहाँ आपका फ़ोन सिस्टम API कुंजी के सीक्रेट के बजाय उसके हैश से उत्तर देता है। SIP Digest ऑथेंटिकेशन यही करता है:

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

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

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

कॉल सत्यापन (attestation)

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

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

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

फिर से प्रयास करने से पहले दर्ज कारण को हल करें। उदाहरण के लिए, 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 के साथ अस्वीकार की जाती हैं। कोई वर्कस्पेस Voice → Destinations में हर गंतव्य देश के लिए अलग दैनिक सीमा भी तय कर सकता है, और कॉल को दोनों सीमाओं के भीतर रहना होता है। राशि आपके प्लान पर निर्भर करती है।
कॉल की रेटिंग होने के बाद उसकी लागत कॉल पर दिखती है, पूरी सटीकता के साथ और कर के बिना।

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

अगले चरण

पेज	इसमें क्या शामिल है
कॉल लॉग	अपने कॉल रिकॉर्ड देखना, फ़िल्टर करना और एक्सपोर्ट करना
वॉइस इवेंट	कॉल के परिणाम अपने सिस्टम पर पुश करवाना
भुगतान के तरीके और वॉलेट	टॉप-अप, स्वचालित टॉप-अप, और वॉलेट से राशि कैसे काटी जाती है

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

इम्प्लीमेंटेशन ब्रीफ़ पाएँ

संबंधित संसाधन