कॉल लॉग
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 | गंतव्य ने उठाया, और कॉल कनेक्ट है |
कॉलम लेग लॉग जैसे ही हैं, सिवाय 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 ट्रंक जिस पर कॉल आया, या जिस पर डिलीवर किया गया, उपयोगी जब कई साइट एक वर्कस्पेस साझा करती हैं |
| Started | Bird ने लेग कब प्राप्त किया |
| 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_verified | From हेडर में मौजूद नंबर न तो कोई पात्र 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_blocked | Bird का रूटिंग कॉन्फ़िगरेशन उस गंतव्य पर कॉल को ब्लॉक करता है |
call_not_permitted | Bird आपके अकाउंट के लिए कॉल पूरी नहीं कर पाया, इसलिए अज्ञात शर्तों पर कॉल करने के बजाय उसे अस्वीकार कर दिया |
अस्वीकृति कैसे पढ़ें
स्टेटस और अस्वीकृति कारण को एक साथ पढ़ें:
- अस्वीकृति कारण सहित 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 त्रुटि प्रतिक्रिया और उसके रिकवरी फ़ील्ड |
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।