Sign inGet Started

कॉल लॉग

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

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

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

कॉल सूची

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

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

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

लाइव कॉल

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

स्टेटसक्या हो रहा है
Ringingएक सक्रिय कॉल प्रयास उत्तर की प्रतीक्षा में है; यह पुष्टि नहीं करता कि गंतव्य पर रिंग हुई
In progressगंतव्य ने उठाया, और कॉल कनेक्ट है

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

खोज और फ़िल्टरिंग

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

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

Direction. आउटबाउंड या इनबाउंड लेग फ़िल्टर करें।

Status. Answered, no answer, failed, rejected या unknown में से किसी एक के लिए फ़िल्टर करें। हर एक स्टेटस में परिभाषित है। Live टैब पर विकल्प ringing और in progress हैं।

Date. कॉल लॉग पर, कोई प्रीसेट चुनें (पिछले 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 ट्रंक जिस पर कॉल आया, या जिस पर डिलीवर किया गया, उपयोगी जब कई साइट एक वर्कस्पेस साझा करती हैं
StartedBird ने लेग कब प्राप्त किया
Answeredलेग कब उठाया गया, या Not answered
Endedलेग कब समाप्त किया गया
Leg IDकनेक्शन रिकॉर्ड की अपनी ID (vcl_…)। इसे GET /v1/voice/legs/{leg_id} के साथ उपयोग करें और सपोर्ट को भेजते समय इसका हवाला दें।
Call IDएक कॉल के सभी लेग इसे साझा करते हैं (vcs_…)। संबंधित लेग खोजने के लिए call_id फ़िल्टर का उपयोग करें। फ़ॉरवर्ड की गई कॉल में दो लेग एक ही Call ID साझा करते हैं।
Billingबिल योग्य समय, कुल अवधि, और रेटिंग होने के बाद लेग की लागत

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

अस्वीकृत कॉल

एक अस्वीकृत कॉल को आगे ले जाने की बजाय अस्वीकार किया गया, और दो अलग-अलग चीज़ें यह परिणाम देती हैं।

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

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

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

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

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

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

ऐसे कारण जो Bird आपके लिए हल करता है

ये Bird के सेटअप पक्ष में होते हैं। सपोर्ट से संपर्क करें और रिकॉर्ड से Leg ID का हवाला दें:

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

अस्वीकृति कैसे पढ़ें

स्टेटस और अस्वीकृति कारण को एक साथ पढ़ें:

  • अस्वीकृति कारण सहित Rejected। Bird ने कॉल अस्वीकार किया, और कारण विफल हुई जाँच की पहचान करता है। SIP response वह 503 है जो आपके फ़ोन सिस्टम को प्राप्त हुआ। कारण के अकाउंट या रूटिंग समाधान का पालन करें।
  • बिना अस्वीकृति कारण के Rejected। आउटगोइंग कॉल पर, दूसरे छोर ने इसे सीधे अस्वीकार कर दिया और SIP response उसका कोड रखता है। इनकमिंग कॉल पर, डायल किए गए नंबर ने इसे वापस कर दिया, और Inbound route बताता है कि वह नंबर क्या करने के लिए सेट था।
  • Failed. कॉल का प्रयास किया गया और काम नहीं किया, और 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 server एजेंट्स को भी वही रीड उपलब्ध कराता है।
  • इवेंट सब्सक्राइब करें। voice_call.initiated, voice_call.answered और voice_call.ended कॉल होने पर आपके एंडपॉइंट पर पुश किए जाते हैं, ताकि आपके सिस्टम बिना पोलिंग के अपडेट रहें। देखें वॉइस इवेंट।

अगले चरण

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

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