कॉल लॉग

Voice > Legs के अंतर्गत लेग लॉग में वे सभी कनेक्शन दिखते हैं जो आपके वर्कस्पेस ने किए या प्राप्त किए, सबसे नए पहले। एक कॉल में कई लेग हो सकते हैं, जैसे आने वाला कनेक्शन और फ़ॉरवर्ड किया गया कनेक्शन। हर एंट्री एक कॉल डिटेल रिकॉर्ड (CDR) है, जिसमें वे कनेक्शन भी शामिल हैं जिनका जवाब नहीं मिला या जो अस्वीकार हुए। अवधि, अंतिम SIP प्रतिक्रिया और लागत देखने के लिए इसका उपयोग करें।

Bird लेग समाप्त होने पर ही रिकॉर्ड लिखता है, इसलिए लॉग की हर एंट्री का एक अंतिम परिणाम होता है। इसके बगल वाले Live टैब में वे लेग होते हैं जो अभी चल रहे हैं।

पूरी बातचीत देखने के लिए Voice > Calls खोलें। एक कॉल संबंधित लेग और प्रतिभागियों को एक साथ समूहित करती है। आपस में मिलान के लिए Call ID रखें और किसी एक कनेक्शन की जाँच के लिए Leg ID; ये दोनों अलग-अलग रिकॉर्ड की पहचान करते हैं।

कॉल सूची

हर पंक्ति एक लेग है। कई लेग वाली कॉल की कई पंक्तियाँ होती हैं:

कॉलम	यह क्या दिखाता है
Status	लेग किस तरह समाप्त हुआ (स्टेटस देखें)
From	कॉल करने वाला नंबर, यानी वह कॉलर ID जो आपके उपकरण ने प्रस्तुत की
To	वह नंबर जिस पर कॉल की गई
Direction	आपके उपकरण द्वारा की गई लेग के लिए आउटबाउंड, और आपके नंबरों पर आई लेग के लिए इनबाउंड
Duration	लेग की कुल अवधि, जब Bird ने उसे प्राप्त किया तब से कॉल समाप्त होने तक
Started	जब Bird ने लेग प्राप्त की

सूची पेजों में बँटी है, हर पेज पर 25 लेग। लेग रिकॉर्ड खोलने के लिए कोई भी पंक्ति चुनें।

लाइव कॉल

Live टैब में वे लेग दिखते हैं जो इस समय चालू हैं। इस टैब पर एक गिनती भी दिखती है, ताकि आप इसे खोले बिना जान सकें कि कितने लेग चालू हैं। लाइव लेग की स्थिति इन दो में से एक होती है:

स्थिति	क्या हो रहा है
Ringing	कॉल का एक सक्रिय प्रयास जवाब की प्रतीक्षा कर रहा है; इससे यह पुष्टि नहीं होती कि गंतव्य पर घंटी बजी
In progress	गंतव्य ने कॉल उठा ली है और कॉल कनेक्ट है

इसके कॉलम लेग लॉग जैसे ही हैं, बस Duration की जगह Elapsed होता है। कनेक्ट हुए लेग के लिए यह जवाब मिलने के समय से गिनता है, और बज रहे लेग के लिए शुरुआत से। यह टैब हर कुछ सेकंड में रीफ़्रेश होता है। लेग खत्म होने पर वह अपने अंतिम नतीजे के साथ लेग लॉग में चला जाता है।

खोजना और फ़िल्टर करना

पेज में सबसे ऊपर नंबर से खोजने का बॉक्स और उसके फ़िल्टर होते हैं। फ़िल्टर एक साथ लागू होते हैं: स्थिति फ़िल्टर और तारीख की सीमा चुनने पर केवल वे लेग दिखते हैं जो दोनों से मेल खाते हैं।

नंबर से खोजें। खोज बॉक्स नंबर को लेग के दोनों छोरों से मिलाता है, इसलिए एक ही खोज में उस नंबर पर किए गए और उस नंबर से आए, दोनों तरह के लेग मिल जाते हैं।

