WhatsApp API error code: वजह और इलाज की चीट-शीट (131047, 131049, 131026 और ज़्यादा)

जब कोई WhatsApp मैसेज फ़ेल होता है, तो Cloud API एक नंबर वाला code और छोटा title देता है, या तो तुरंत API के जवाब में या बाद में status webhook में status: failed के साथ। यह चीट-शीट उन WhatsApp API error code को समूह में बाँटती है जो बिज़नेस को सबसे ज़्यादा मिलते हैं, हर एक का मतलब, व्यवहार में सबसे सामान्य वजह और क्या करना है। मतलब Meta के Cloud API error code पेज पर आधारित हैं, 12 अक्टूबर 2026 को जाँचे गए। Meta समय-समय पर title के शब्द बदलता है, इसलिए पक्का रेफ़रेंस code नंबर को मानें, टेक्स्ट को नहीं, और कुछ मेल न खाए तो Meta का पेज देख लें।

फ़ेल हुए मैसेज को कैसे पढ़ें

फ़ेल status वाला webhook ऐसा दिखता है। आँकड़े सिर्फ़ उदाहरण के लिए हैं:

{
  "statuses": [
    {
      "id": "wamid.HBgMOTE5ODc2NTQzMjEw...",
      "status": "failed",
      "timestamp": "1760247000",
      "recipient_id": "919876543210",
      "errors": [
        {
          "code": 131049,
          "title": "This message was not delivered to maintain healthy ecosystem engagement.",
          "error_data": { "details": "..." }
        }
      ]
    }
  ]
}

तीन चीज़ें देखें: code, प्राप्तकर्ता और जो template या मैसेज आपने भेजा। किसी एक ग्राहक को एक बार फ़ेल होना सामान्य है। किसी एक कैंपेन में सैकड़ों प्राप्तकर्ताओं पर एक ही code बार-बार आना आपके template, अकाउंट या किसी लिमिट की तरफ़ इशारा करता है।

24 घंटे की विंडो और प्राप्तकर्ता से जुड़ी ग़लतियाँ

24 घंटे का नियम बाकी सबसे ज़्यादा फ़ेलियर की वजह बनता है। 24 घंटे की customer service विंडो पर हमारी पोस्ट बताती है कि यह कब खुलती है और Click-to-WhatsApp ad इसे कैसे बदलते हैं।

लिमिट और throttling

131049 वह code है जिसके बारे में भारतीय marketer सबसे ज़्यादा पूछते हैं। हम इसे विस्तार से per-user मार्केटिंग लिमिट और error 131049 में समझाते हैं। भारतीय बिज़नेस को सबसे ज़्यादा मिलने वाले दूसरे code के विस्तृत इलाज: 131047, 24 घंटे की विंडो के बाहर, 131026, मैसेज deliver नहीं हुआ, 131056, pair rate limit, 131064, template classification violation और 130472, experiment के हिस्से के रूप में मैसेज नहीं भेजा गया। और सिंगल-code गाइड: 131000, 131042, 131051, 132001, 133010, 368।

Template से जुड़ी ग़लतियाँ

अगर template भेजते समय नहीं, बल्कि रिव्यू में ही रिजेक्ट हो रहे हैं, तो पढ़ें WhatsApp template क्यों रिजेक्ट होते हैं।

अकाउंट, पेमेंट और policy से जुड़ी ग़लतियाँ

रजिस्ट्रेशन और फ़ोन नंबर से जुड़ी ग़लतियाँ

Media, request और server से जुड़ी ग़लतियाँ

एक सीधा retry नियम

1. Back-off के साथ अपने आप दोबारा भेजें: 130429, 131056, 80007, 131016, 131057, 131000।
2. सिर्फ़ ठीक करने के बाद दोबारा भेजें: 131047 (template पर शिफ़्ट करें), 132000, 132001, 132012 (template कॉल ठीक करें), 131042 (पेमेंट ठीक करें), 190 (नया token)।
3. कम से कम 24 घंटे बाद दोबारा भेजें: 131049।
4. कभी दोबारा न भेजें: 131050, 131026 (जब तक ग्राहक मैसेज न करे), 132016, 368।

Broadchat में error code ढूँढना

Broadchat हर मैसेज के लिए Meta के status webhook रेकॉर्ड करता है। Inbox में किसी फ़ेल मैसेज की info खोलें और देखें कि वह कब फ़ेल हुआ और Meta का error code व वजह क्या है। कैंपेन रिपोर्ट sent, delivered, read, replied और failed को हर प्राप्तकर्ता के हिसाब से दिखाती है, और आप उन्हें CSV के रूप में एक्सपोर्ट कर सकते हैं या किसी समूह को retarget कर सकते हैं, जैसे 131049 वाले इंतज़ार के बाद फ़ेल हुए प्राप्तकर्ता। जिन incoming मैसेज को WhatsApp API से नहीं दिखा सकता, वे खाली bubble की जगह साफ़ नोटिस के साथ दिखते हैं। कैंपेन भेजना आपके नंबर की messaging limit और throughput के हिसाब से pace होता है और pair-rate-limit वाली ग़लतियों को दोबारा भेजता है, जिससे ज़्यादातर 130429 और 131056 फ़ेलियर टल जाते हैं। भेजना शुरू करने के लिए देखें कैंपेन कैसे भेजें, और बड़ी तस्वीर के लिए WhatsApp Business API की आसान गाइड।

सभी सिंगल-code गाइड

हर code के लिए स्टेप-बाय-स्टेप इलाज: 4, 368, 80007, 130429, 130472, 131000, 131008, 131009, 131016, 131021, 131026, 131031, 131042, 131047, 131048, 131049, 131051, 131052, 131053, 131056, 131057, 131060, 131063, 131064, 131065, 132000, 132001, 132005, 132007, 132012, 132015, 132016, 132068, 133010, 135000।