कॉल करना

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

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

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

SIP ट्रंक सेट अप करें में दोनों दिशाओं के लिए ट्रंक के पूरे सेटअप की प्रक्रिया क्रम से दी गई है।

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

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

INVITE में Bird की क्या अपेक्षाएँ हैं

अपने ट्रंक के SIP डोमेन पर उसके किसी एक समर्थित पोर्ट के ज़रिए अनुरोध भेजें। Bird इसके तीन हिस्से पढ़ता है:

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

इन बातों के अलावा, यह एक सामान्य SIP कॉल है और आपको कोई कस्टम हेडर भेजने की ज़रूरत नहीं है।

अपने SDP में G.711, A-law या µ-law का प्रस्ताव दें। कीपैड टोन (DTMF) को RFC 4733 टेलीफ़ोन इवेंट के रूप में भेजें। Bird कैरियर को भेजे जाने वाले प्रस्ताव से G.729 या Opus जैसे अन्य कोडेक हटा देता है, इसलिए हर प्रस्ताव में G.711 शामिल करें।

मीडिया सामान्य RTP का उपयोग करता है। SRTP समर्थित नहीं है। पोर्ट 5061 पर TLS सिग्नलिंग को एन्क्रिप्ट करता है, लेकिन ऑडियो अनएन्क्रिप्टेड रहता है।

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

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

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

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

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

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

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

कॉल का अभिप्रमाणन

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

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

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

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

Bird ने जिस कॉल को रिकॉर्ड किया है, उसके उत्तरों में कॉल की Leg ID (vcl_…) वाला X-BIRD-CALL-ID हेडर शामिल होता है। इनमें दर्ज कारण के साथ अस्वीकार की गई कॉल का 503 उत्तर भी शामिल है। GET /v1/voice/legs/{leg_id} से रिकॉर्ड पढ़ें, या सहायता टीम को यह ID दें।

आपातकालीन कॉल नहीं पहुँचाई जाती हैं

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 निर्यात में अवधियाँ और बिल योग्य समय शामिल होते हैं, लेकिन लागत का कोई कॉलम नहीं होता।

अगले कदम