दिशा। केवल आउटबाउंड या इनबाउंड लेग दिखाने के लिए फ़िल्टर करें।

स्थिति। उत्तर दिया गया, कोई उत्तर नहीं, विफल, अस्वीकृत या अज्ञात में से किसी एक के आधार पर फ़िल्टर करें। हर स्थिति की परिभाषा स्थितियाँ में दी गई है। Live टैब पर विकल्प बज रहा है और जारी है होते हैं।

तारीख। कॉल लॉग पर कोई प्रीसेट चुनें (पिछले 24 घंटे, 7 दिन या 30 दिन) या कैलेंडर पर अपनी पसंद की अवधि चुनें।

इस महीने का उपयोग

मासिक सारांश में UTC के अनुसार चालू कैलेंडर महीने की तीन टाइलें होती हैं:

टाइल	यह क्या गिनती है
Legs	महीने में पूरे हुए लेग रिकॉर्ड, जिनमें बिना उत्तर वाले और अस्वीकृत लेग भी शामिल हैं
Total duration	हर लेग की पूरी अवधि का योग, उस क्षण से जब Bird ने उसे प्राप्त किया, कॉल समाप्त होने तक
Billable time	हर लेग के उत्तर दिए गए समय का योग

कुल अवधि और बिल योग्य समय के बीच का अंतर बिना उत्तर वाली रिंग का समय है। जिस लेग का उत्तर नहीं दिया गया, उसका कोई बिल योग्य समय नहीं होता।

हर गंतव्य दर बिल योग्य समय को अपनी बिलिंग वृद्धि तक राउंड करती है। मूल्य निर्धारण के विवरण के लिए लागत और बिलिंग देखें।

आप सूची को किसी भी तरह फ़िल्टर करें, ये टाइलें पूरे महीने को कवर करती हैं।

स्थितियाँ

लॉग में मौजूद हर लेग इनमें से किसी एक परिणाम के साथ समाप्त हुआ:

स्थिति	क्या हुआ
Answered	गंतव्य ने कॉल उठाई। बिल योग्य समय उत्तर से हैंगअप तक गिना जाता है
No answer	प्रयास बिना उत्तर के टाइम आउट हो गया; इससे यह साबित नहीं होता कि गंतव्य का फ़ोन बजा
Rejected	कॉल को आगे पहुँचाने के बजाय अस्वीकार कर दिया गया
Failed	कॉल का प्रयास किया गया पर वह सफल नहीं हुई, और `SIP response` वह है जो वापस आया
Unknown	परिणाम तय नहीं किया जा सका, उदाहरण के लिए जब कोई अंतिम प्रतिक्रिया कभी नहीं आई

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

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

Failed अस्वीकार नहीं है। इसका अर्थ है कि कॉल का प्रयास किया गया पर वह सफल नहीं हुई: व्यस्त नंबर कैरियर प्रतिक्रिया 486 के साथ Failed होता है, और आवंटित न किया गया नंबर 404 के साथ Failed होता है।

अगर आप ये मान अपने टूल से पढ़ते हैं, तो जिन मानों को आप संभालते हैं उनका मिलान करें, और किसी भी अन्य मान को त्रुटि के बजाय ऐसी स्थिति मानें जिसे आप नहीं संभालते। सूची में busy और canceled भी हैं, जो आपके अपने नंबरों पर पहुँचाई गई इनकमिंग कॉल के लिए आरक्षित हैं। इनमें से कोई भी अभी जारी नहीं होता, और दोनों परिणाम फ़िलहाल failed के रूप में रिपोर्ट होते हैं।

कॉल की जाँच करना

कोई लेग खोलने पर वह दिखता है जो Bird ने उस कनेक्शन के बारे में दर्ज किया:

