लॉग इनमुफ़्त ट्रायल शुरू करें
Meta Tech Provider

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 स्टेटस आपके सर्वर तक पहुँचाता है, सीधे या ऑटोमेशन चालू होने पर साइन किए गए फ़ॉरवर्ड के रूप में।

131047

रिसीवर के आखिरी जवाब के बाद 24 घंटे से ज़्यादा बीत चुके हैं; Meta का समाधान है टेम्पलेट भेजना।

131049

इकोसिस्टम एंगेजमेंट स्वस्थ रखने के लिए डिलीवर नहीं किया गया; मार्केटिंग टेम्पलेट दोबारा भेजने से पहले कम से कम 24 घंटे रुकें।

131050

रिसीवर ने कारोबार से मार्केटिंग मैसेज रोकना चुना है; Meta कहता है दोबारा कोशिश न करें।

No contacts

failed स्टेटस में contacts एरे नहीं होता, इसलिए statuses.id से विफलता का मिलान करें।

Delivered

Meta किस चीज़ का शुल्क लेता है: मैसेज का शुल्क तब लगता है जब वह डिलीवर होता है, भेजे जाने पर नहीं।

failed स्टेटस कैसा दिखता है?

किसी भी स्टेटस की तरह, पर साथ में errors भी। contacts एरे नहीं होता, recipient_user_id छूट जाता है जब मैसेज फ़ोन नंबर पर भेजा गया हो, और कोई pricing ऑब्जेक्ट नहीं होता। title और message एक ही पाठ रखते हैं, error_data.details एक वाक्य में कारण समझाता है, और href Meta की code सूची की ओर इशारा करता है। यह Meta का अपना उदाहरण है, एक मार्केटिंग टेम्पलेट जो प्रति-यूज़र सीमा से रुका:

Meta's example: a message that failed with 131049
{
  "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 संदर्भ में है:

131026Undeliverable: not a WhatsApp number, terms not accepted, or an outdated WhatsApp version on the recipient's phone.
131047More than 24 hours since the customer last wrote. Send an approved template instead.
131049Held back to keep engagement healthy, usually the per-user marketing limit. Wait 24 hours or more.
131050The customer stopped marketing messages from you. Do not retry.
131042A problem with the payment method on the WhatsApp Business Account.
130472Not sent because the recipient is part of Meta's marketing message experiment.
131053Media could not be uploaded, often an unsupported file type.
131000Unknown error. Try again; if it persists, open a Direct Support ticket.

हैंडलर हर तरह की विफलता पर कैसे प्रतिक्रिया दे?

कोई भी रीट्राई होने से पहले code को तय करें कि आगे क्या करना है। अंधाधुंध रीट्राई मार्केटिंग ऑप्ट-आउट को बार-बार की विफलता में बदल देता है और ब्लॉक बढ़ा सकता है, जबकि अस्थायी गड़बड़ी को छोड़ देने से वह मैसेज खो जाता है जो एक मिनट बाद पहुँच जाता।

  • बैकऑफ़ के साथ रीट्राई: 131000 अज्ञात, 131016 सर्विस उपलब्ध नहीं, 130429 थ्रूपुट सीमा पूरी।
  • पहले रुकें: 131049, कम से कम 24 घंटे, क्योंकि जल्दी रीट्राई उस यूज़र को 24 घंटे और तक ब्लॉक कर सकता है।
  • मैसेज बदलें: 131047 के लिए स्वीकृत टेम्पलेट चाहिए, क्योंकि 24 घंटे की विंडो बंद है।
  • इस ग्राहक के लिए रोकें: 131050, जब तक user_preferences resume इवेंट न आए।
  • खाता या कंटेंट ठीक करें: 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 ने मैसेज स्वीकार किया।
EasyCoexistence के साथ ऐसा करना

जब ऑटोमेशन का जवाब भेजने के समय इनकार होता है, तो रन में 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 वेबहुक स्टेटस: भेजा गया, डिलीवर हुआ, पढ़ा गया और विफलWhatsApp बताता है कि आपके भेजे मैसेज के साथ क्या हुआ: statuses array, हर स्टेटस मान, हर फ़ील्ड, और wamid से मिलान।WhatsApp user_preferences वेबहुक: कब ग्राहक मार्केटिंग मैसेज रोकते या फिर से शुरू करते हैंग्राहक मार्केटिंग मैसेज रोके या फिर शुरू करे, तो user_preferences वेबहुक चलता है। पेलोड, क्या करें, और 131050 फ़ॉलबैक।WhatsApp एपीआई मैसेज डिलीवर नहीं हुआ: कारण, क्रम सेWhatsApp एपीआई मैसेज जो नहीं पहुँचता: स्टेटस वेबहुक, 24 घंटे की विंडो, पेमेंट, टेम्पलेट, प्राप्तकर्ता और सीमाएं, उसी क्रम में जाँचें।WhatsApp टेम्पलेट रोका गया या बंद: क्या करेंकम गुणवत्ता वाला WhatsApp टेम्पलेट 3 घंटे, फिर 6 घंटे रोका जाता है, फिर बंद। कैसे पहचानें, क्या बदलें, पेसिंग से रुका टेम्पलेट कैसे चालू करें।WhatsApp गड़बड़ी 131049: इकोसिस्टम की सेहत के लिए मैसेज रोका गयागड़बड़ी 131049 का मतलब है कि Meta ने इकोसिस्टम की सेहत के लिए मैसेज रोका, 24 घंटे की विंडो बंद होने के कारण नहीं।24 घंटे की ग्राहक सेवा विंडोजानें ग्राहक सेवा विंडो कब खुलती और बंद होती है, इसमें क्या भेज सकते हैं और अंदर के जवाब मुफ़्त क्यों हैं।

शुरू करने के लिए तैयार हैं?

WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।

मुफ़्त ट्रायल शुरू करें

इस तारीख को सत्यापित