कॉल लॉग
Voice > Calls के अंतर्गत कॉल लॉग आपके वर्कस्पेस द्वारा किए गए हर कॉल और उसके नंबरों पर आए हर कॉल को नवीनतम पहले दिखाता है। हर एंट्री एक कॉल डिटेल रिकॉर्ड (CDR) है, जिसमें कनेक्ट हुए, बिना उत्तर रहे या अस्वीकार किए गए कॉल शामिल हैं। इसका उपयोग अवधि, अंतिम SIP प्रतिक्रिया और लागत की जाँच के लिए करें।
Bird हर रिकॉर्ड कॉल समाप्त होने पर लिखता है, इसलिए लॉग में हर कॉल का एक अंतिम परिणाम होता है। इसके बगल में Live टैब उन कॉल को दिखाता है जो अभी चालू हैं।
कॉल सूची
हर पंक्ति एक कॉल है:
| कॉलम | यह क्या दिखाता है |
|---|---|
| Status | कॉल कैसे समाप्त हुआ (देखें स्टेटस) |
| From | कॉल करने वाला नंबर, आपके उपकरण द्वारा प्रस्तुत caller ID |
| To | जिस नंबर पर कॉल किया गया |
| Direction | आपके उपकरण द्वारा किए गए कॉल के लिए outbound, आपके नंबरों पर आए कॉल के लिए inbound |
| Duration | कॉल की कुल अवधि, Bird द्वारा प्राप्त होने से लेकर हैंगअप तक |
| Started | Bird ने कॉल कब प्राप्त किया |
सूची पृष्ठांकित है, प्रति पृष्ठ 25 कॉल। कॉल खोलने के लिए कोई भी पंक्ति चुनें।
लाइव कॉल
Live टैब अभी चालू कॉल दिखाता है, और एक गिनती रखता है ताकि आप बिना खोले देख सकें कि कितने चालू हैं। एक लाइव कॉल में दो स्टेटस में से एक होता है:
| स्टेटस | क्या हो रहा है |
|---|---|
| Ringing | कॉल अपने गंतव्य तक पहुँचा, जिसने अभी तक उठाया नहीं है |
| In progress | गंतव्य ने उठाया, और कॉल कनेक्ट है |
कॉलम कॉल लॉग से मेल खाते हैं, सिवाय Elapsed के, जो Duration की जगह लेता है। यह कनेक्ट हुए कॉल के लिए उत्तर से और रिंग हो रहे कॉल के लिए शुरुआत से गिनता है। टैब हर कुछ सेकंड में रिफ़्रेश होता है। जब कोई कॉल समाप्त होता है, तो वह अपने अंतिम परिणाम के साथ कॉल लॉग में चला जाता है।
खोज और फ़िल्टरिंग
पृष्ठ की शुरुआत नंबर खोज और उसके फ़िल्टर से होती है। ये मिलकर काम करते हैं: एक स्टेटस फ़िल्टर और एक तारीख़ सीमा मिलकर दोनों से मेल खाने वाले कॉल दिखाते हैं।
नंबर से खोजें। खोज बॉक्स कॉल के दोनों ओर नंबर मिलाता है, इसलिए एक क्वेरी उस नंबर पर किए गए और उससे आए दोनों कॉल ढूँढती है।
Direction. Outbound या inbound कॉल के लिए फ़िल्टर करें।
Status. Answered, no answer, failed, rejected या unknown में से किसी एक के लिए फ़िल्टर करें। हर एक स्टेटस में परिभाषित है। Live टैब पर विकल्प ringing और in progress हैं।
Date. कॉल लॉग पर, कोई प्रीसेट चुनें (पिछले 24 घंटे, 7 दिन या 30 दिन) या कैलेंडर पर कस्टम सीमा चुनें।
इस महीने का उपयोग
मासिक सारांश में UTC में वर्तमान कैलेंडर माह के लिए तीन टाइल हैं:
| टाइल | यह क्या गिनता है |
|---|---|
| Calls | महीने में पूर्ण कॉल रिकॉर्ड, जिनमें अनुत्तरित और अस्वीकृत कॉल शामिल हैं |
| Total duration | हर कॉल की पूरी अवधि का योग, Bird द्वारा प्राप्त होने से हैंगअप तक |
| Billable time | हर कॉल के उत्तर दिए गए समय का योग |
कुल अवधि और बिल योग्य समय के बीच का अंतर अनुत्तरित रिंग समय है। अनुत्तरित कॉल का कोई बिल योग्य समय नहीं होता।
हर गंतव्य दर बिल योग्य समय को अपनी बिलिंग इंक्रीमेंट तक गोल करती है। मूल्य निर्धारण के विवरण के लिए लागत और बिलिंग देखें।
ये टाइल पूरे महीने को कवर करते हैं, चाहे आप सूची को किसी भी तरह फ़िल्टर करें।
स्टेटस
लॉग में कोई कॉल इनमें से किसी एक परिणाम के साथ समाप्त हुआ:
| स्टेटस | क्या हुआ |
|---|---|
| Answered | गंतव्य ने उठाया। बिल योग्य समय उत्तर से हैंगअप तक है |
| No answer | कॉल गंतव्य पर बजा और टाइम आउट होने से पहले उत्तर नहीं दिया गया |
| Rejected | कॉल को आगे ले जाने की बजाय अस्वीकार किया गया |
| Failed | कॉल का प्रयास किया गया लेकिन काम नहीं किया, और SIP response वापस आया |
| Unknown | परिणाम निर्धारित नहीं हो सका, उदाहरण के लिए जब कोई अंतिम प्रतिक्रिया कभी नहीं आई |
Rejected दो प्रकार की अस्वीकृतियों को कवर करता है, और अस्वीकृति का कारण उन्हें अलग करता है। या तो Bird ने कैरियर शामिल होने से पहले कॉल अस्वीकार किया, जिस स्थिति में कारण विफल हुई जाँच का नाम बताता है, या दूसरे छोर ने इसे सीधे अस्वीकार कर दिया, जिस स्थिति में SIP response उसका उत्तर रखता है और कोई कारण नहीं होता। कोई इनकमिंग कॉल जिसे डायल किए गए नंबर ने वापस कर दिया, वह भी बिना कारण के Rejected है, क्योंकि वह कोई जाँच विफल नहीं हुआ: उसका Inbound route बताता है कि नंबर क्या करने के लिए सेट था। देखें अस्वीकृत कॉल।
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 | कॉल कब समाप्त किया गया |
| Call ID | रिकॉर्ड की अपनी id (vcl_…)। सपोर्ट को यह बताएँ, और अपने लॉग से मिलान के लिए इसका उपयोग करें |
| Session ID | एक कॉल के हर लेग द्वारा साझा (vcs_…), ताकि संबंधित रिकॉर्ड को समूहित किया जा सके। एक फ़ॉरवर्ड किए गए कॉल के दो लेग एक साझा करते हैं |
| Billing | बिल योग्य समय, कुल अवधि, और रेट किए जाने के बाद कॉल की लागत |
Inbound route केवल इनकमिंग कॉल पर दिखता है, और यह बताता है कि नंबर क्या करने के लिए सेट था, न कि यह काम किया: एक अस्वीकृत कॉल पर ट्रंक रूट का मतलब है कि नंबर ट्रंक की ओर था लेकिन ट्रंक ने कॉल नहीं लिया। कॉल प्राप्त करना तीनों उत्तरों और हर एक क्या रिकॉर्ड करता है, यह कवर करता है।
अस्वीकृत कॉल
एक अस्वीकृत कॉल को आगे ले जाने की बजाय अस्वीकार किया गया, और दो अलग-अलग चीज़ें यह परिणाम देती हैं।
Bird ने कैरियर शामिल होने से पहले इसे अस्वीकार किया। डायल करने से पहले, Bird caller ID, गंतव्य, अकाउंट सीमाएँ और वॉलेट बैलेंस जाँचता है, और इनमें से किसी में विफल कॉल को अस्वीकार करता है। आपका फ़ोन सिस्टम SIP 503 प्राप्त करता है, जबकि प्रमाणित कॉल रिकॉर्ड विशिष्ट कारण संग्रहित करता है। यह अप्रमाणित कॉलर्स को अकाउंट विवरण जानने से रोकता है। कारण और संबंधित सेटिंग का लिंक देखने के लिए कॉल खोलें।
डायल किए गए नंबर ने कॉल वापस कर दिया। रिजेक्ट पर सेट किसी नंबर पर, या ऐसे नंबर पर जिसे किसी ने कहीं पॉइंट नहीं किया, आने वाला कॉल बिना किसी कारण के अस्वीकृत है: यह हमारी कोई जाँच विफल नहीं हुआ। Inbound route यही बताता है। कॉल प्राप्त करना उन अस्वीकृतियों को विस्तार से बताता है।
नीचे दिए गए कारण पहले प्रकार के हैं। ये इनकमिंग और आउटगोइंग दोनों कॉल पर लागू होते हैं, क्योंकि अकाउंट सीमाएँ और वॉलेट दोनों तरह से जाँचे जाते हैं।
जिन कारणों को आप ठीक कर सकते हैं
| कारण | क्या हुआ | क्या करें |
|---|---|---|
| source_not_allowed | कॉल ऐसे पते से आया जो ट्रंक की IP अनुमति सूची में शामिल नहीं है | अपने फ़ोन सिस्टम का भेजने वाला पता ट्रंक में जोड़ें |
| caller_id_not_verified | From हेडर में मौजूद नंबर इस वर्कस्पेस के लिए सत्यापित caller ID नहीं है | वह नंबर सत्यापित करें, या पहले से सत्यापित नंबर प्रस्तुत करें |
| 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 के सेटअप की तरफ़ होते हैं। सपोर्ट से संपर्क करें और रिकॉर्ड से Call ID बताएँ:
| कारण | क्या हुआ |
|---|---|
| routing_not_configured | आपके वर्कस्पेस की रूटिंग अभी अटैच हो रही है, जो एक नया वॉइस सेटअप पूरा होने तक अपेक्षित है |
| no_route_found | रूटिंग अटैच है, लेकिन आपने जो नंबर डायल किया उसे कवर नहीं करती। रूट जाँचने के लिए कॉल 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 एक्सपोर्ट करें। Call log टैब पर Download CSV आपके वर्तमान फ़िल्टर से मेल खाने वाले सभी पृष्ठों के हर रिकॉर्ड को एक्सपोर्ट करता है। इसे सुलह और ऐड-हॉक रिपोर्टिंग के लिए उपयोग करें।
- API के ज़रिए पढ़ें। GET /v1/voice/calls फ़िल्टर की गई सूची लौटाता है, और GET /v1/voice/calls/{call_id} एक रिकॉर्ड लौटाता है। दोनों के लिए read स्तर पर voice स्कोप वाली API कुंजी आवश्यक है। ट्रंक, caller ID और गंतव्य सेटिंग सार्वजनिक API का हिस्सा नहीं हैं।
- टर्मिनल से पढ़ें। Bird CLI bird voice list, bird voice get और bird voice stats प्रदान करता है। MCP server एजेंट्स को वही रीड उपलब्ध कराता है।
- इवेंट सब्सक्राइब करें। voice_call.initiated, voice_call.answered और voice_call.ended कॉल होने पर आपके एंडपॉइंट पर पुश किए जाते हैं, ताकि आपके सिस्टम बिना पोलिंग के अपडेट रहें। देखें वॉइस इवेंट।
अगले चरण
| पृष्ठ | यह क्या कवर करता है |
|---|---|
| वॉइस इवेंट | तीन कॉल इवेंट, उनके पेलोड, और उन्हें कैसे उपयोग करें |
| कॉल करना | Bird INVITE पर क्या अपेक्षा करता है, और कॉल की कीमत कैसे तय होती है |
| कॉल प्राप्त करना | किसी नंबर को ट्रंक या फ़ॉरवर्ड की ओर पॉइंट करना, और यह क्या रिकॉर्ड करता है |
| SIP ट्रंक | IP अनुमति सूची, अनुमत API कुंजियाँ और Digest सेटिंग |
| वॉइस गंतव्य | देशों को सक्षम करना, और उपलब्धता का क्या मतलब है |
| त्रुटियाँ | API त्रुटि प्रतिक्रिया और उसके रिकवरी फ़ील्ड |
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।