फ़ील्ड	इससे आपको क्या पता चलता है
Status	लेग का परिणाम (देखें स्थितियाँ)। जिस लेग को Bird ने अस्वीकार किया, उसमें कारण और उसे ठीक करने का तरीका भी दिखता है
SIP response	लेग का अंतिम SIP कोड, जैसे `200` या `486`। जिस लेग को Bird ने अस्वीकार किया, उसमें `503` होता है और कोई कैरियर शामिल नहीं होता
From / To	दोनों नंबर, जिन्हें अलग-अलग कॉपी किया जा सकता है
Inbound route	इनकमिंग कॉल पर नंबर के लिए चुना गया रूट, जैसे ट्रंक, फ़ॉरवर्ड, सीक्वेंस या अस्वीकृति। यह उस नंबर से लिंक करता है
Trunk	वह SIP ट्रंक जिस पर कॉल आई या जिस पर उसे पहुँचाया गया। जब कई साइटें एक ही वर्कस्पेस साझा करती हैं, तब यह उपयोगी है
Started	जब Bird को लेग मिला
Answered	जब लेग उठाया गया, या Not answered
Ended	जब लेग बंद किया गया
Leg ID	कनेक्शन रिकॉर्ड की अपनी ID (`vcl_…`)। इसे `GET /v1/voice/legs/{leg_id}` के साथ इस्तेमाल करें और सपोर्ट से संपर्क करते समय इसका उल्लेख करें।
Call ID	एक कॉल के हर लेग में समान (`vcs_…`)। संबंधित लेग खोजने के लिए `call_id` फ़िल्टर का इस्तेमाल करें। फ़ॉरवर्ड की गई कॉल में दो लेग होते हैं, जिनकी कॉल ID एक ही होती है।
Billing	बिल योग्य समय, कुल अवधि, और रेट तय होने के बाद लेग की लागत

Inbound route इनकमिंग कॉल पर दिखता है और चुने गए रूट को दर्ज करता है। अगर अस्वीकार की गई कॉल पर ट्रंक रूट दिखे, तो इसका मतलब है कि कॉल किसी काम करने वाले उत्तर तक नहीं पहुँची। कॉल प्राप्त करना में रूट और हर रूट द्वारा दर्ज की जाने वाली जानकारी बताई गई है।

अस्वीकार की गई कॉल

अस्वीकार की गई कॉल आगे नहीं ले जाई गई, बल्कि उसे मना कर दिया गया। ऐसा दो अलग-अलग कारणों से होता है।

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

डायल किए गए नंबर ने कॉल लौटा दी। अगर कोई इनकमिंग कॉल ऐसे नंबर पर आती है जो अस्वीकार करने के लिए सेट है, या ऐसे नंबर पर जिसका अपना कोई रूट नहीं है और वर्कस्पेस का डिफ़ॉल्ट रूट अस्वीकार है, तो वह बिना किसी कारण के अस्वीकार होती है। वजह यह है कि वह हमारी कोई जाँच विफल नहीं करती। यह बात Inbound route से पता चलती है। कॉल प्राप्त करना इन अस्वीकृतियों को विस्तार से समझाता है।

नीचे दिए गए कारण पहली तरह के हैं। ये आउटगोइंग कॉल के साथ-साथ इनकमिंग कॉल पर भी लागू होते हैं, क्योंकि खाते की सीमाएँ और वॉलेट दोनों ही स्थितियों में जाँचे जाते हैं।

वे कारण जिन्हें आप ठीक कर सकते हैं

