Voice अवलोकन

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

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

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

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

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

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

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

इनकमिंग कॉल का जवाब कैसे दिया जाता है

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

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

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

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

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

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

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

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

पृष्ठ	किसके लिए है
मेट्रिक्स	समय के साथ कॉल वॉल्यूम और उत्तर दर, कॉल परिणाम, शीर्ष देश, और इनबाउंड व आउटबाउंड विभाजन। देखें Voice मेट्रिक्स
लेग	वर्कस्पेस कॉल के प्रति-लेग रिकॉर्ड, महीने के उपयोग योग के साथ
कॉल	संबंधित लेग और प्रतिभागी एक कॉल में समूहित
नंबर	वर्कस्पेस द्वारा वॉइस के लिए उपयोग किया जा सकने वाला हर नंबर, और हर नंबर इनकमिंग कॉल के साथ क्या करता है
SIP ट्रंक	आपके ट्रंक, उनका SIP डोमेन, कौन उन पर ट्रैफ़िक भेज सकता है, और इनबाउंड कॉल कहाँ डिलीवर होती हैं
गंतव्य	जिन देशों में आपका वर्कस्पेस कॉल कर सकता है, डिफ़ॉल्ट रूप से बंद
सीक्वेंस	कॉल वर्कफ़्लो बनाएँ, उनका पूर्वावलोकन करें, उन्हें प्रकाशित करें और उनके निष्पादन की जाँच करें
फ़ोन	एक फ़्लोटिंग फ़ोन जो ब्राउज़र से, आपके किसी एक ट्रंक पर कॉल करता है

दृश्यता

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

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

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

सीमाएँ

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

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

अगले कदम

पृष्ठ	क्या शामिल है
अपनी पहली कॉल करें	एक खाली वर्कस्पेस से लेकर बजते हुए फ़ोन तक
फ़ोन	डैशबोर्ड से कॉल करना, इसके लिए क्या चाहिए, और कॉल के दौरान आप क्या कर सकते हैं
SIP ट्रंक	ट्रंक बनाना, उसके कनेक्शन विवरण, और कौन भेज सकता है इसे नियंत्रित करना
कॉल करना	Bird INVITE पर क्या अपेक्षा करता है, और एक कॉल की लागत क्या है
कॉल प्राप्त करना	नंबर को ट्रंक या फ़ॉरवर्ड पर पॉइंट करना, और यह क्या रिकॉर्ड करता है
कॉलर IDs	नंबर रजिस्टर करना और सत्यापन कॉल से यह साबित करना कि वह आपका है
Voice गंतव्य	जिन देशों में आप कॉल करते हैं उन्हें चालू करना, और उच्च जोखिम का क्या अर्थ है
लेग लॉग	अपने लेग रिकॉर्ड ब्राउज़ करना, फ़िल्टर करना और एक्सपोर्ट करना
Voice इवेंट	तीन कॉल इवेंट और उनके पेलोड
समस्या निवारण	जो कॉल नहीं लगती उसके लक्षण से निदान करना
वेबहुक और इवेंट	एंडपॉइंट सेटअप, सिग्नेचर सत्यापन, फिर से प्रयास, और रीप्ले

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