Voice का अवलोकन

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

आपके फ़ोन सिस्टम और Bird के बीच का कनेक्शन एक SIP ट्रंक है। SIP (Session Initiation Protocol) फ़ोन सिस्टमों के बीच कॉल स्थापित करता है। Bird आपके वर्कस्पेस को एक ट्रंक पता देता है। आपका फ़ोन सिस्टम टेलीफ़ोन नेटवर्क पर आउटबाउंड कॉल के लिए इसी पते का उपयोग करता है, और Bird उलटी दिशा में आपके नंबरों पर आने वाली कॉल पहुँचाने के लिए इसका उपयोग करता है।

पहली कॉल करने के लिए आपको फ़ोन सिस्टम की ज़रूरत नहीं है: डैशबोर्ड का फ़ोन आपके किसी एक ट्रंक के ज़रिए सीधे ब्राउज़र से कॉल करता है।

आप डैशबोर्ड में सीक्वेंस भी बना सकते हैं और उसे Create Call API से शुरू कर सकते हैं। प्राप्तकर्ता के जवाब देने के बाद सीक्वेंस प्रॉम्प्ट, कीपैड विकल्प और कॉल रूटिंग संभालता है।

कॉल कैसे की जाती है

कॉल शुरू करने के लिए आपका फ़ोन सिस्टम ट्रंक पते पर SIP INVITE भेजता है। किसी कैरियर से संपर्क करने से पहले Bird कॉलर ID, गंतव्य देश, सीमाएँ और वॉलेट बैलेंस जाँचता है। जाँच में सफल होने पर Bird कॉल को रूट करता है और ऑडियो आगे पहुँचाता है। हर कनेक्शन एक लेग होता है। लेग खत्म होने पर Bird उसका रिकॉर्ड Voice > Legs में लिखता है और एक voice_call.ended इवेंट भेजता है।

जाँच में विफल कॉल को किसी कैरियर के शामिल होने से पहले ही अस्वीकार कर दिया जाता है, और अस्वीकृति का सटीक कारण लेग रिकॉर्ड में दर्ज होता है। कॉल करना बताता है कि Bird हर कॉल से क्या पढ़ता है, और अस्वीकृत कॉल में अस्वीकृति के सभी कारण और हर कारण पर क्या करना है, दिए गए हैं।

आने वाली कॉल का जवाब कैसे दिया जाता है

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

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

आपकी पहली कॉल से पहले

अपने SIP उपकरण से कॉल करने के लिए ये तैयारियाँ करें। API कॉल Create Call की पूर्व-आवश्यकताओं का पालन करती हैं।

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

अपनी पहली कॉल करें तीनों आवश्यकताओं को चरण-दर-चरण पूरा कराता है और एक असली कॉल के साथ समाप्त होता है।

कॉल रिकॉर्ड पढ़ने के लिए voice:read चाहिए; कॉल करने के लिए voice:write चाहिए। ट्रंक, नंबर रूट, कॉलर ID और सीक्वेंस प्रबंधित करने के लिए voice_management अनुमतियाँ लगती हैं। किसी पेज तक पहुँच होने से उसकी सेटिंग बदलने या बिल होने वाली कॉल करने की अनुमति नहीं मिलती।

डैशबोर्ड में Voice ऐप

दृश्यता

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

• लेग लॉग: Legs पेज पर हर लेग का विवरण। इसमें स्थिति, दोनों नंबर, वह ट्रंक जिस पर लेग आया, वह SIP प्रतिक्रिया जिसके साथ लेग समाप्त हुआ, कॉल उठाए जाने और समाप्त होने का समय, बिल योग्य समय और लागत शामिल हैं। इसे फ़िल्टर करें, फिर मेल खाने वाले रिकॉर्ड CSV के रूप में एक्सपोर्ट करें। CSV में अवधियाँ और बिल योग्य समय शामिल हैं, लेकिन लागत का कॉलम नहीं है; शुल्क की समीक्षा उपयोग, खर्च और इनवॉइस में करें।
• Voice इवेंट: voice_call.initiated, voice_call.answered और voice_call.ended आपके अपने एंडपॉइंट पर भेजे जाते हैं, ताकि आपके सिस्टम को पोलिंग किए बिना कॉल की जानकारी मिल जाए।

API संदर्भ में समर्थित सार्वजनिक HTTP अनुबंधों और SDK मेथड की सूची है। CLI संदर्भ और MCP टूल संदर्भ अपने प्रकाशित ऑपरेशन बताते हैं। ये सतहें अलग-अलग ऑपरेशन उपलब्ध करा सकती हैं; कोई डैशबोर्ड कार्रवाई या CLI कमांड अपने आप में किसी सार्वजनिक SDK मेथड का होना तय नहीं करती।

सीमाएँ

आपकी कॉल पर दोनों दिशाओं में तीन अधिकतम सीमाएँ लागू होती हैं: एक साथ कितनी कॉल चल सकती हैं, प्रति सेकंड कितनी नई कॉल शुरू हो सकती हैं, और UTC के अनुसार एक दिन में आप वॉइस पर कितना खर्च कर सकते हैं। आपका Voice प्लान आपके संगठन के लिए एक साथ चलने वाली कॉल और प्रति सेकंड नई कॉल की अधिकतम सीमाएँ तय करता है: उपयोग के अनुसार भुगतान वाले प्लान में डिफ़ॉल्ट मान लागू होते हैं, और ऊँचे Voice स्तरों में ये सीमाएँ बढ़ जाती हैं। दैनिक खर्च सीमा अलग तरह से काम करती है। हर वर्कस्पेस Voice > Spend limit में अपनी सीमा और Voice > Destinations में हर देश की सीमा तय करता है। ये सीमाएँ आपके संगठन की अधिकतम सीमा तक हो सकती हैं; सबसे बड़े Voice प्लान इस अधिकतम सीमा को बढ़ाते हैं। इनमें से किसी भी सीमा को पार करने वाली कॉल सेटअप के समय अस्वीकार कर दी जाती है। उसके रिकॉर्ड में बताया जाता है कि कौन-सी सीमा पार हुई, जैसा कि अस्वीकृत कॉल में दिया गया है। हर प्लान के मान Voice मूल्य निर्धारण पेज पर हैं; अपग्रेड करने के लिए Billing and payments > Overview पर जाएँ।

प्लैटफ़ॉर्म पर कॉल की अधिकतम अवधि 4 घंटे है। इतनी अवधि होने पर Bird कॉल के दोनों सिरों का कनेक्शन समाप्त कर देता है, इसलिए लंबे सत्र को एक से अधिक कॉल में बाँटने की योजना बनाएँ। कॉल सीक्वेंस चलाने वाली कॉल की अवधि उस समय से गिनी जाती है जब Bird ने उसे स्वीकार या प्राप्त किया था। इसलिए डायल करने के इंतज़ार और घंटी बजने में लगा समय भी इन्हीं 4 घंटों में शामिल होता है। स्थितियाँ में बताया गया है कि ऐसी कॉल लॉग में कैसे दिखाई देती है।

प्रति सेकंड की सीमा रेट सीमाएँ में दी गई voice_call नीति है। वहीं यह भी बताया गया है कि आपकी प्रभावी सीमा कैसे तय होती है और उसे कैसे बढ़ाएँ।

अगले कदम