कारण	क्या हुआ	क्या करें
`source_not_allowed`	कॉल ऐसे पते से आई जो ट्रंक की IP अनुमति सूची में शामिल नहीं है	आपका फ़ोन सिस्टम जिस पते से कॉल भेजता है, उसे ट्रंक में जोड़ें
`caller_id_not_verified`	`From` हेडर में दिया गया नंबर इस वर्कस्पेस में न तो कोई योग्य Bird नंबर है और न ही कोई सत्यापित बाहरी कॉलर ID	कोई योग्य Bird नंबर इस्तेमाल करें, या बाहरी नंबर को सत्यापित करें
`destination_not_enabled`	आपके वर्कस्पेस के लिए उस देश में कॉल करना बंद है	Destinations में जाकर उस देश को चालू करें
`insufficient_balance`	आपके वॉलेट में कॉल के लिए पर्याप्त बैलेंस नहीं था, इसलिए Bird ने कॉल को पहले ही अस्वीकार कर दिया	बैलेंस टॉप अप करें, या अपने-आप टॉप-अप चालू करें ताकि कम बैलेंस के कारण कॉलिंग न रुके
`daily_spend_exceeded`	यह कॉल आपके वर्कस्पेस की दैनिक वॉइस खर्च सीमा को पार कर जाती, या आउटगोइंग कॉल के मामले में कॉल किए गए देश की सीमा को	अगले UTC दिन की शुरुआत में सीमा रीसेट होने तक प्रतीक्षा करें, या Voice → Spend limit में यह सीमा बढ़ाएँ, या देश की सीमा Voice → Destinations में बढ़ाएँ, अपने संगठन की अधिकतम सीमा तक
`concurrent_calls_exceeded`	आपकी उतनी कॉल चल रही हैं जितनी आपका खाता अनुमति देता है	किसी कॉल के समाप्त होने तक प्रतीक्षा करें, या ऊँची सीमा के लिए Billing and payments में अपना Voice प्लान अपग्रेड करें
`calls_per_second_exceeded`	आपने नई कॉल उस दर से तेज़ की हैं जितनी आपका खाता अनुमति देता है	अपनी डायल दर धीमी करें, फिर फिर से प्रयास करें। तुरंत फिर से प्रयास करने पर वही उत्तर मिलता है। ऊँचा Voice प्लान प्रति सेकंड की सीमा बढ़ाता है
`number_ownership_not_verified`	आपने यह नंबर खरीदा है, लेकिन इसे जारी करने वाले देश ने आपके स्वामित्व को साबित करने वाले दस्तावेज़ स्वीकार नहीं किए हैं	नंबर के `ownership` फ़ील्ड में माँगी गई जानकारी पूरी करें, फिर कॉल दोबारा करें

कैंपेन डायलर एक साथ चलने वाली कॉल की सीमा से बहुत दूर रहते हुए भी calls_per_second_exceeded पा सकता है, इसलिए कुछ भी बदलने से पहले जाँचें कि इन दोनों में से कौन-सा कारण मिला है।

वे कारण जिन्हें Bird आपके लिए हल करता है

ये कारण सेटअप में Bird की ओर से हैं। सपोर्ट से संपर्क करें और रिकॉर्ड से Leg ID बताएँ:

कारण	क्या हुआ
`routing_not_configured`	आपके वर्कस्पेस की रूटिंग अभी जोड़ी जा रही है, जो नए वॉइस सेटअप के पूरा होने के दौरान अपेक्षित है
`no_route_found`	रूटिंग जुड़ी हुई है, लेकिन उसमें आपका डायल किया गया नंबर शामिल नहीं है। रूट की जाँच के लिए लेग ID के साथ सपोर्ट से संपर्क करें
`destination_blocked`	Bird का रूटिंग कॉन्फ़िगरेशन उस गंतव्य पर कॉल को ब्लॉक करता है
`call_not_permitted`	Bird आपके खाते के लिए कॉल पूरी नहीं कर सका, इसलिए उसने अज्ञात शर्तों पर कॉल करने के बजाय उसे अस्वीकार कर दिया

अस्वीकृति को कैसे समझें

स्टेटस और अस्वीकृति का कारण एक साथ देखें:

