WhatsApp मैसेज क्यों फ़ेल हुआ: failed स्टेटस और उसकी गड़बड़ी पढ़ना
failed स्टेटस वाला वेबहुक मतलब है कि Meta वह मैसेज भेज या पहुँचा नहीं सका जो कारोबार ने एपीआई से भेजा था। यह messages फ़ील्ड पर status failed और errors एरे के साथ आता है, जिसमें code, title, message, error_data.details और href होते हैं। code कारण बताता है: 131047 विंडो बंद, 131026 नहीं पहुँच सकता, 131049 मार्केटिंग सीमा, 131050 मार्केटिंग बंद, 131042 पेमेंट समस्या।
easyCoexistence आपके WhatsApp Business ऐप नंबर को Coexistence के ज़रिए Meta के Cloud API से जोड़ता है और failed स्टेटस आपके सर्वर तक पहुँचाता है, सीधे या ऑटोमेशन चालू होने पर साइन किए गए फ़ॉरवर्ड के रूप में।
रिसीवर के आखिरी जवाब के बाद 24 घंटे से ज़्यादा बीत चुके हैं; Meta का समाधान है टेम्पलेट भेजना।
इकोसिस्टम एंगेजमेंट स्वस्थ रखने के लिए डिलीवर नहीं किया गया; मार्केटिंग टेम्पलेट दोबारा भेजने से पहले कम से कम 24 घंटे रुकें।
रिसीवर ने कारोबार से मार्केटिंग मैसेज रोकना चुना है; Meta कहता है दोबारा कोशिश न करें।
failed स्टेटस में contacts एरे नहीं होता, इसलिए statuses.id से विफलता का मिलान करें।
Meta किस चीज़ का शुल्क लेता है: मैसेज का शुल्क तब लगता है जब वह डिलीवर होता है, भेजे जाने पर नहीं।
failed स्टेटस कैसा दिखता है?
किसी भी स्टेटस की तरह, पर साथ में errors भी। contacts एरे नहीं होता, recipient_user_id छूट जाता है जब मैसेज फ़ोन नंबर पर भेजा गया हो, और कोई pricing ऑब्जेक्ट नहीं होता। title और message एक ही पाठ रखते हैं, error_data.details एक वाक्य में कारण समझाता है, और href Meta की code सूची की ओर इशारा करता है। यह Meta का अपना उदाहरण है, एक मार्केटिंग टेम्पलेट जो प्रति-यूज़र सीमा से रुका:
{
"object": "whatsapp_business_account",
"entry": [
{
"id": "102290129340398",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "15550783881",
"phone_number_id": "106540352242922"
},
"statuses": [
{
"id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0QUQ2MjA4NEYyRkExNjMyREUA",
"status": "failed",
"timestamp": "1751142888",
"recipient_id": "16505551234",
"errors": [
{
"code": 131049,
"title": "This message was not delivered to maintain healthy ecosystem engagement.",
"message": "This message was not delivered to maintain healthy ecosystem engagement.",
"error_data": {
"details": "In order to maintain a healthy ecosystem engagement, the message failed to be delivered."
},
"href": "/documentation/business-messaging/whatsapp/support/error-codes"
}
]
}
]
},
"field": "messages"
}
]
}
]
}कौन से codes सबसे ज़्यादा आते हैं, और उनका मतलब क्या है?
Meta codes भेजने के जवाब में, failed स्टेटस में, या दोनों में लौटाता है, इसलिए वही code किसी भी तरह पहुँच सकता है, और आपके हैंडलर को दोनों जगह पढ़ना चाहिए। ये वे codes हैं जो ज़्यादातर ऐसे मैसेज समझाते हैं जो कभी नहीं पहुँचते, Meta के अपने कारण और पहले क्या आज़माना है, इसके साथ; पूरी सूची Meta के codes संदर्भ में है:
हैंडलर हर तरह की विफलता पर कैसे प्रतिक्रिया दे?
कोई भी रीट्राई होने से पहले code को तय करें कि आगे क्या करना है। अंधाधुंध रीट्राई मार्केटिंग ऑप्ट-आउट को बार-बार की विफलता में बदल देता है और ब्लॉक बढ़ा सकता है, जबकि अस्थायी गड़बड़ी को छोड़ देने से वह मैसेज खो जाता है जो एक मिनट बाद पहुँच जाता।
- बैकऑफ़ के साथ रीट्राई: 131000 अज्ञात, 131016 सर्विस उपलब्ध नहीं, 130429 थ्रूपुट सीमा पूरी।
- पहले रुकें: 131049, कम से कम 24 घंटे, क्योंकि जल्दी रीट्राई उस यूज़र को 24 घंटे और तक ब्लॉक कर सकता है।
- मैसेज बदलें: 131047 के लिए स्वीकृत टेम्पलेट चाहिए, क्योंकि 24 घंटे की विंडो बंद है।
- इस ग्राहक के लिए रोकें: 131050, जब तक
user_preferencesresume इवेंट न आए। - खाता या कंटेंट ठीक करें: 131042 पेमेंट, 131031 खाता प्रतिबंधित, 131053 मीडिया।
कौन सी विफलताएँ केवल failed स्टेटस के रूप में दिखती हैं?
वे जिन्हें Meta अनुरोध स्वीकार करने के बाद तय करता है। भेजने पर wamid लौटता है, और इनकार बाद में इसी वेबहुक पर आता है। Meta +1 और US एरिया कोड वाले WhatsApp यूज़र्स को मार्केटिंग टेम्पलेट डिलीवर नहीं करता; जो ग्राहक मार्केटिंग मैसेज रोक चुका है, उसे भेजा गया मार्केटिंग टेम्पलेट प्रोसेस होकर 131050 के साथ failed बताया जाता है, और प्रति-यूज़र मार्केटिंग सीमा भी इसी तरह 131049 बताती है।
अगर नंबर पर कोई वेबहुक डेस्टिनेशन नहीं है, तो ये विफलताएँ कहीं दिखती नहीं और मैसेज बस भेजा हुआ दिखता है। जब कोई ग्राहक कुछ न पाए, तब जाँच का पूरा क्रम देखने के लिए WhatsApp API messages not delivered वाला पेज देखें।
Coexistence नंबर पर क्या बदलता है?
दो बातें मायने रखती हैं। पहली, 24 घंटे की विंडो केवल एपीआई पर लागू होती है। Meta की Coexistence गाइड कहती है कि WhatsApp Business ऐप से भेजे गए मैसेज ग्राहक सेवा विंडो के अधीन नहीं हैं, इसलिए 131047 के बाद मालिक फ़ोन से उस ग्राहक को अब भी जवाब दे सकता है, जबकि आपका सिस्टम स्वीकृत टेम्पलेट भेजता है।
दूसरी, थ्रूपुट तय है। एक ही समय में ऐप और एपीआई में इस्तेमाल होने वाला नंबर अधिकतम 20 मैसेज प्रति सेकंड भेजता है, और इससे आगे जाने पर 130429 लौटता है। बाकी सब किसी भी Cloud API नंबर जैसा ही है: वही फ़ील्ड, वही errors एरे, वही codes।
ऑटोमेशन और आपका AI विफलता को कैसे देखते हैं?
यह इस पर निर्भर है कि Meta कब मना करता है। भेजने के समय इनकार, जैसे 131047, ऑटोमेशन के स्टेप को विफल करता है: रन के Runs टैब में Failed दिखता है, Meta का कारण साथ होता है, और मालिक को ईमेल मिलता है ताकि वह उस ग्राहक को खुद जवाब दे सके। ऑटोमेशन फ़्री-फ़ॉर्म जवाब भेजने से पहले विंडो भी जाँचते हैं, और कोशिश करने के बजाय window_closed के साथ छोड़ देते हैं।
Meta बाद में जो विफलता बताता है, वह आपके Forward URL या सीधे वेबहुक डेस्टिनेशन पर failed स्टेटस के रूप में आती है, और रन जैसा था वैसा ही रहता है। MCP कनेक्टर से टेम्पलेट भेजने वाला AI wamid और "sent: true" देखता है; उस wamid का स्टेटस अपने सिस्टम से माँगें, या जब बहुत से मैसेज एक साथ विफल हों तब असिस्टेंट से get_number_health चलवाएँ।
आम गड़बड़ियाँ
- 131050 को लूप में दोबारा कोशिश करना। ग्राहक ने मार्केटिंग मैसेज रोके हैं, इसलिए हर प्रयास उसी तरह विफल होगा जब तक वह दोबारा शुरू न करे।
- 131049 वाला मार्केटिंग टेम्पलेट कुछ घंटों में दोबारा भेजना। Meta कम से कम 24 घंटे माँगता है, और जल्दी के रीट्राई उस यूज़र को 24 घंटे और तक ब्लॉक कर सकते हैं।
- सिर्फ title लॉग करना। error_data.details ठोस कारण रखता है, इसलिए code और details को wamid के साथ एक साथ सहेजें।
- बिना वेबहुक डेस्टिनेशन के चलाना और डिलीवरी का फ़ैसला भेजने के जवाब से करना, जो केवल बताता है कि Meta ने मैसेज स्वीकार किया।
जब ऑटोमेशन का जवाब भेजने के समय इनकार होता है, तो रन में Meta का कारण दिखता है और आपको ईमेल मिलता है, और हर नंबर डिस्कनेक्शन व क्वालिटी गिरावट के लिए 24/7 मॉनिटर होता है। US$ 9 से US$ 0.75 प्रति नंबर प्रति माह, नंबर बढ़ने के साथ घटता हुआ, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या Meta किसी विफल मैसेज का शुल्क लेता है?
Meta के प्राइसिंग पेज कहते हैं कि वह उन मैसेज का शुल्क लेता है जो डिलीवर होते हैं, केवल भेजे गए मैसेज का नहीं। failed स्टेटस में कोई pricing ऑब्जेक्ट नहीं होता। शुल्क कारोबार के अपने WhatsApp Business Account पर जाते हैं; easyCoexistence इन पर कभी मार्कअप नहीं लगाता।
क्या 131026 का मतलब है कि ग्राहक ने कारोबार को ब्लॉक किया?
Meta की 131026 सूची दूसरे कारण भी बताती है: नंबर WhatsApp पर नहीं है, रिसीवर ने नवीनतम शर्तें स्वीकार नहीं की हैं, या उनका WhatsApp वर्ज़न बहुत पुराना है। Meta सुझाता है कि ग्राहक से किसी दूसरे चैनल पर ये जाँचने को कहें।
कुछ विफलताओं में recipient_user_id क्यों दिखता है और कुछ में नहीं?
Meta इसे failed स्टेटस में तब छोड़ता है जब मैसेज फ़ोन नंबर पर भेजा गया हो। जब आपने ग्राहक के BSUID पर भेजा, तो विफलता में यह शामिल होता है, और recipient_id छूट सकता है।
क्या डिलीवर होने के बाद भी मैसेज विफल हो सकता है?
Meta का संदर्भ failed को भेजने या डिलीवर करने की विफलता बताता है। जब मैसेज डिवाइस तक पहुँच गया, तो अगले स्टेटस read होते हैं, या वॉइस मैसेज के लिए played।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित