Sign inGet Started

SMS डिलीवरी त्रुटियाँ

एक असफल SMS में एक डिलीवरी स्टेटस और परिणाम बताने वाली एक त्रुटि होती है। मैसेज के साथ रिपोर्ट किए गए विफलता कारण और न्यूमेरिक प्रोवाइडर कोड को समझने के लिए इस संदर्भ का उपयोग करें।

अमान्य भेजने के पेलोड जैसी अनुरोध त्रुटियाँ API त्रुटि कैटलॉग का उपयोग करती हैं। इस पृष्ठ पर दिए गए कोड उन मैसेज का वर्णन करते हैं जो स्वीकार किए गए और बाद में विफल हुए या अस्वीकार कर दिए गए।

त्रुटि पढ़ना

SMS लॉग में एक मैसेज खोलें और Details चुनें। Error विवरण और नॉर्मलाइज़्ड विफलता कारण दिखाता है। Carrier error code न्यूमेरिक प्रोवाइडर कोड दिखाता है जब कोई उपलब्ध कराया गया हो।

API के माध्यम से, GET /v1/sms/messages/{message_id} पढ़ें। इसके last_error में शामिल हैं:

फ़ील्डअर्थ
codeBird का नॉर्मलाइज़्ड विफलता कारण, जैसे unreachable या unknown
descriptionशब्दों में रिपोर्ट किया गया विवरण
carrier_error_codeप्रदाता का रॉ कोड, जब उपलब्ध कराया गया हो
occurred_atविफलता कब हुई

विफलता webhook इवेंट और मैसेज टाइमलाइन इवेंट में error में वही फ़ील्ड होते हैं।

फ़ील्ड नाम carrier_error_code में Bird के भेजने वाले प्रदाता द्वारा जारी किए गए कोड भी शामिल हैं, जिनमें फ्रॉड प्रोटेक्शन ब्लॉक भी हैं। कोड का अनुपस्थित होना मतलब प्रदाता ने कोई कोड नहीं दिया या मैसेज सबमिशन से पहले ही अस्वीकार कर दिया गया।

सामान्यीकृत विफलता कारण

ये message API द्वारा परिभाषित विफलता कारण हैं। प्रदाता रसीदों में सामान्यीकृत कारण की तुलना में अधिक विशिष्ट न्यूमेरिक कोड हो सकता है। उदाहरण के लिए, code: unknown वाले मैसेज में अभी भी एक पहचाना गया carrier_error_code हो सकता है।

कारणअर्थ
invalid_destinationनंबर असाइन नहीं है या अमान्य है
unreachableहैंडसेट बंद है या कवरेज से बाहर है
blocked_by_carrierप्राप्तकर्ता के कैरियर ने संदेश फ़िल्टर कर दिया
blocked_by_fraud_protectionBird फ्रॉड प्रोटेक्शन ने संदिग्ध SMS पंपिंग को ब्लॉक किया
blocked_by_recipientप्राप्तकर्ता के डिवाइस ने प्रेषक को ब्लॉक किया
landline_unreachableलैंडलाइन SMS स्वीकार नहीं करती
content_rejectedकैरियर ने कंटेंट को अस्वीकार कर दिया
sender_unregisteredप्रेषक के पास आवश्यक पंजीकरण नहीं है
recipient_opted_outप्राप्तकर्ता सप्रेशन सूची में है
provider_unavailableप्रदाता या नेटवर्क अनुपलब्ध था
insufficient_balanceवर्कस्पेस वॉलेट भेजने का खर्च वहन नहीं कर सका
unknownविफलता को वर्गीकृत नहीं किया जा सका

यह एक खुला सेट है: अपरिचित मानों को स्वीकार करें और जाँच के लिए विवरण और रॉ कोड सुरक्षित रखें। एक अस्थायी कारण भी इस संदेश प्रयास को समाप्त कर देता है; यह स्वचालित पुनः सबमिशन की गारंटी नहीं देता।

प्रोवाइडर त्रुटि कोड

carrier_error_code में लौटाई गई संख्यात्मक स्ट्रिंग देखें। ये कोड Bird के SMS भेजने वाले प्रोवाइडर के हैं; कोई अलग प्रोवाइडर समान नंबरों को अन्य अर्थ दे सकता है।