अस्वीकार किया गया, अस्वीकृति कारण के साथ। Bird ने कॉल अस्वीकार की, और कारण बताता है कि कौन-सी जाँच विफल हुई। SIP response वही 503 है जो आपके फ़ोन सिस्टम को मिला। कारण में बताए गए खाते या रूटिंग के समाधान का पालन करें।
अस्वीकार किया गया, बिना अस्वीकृति कारण के। आउटगोइंग कॉल पर, दूसरी ओर ने कॉल सीधे अस्वीकार कर दी और SIP response में उसका कोड होता है। इनकमिंग कॉल पर, डायल किए गए नंबर ने कॉल लौटा दी, और Inbound route बताता है कि उस नंबर को क्या करने के लिए सेट किया गया था।
विफल। कॉल का प्रयास किया गया पर वह सफल नहीं हुई, और SIP response में लौटकर आया कोड होता है। 486 का अर्थ है नंबर व्यस्त है, जबकि 404 का अर्थ है नंबर आवंटित नहीं है। आम तौर पर इसका कारण आपका सेटअप नहीं, बल्कि नंबर होता है।

जिस कॉल को Bird बिल्कुल स्वीकार नहीं कर सकता, वह रिकॉर्ड बनने से पहले ही लौटा दी जाती है, इसलिए वह लॉग में कभी नहीं पहुँचती। ऐसी कॉल के बारे में वॉइस समस्या निवारण देखें।

रिकॉर्ड बाहर निकालना

डैशबोर्ड के बाहर इन रिकॉर्ड के साथ काम करने के चार तरीके:

CSV एक्सपोर्ट करें। Leg log टैब पर Download CSV आपके मौजूदा फ़िल्टर से मेल खाने वाले सभी पेजों के रिकॉर्ड एक्सपोर्ट करता है, अधिकतम 10,000 लेग तक। इससे बड़े चयन पर कोई फ़ाइल नहीं मिलती और त्रुटि लौटती है; अपनी तारीख सीमा या फ़िल्टर छोटे करें और हर चयन को अलग से एक्सपोर्ट करें। इसका उपयोग मिलान और तात्कालिक रिपोर्टिंग के लिए करें।
API से पढ़ें। GET /v1/voice/legs फ़िल्टर की गई सूची लौटाता है, और GET /v1/voice/legs/{leg_id} एक रिकॉर्ड लौटाता है। दोनों के लिए read स्तर पर voice स्कोप वाली API कुंजी चाहिए। अन्य Voice संसाधनों के प्रकाशित ऑपरेशन और उनके ज़रूरी स्कोप के लिए API संदर्भ देखें।
टर्मिनल से पढ़ें। Bird CLI में bird voice legs list, bird voice legs get और bird voice stats उपलब्ध हैं। MCP सर्वर यही रीड एजेंट को उपलब्ध कराता है।
इवेंट की सदस्यता लें। कॉल होते ही voice_call.initiated, voice_call.answered और voice_call.ended आपके एंडपॉइंट पर भेजे जाते हैं, इसलिए पोलिंग के बिना आपके सिस्टम अद्यतन रहते हैं। वॉइस इवेंट देखें।

अगले कदम

पेज	इसमें क्या शामिल है
वॉइस इवेंट	तीनों कॉल इवेंट, उनके पेलोड और उन्हें कैसे उपयोग करें
कॉल करना	Bird `INVITE` पर क्या अपेक्षा करता है, और कॉल की कीमत कैसे तय होती है
कॉल प्राप्त करना	किसी नंबर को ट्रंक या फ़ॉरवर्ड पर निर्देशित करना, और वह क्या दर्ज करता है
SIP ट्रंक	IP अनुमति सूची, अनुमत API कुंजियाँ और Digest सेटिंग्स
वॉइस गंतव्य	देशों को चालू करना, और उपलब्धता का क्या अर्थ है
त्रुटियाँ	API त्रुटि प्रतिक्रिया और उसके रिकवरी फ़ील्ड

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

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

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