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 की पूर्व-आवश्यकताओं का पालन करती हैं।

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

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

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

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

दृश्यता

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

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

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

सीमाएँ

आपकी कॉल पर दोनों दिशाओं में तीन सीमाएँ लागू होती हैं: एक साथ कितनी कॉल चल सकती हैं, प्रति सेकंड कितनी नई कॉल की जा सकती हैं, और एक UTC दिन में आप Voice पर कितना खर्च कर सकते हैं। हर सीमा प्रति संगठन तय होती है, और उसकी मात्रा आपके प्लान पर निर्भर करती है। इनमें से किसी भी सीमा से अधिक होने वाली कॉल सेटअप के समय ही अस्वीकार कर दी जाती है, और उसके रिकॉर्ड में अस्वीकृत कॉल के अंतर्गत लिखा होता है कि कौन-सी सीमा पार हुई।

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

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

अगले कदम