कोडअर्थ
0कोई त्रुटि नहीं
1अज्ञात सब्सक्राइबर
2अज्ञात बेस स्टेशन
3अज्ञात मोबाइल स्विच
5अपहचाना सब्सक्राइबर
7हैंडसेट कनेक्ट नहीं हो सकता
8रोमिंग प्रतिबंधित
9सब्सक्राइबर प्रमाणीकरण विफल
10SMS bearer अप्रावधानित
11SMS सेवा अप्रावधानित
12हैंडसेट ब्लैकलिस्ट किया गया
13SMS सेवा प्रतिबंधित
21SMS असमर्थित
26नेटवर्क हैंडओवर विफल
27सब्सक्राइबर अनुपलब्ध
28कवरेज क्षेत्र से बाहर
29हैंडसेट बंद है
30मोबाइल स्विच विफलता
31सब्सक्राइबर व्यस्त
32SMS डिलीवरी विफलता
33लंबित-संदेश स्टोरेज भरा हुआ
34नेटवर्क सिस्टम विफलता
35आवश्यक डेटा अनुपलब्ध
36अप्रत्याशित मैसेज-फ़ील्ड मान
39रोमिंग राउटिंग-नंबर अनुपलब्ध
40नेटवर्क मेमोरी समाप्त
71असमर्थित अल्फ़ाबेट
72USSD व्यस्त
100भेजने का बैलेंस अपर्याप्त
101सब्सक्राइबर का बैलेंस अपर्याप्त
103सब्सक्राइबर ने ऑप्ट आउट किया
104प्रेषक अपंजीकृत
105कॉन्टेंट अपंजीकृत
106अभियान वॉल्यूम सीमा पार
107अभियान थ्रूपुट सीमा पार
110ऑपरेटर ने संदेश फ़िल्टर किया
130SurgeGuard ने ट्रैफ़िक पंपिंग का पता लगाया
131SurgeGuard ने संदिग्ध पंपिंग गंतव्य को ब्लॉक किया

कोड 0 को Bird संदेश और इवेंट रीड पर carrier_error_code से हटा दिया जाता है। अपरिचित कोड को सपोर्ट से संपर्क करते समय आपके रिकॉर्ड में उपलब्ध रहना चाहिए।

धोखाधड़ी सुरक्षा ब्लॉक

SurgeGuard Bird की SMS धोखाधड़ी सुरक्षा है।

धोखाधड़ी सुरक्षा द्वारा ब्लॉक किए गए संदेशों में विफलता कारण blocked_by_fraud_protection और विवरण "Blocked by fraud protection: suspected SMS pumping." होता है। डिलीवरी स्थिति प्रदाता की रिपोर्ट के अनुसार failed, rejected, या expired रहती है। वही कारण और विवरण संदेश विवरण, टाइमलाइन इवेंट और विफलता वेबहुक में दिखाई देते हैं। कच्चा प्रदाता कोड उपलब्ध होने पर carrier_error_code में मिलता रहता है।

SMS लॉग में, इन संदेशों को खोजने के लिए Failure reason को Blocked by fraud protection से फ़िल्टर करें।

पुराने रिकॉर्ड अभी भी unknown और generic_delivery_failure दिखा सकते हैं। केवल ये लेबल धोखाधड़ी सुरक्षा ब्लॉक की पहचान नहीं करते। कारण जानने के लिए उनका carrier_error_code प्रदाता त्रुटि कोड में देखें। यदि कोड अनुपलब्ध या अपरिचित है, तो वर्कस्पेस ID, संदेश ID, टाइमस्टैम्प और प्रदाता कोड (यदि उपलब्ध हो) के साथ सपोर्ट से संपर्क करें।

किसी ब्लॉक किए गए OTP की जाँच करते समय, SMS को उस अकाउंट या सत्यापन अनुरोध से मिलाएँ जिसने इसे ट्रिगर किया। ब्लॉक को बायपास करने के लिए स्वचालित रूप से दोबारा भेजने या रूट बदलने से बचें। यदि आपको लगता है कि कोई वैध अनुरोध ब्लॉक किया गया, तो वर्कस्पेस ID, संदेश ID, टाइमस्टैम्प और प्रदाता कोड के साथ सपोर्ट से संपर्क करें।

अगले कदम

  • SMS लॉग: किसी संदेश और उसकी डिलीवरी हिस्ट्री की जाँच करें।
  • SMS इवेंट: डिलीवरी और विफलता वेबहुक प्राप्त करें।
  • SMS मेट्रिक्स: समग्र विफलता परिणामों की समीक्षा करें।
  • SMS API त्रुटियाँ: API अनुरोध द्वारा लौटाई गई त्रुटियों को समझें।

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