WhatsApp एपीआई मैसेज डिलीवर नहीं हुआ: कारण, क्रम से
स्वीकृत WhatsApp एपीआई मैसेज का मतलब डिलीवर हुआ मैसेज नहीं है: Meta नतीजा बाद में स्टेटस वेबहुक में भेजता है, यानी sent, delivered, read या failed, साथ में एक गड़बड़ी कोड। क्रम से जाँचें: failed स्टेटस और उसका कोड, 24 घंटे की विंडो (131047), पेमेंट तरीका (131042), टेम्पलेट (132001, 132015), प्राप्तकर्ता (131026, 131049, 131050), फिर नंबर की सीमाएं और कनेक्शन।
easyCoexistence हर जुड़े नंबर पर चौबीसों घंटे नज़र रखता है, जब Meta डिलीवरी रोकता है, कनेक्शन टूटता है या क्वालिटी घटती है तो आपको ईमेल भेजता है, और Meta के स्टेटस वेबहुक बिना बदले आपके सिस्टम तक पहुँचाता है।
sent (एक चेक मार्क), delivered (दो), read (दो नीले) और failed (लाल गड़बड़ी त्रिकोण), जैसा स्टेटस वेबहुक रिपोर्ट करते हैं।
आखिरी बार प्राप्तकर्ता के जवाब के बाद 24 घंटे से ज़्यादा बीत चुके हैं; Meta कहता है इसकी जगह टेम्पलेट भेजें।
डिलीवर नहीं हो सका: नंबर WhatsApp पर नहीं है, प्राप्तकर्ता ने नई शर्तें स्वीकार नहीं की हैं, या पुराना WhatsApp वर्शन चल रहा है।
WhatsApp किसी बिना डिलीवरी वाले यूटिलिटी या मार्केटिंग टेम्पलेट को छोड़ने से पहले डिफ़ॉल्ट रूप से इतने समय तक दोबारा कोशिश करता है; ऑथेंटिकेशन टेम्पलेट का डिफ़ॉल्ट 10 मिनट है।
WhatsApp Business ऐप और Cloud API, दोनों में इस्तेमाल होने वाले नंबर की तय थ्रूपुट।
स्वीकार होने के बाद भी मैसेज क्यों नहीं पहुँचता?
क्योंकि एपीआई का जवाब और डिलीवरी दो अलग घटनाएं हैं। भेजते समय Meta अनुरोध स्वीकार करते ही एक मैसेज आईडी लौटाता है; मैसेज ग्राहक के फ़ोन तक पहुँचा या नहीं, यह बाद में messages फ़ील्ड पर स्टेटस वेबहुक में आता है। sent का मतलब है कि वह Meta के सर्वर से निकल गया (एक चेक मार्क), delivered का मतलब कि डिवाइस तक पहुँचा (दो), read का मतलब कि उसे खोला गया (दो नीले), और failed का मतलब कि वह भेजा या डिलीवर नहीं हो सका, जो आपको errors array में दिखता है: code, title और error_data.details। इसलिए पहला कदम कभी अंदाजा लगाना नहीं है: उस मैसेज आईडी का failed स्टेटस ढूँढें और उसका कोड पढ़ें। अगर कोई वेबहुक डेस्टिनेशन नहीं है, तो यह कहीं दर्ज नहीं होता।
कारण क्या हैं, किस क्रम में जाँचें?
नए जुड़े नंबर पर सबसे आम से लेकर सबसे दुर्लभ तक। हर पंक्ति में Meta का कोड है, ताकि failed स्टेटस बता सके कि आप किस स्थिति में हैं:
- विंडो बंद: 131047, ग्राहक के आखिरी मैसेज को 24 घंटे से ज़्यादा हो चुके हैं। फ़्री-फ़ॉर्म मैसेज के लिए विंडो खुली होना ज़रूरी है; टेम्पलेट भेजें।
- पेमेंट: 131042, या टेम्पलेट चुपचाप छोड़े गए। 1 अक्टूबर 2026 से, बिना पेमेंट तरीके के, महीने में 1,000 इस्तेमाल होने के बाद सर्विस मैसेज भी रुक जाते हैं।
- टेम्पलेट: 132001 अनुमोदित नहीं या गलत भाषा, 132000 वेरिएबल की गलत संख्या, 132012 गलत फ़ॉर्मैट, 132015 पॉज़्ड, 132016 डिसेबल्ड।
- प्राप्तकर्ता: 131026 WhatsApp पर नहीं, पुराना वर्शन या शर्तें स्वीकार नहीं; 131050 मार्केटिंग मैसेज बंद किए; 131049 हेल्दी एंगेजमेंट के लिए रोका गया; US नंबरों पर मार्केटिंग टेम्पलेट डिलीवर नहीं होते।
- सीमाएं: 131048 स्पैम संकेतों के बाद प्रतिबंधित, 131056 एक व्यक्ति को बहुत ज़्यादा मैसेज, 130429 थ्रूपुट, Coexistence नंबर पर प्रति सेकंड 20 मैसेज।
- खाता: 131031 या 368, नीति उल्लंघन के कारण WhatsApp Business Account प्रतिबंधित या डिसेबल।
- कनेक्शन: नंबर अब जुड़ा नहीं है, उदाहरण के लिए WhatsApp Business ऐप 14 दिन तक न खुलने के बाद।
प्राप्तकर्ता-पक्ष के कोड कैसे संभालें?
अलग तरीके से, क्योंकि कुछ कोड दोबारा कोशिश के लायक हैं और कुछ कभी नहीं। 131050 का मतलब है कि व्यक्ति ने आपसे मार्केटिंग मैसेज बंद करने का फैसला किया है: Meta कहता है दोबारा कोशिश न करें, और user_preferences वेबहुक बताता है कि वे कब बंद करते या फिर शुरू करते हैं। 131049 का मतलब है कि Meta एंगेजमेंट को स्वस्थ रखने के लिए मार्केटिंग मैसेज रोक रहा है, अक्सर मार्केटिंग टेम्पलेट पर प्रति-यूज़र सीमा: Meta कम से कम 24 घंटे इंतज़ार की सलाह देता है, क्योंकि जल्दी दोबारा भेजने पर वही गड़बड़ी लौटती है। 131026 उन नंबरों पर लागू होता है जो WhatsApp पर नहीं हैं, उन यूज़र्स पर जिन्होंने WhatsApp की मौजूदा शर्तें स्वीकार नहीं कीं, और बहुत पुराने ऐप वर्शन पर; पहले नंबर का फ़ॉर्मैट और देश कोड जाँचें, फिर ग्राहक से किसी दूसरे चैनल पर पूछें।
WhatsApp कितनी देर तक डिलीवर करने की कोशिश करता है?
मैसेज के टाइम टू लिव तक। जब फ़ोन बंद हो या नेटवर्क से बाहर हो, WhatsApp तुरंत फेल करने के बजाय दोबारा कोशिश करता है: डिफ़ॉल्ट रूप से यूटिलिटी और मार्केटिंग टेम्पलेट पर 30 दिन, और ऑथेंटिकेशन टेम्पलेट पर 10 मिनट। कारोबार message_send_ttl_seconds से प्रति टेम्पलेट इसे छोटा कर सकता है: यूटिलिटी के लिए 30 सेकंड से 12 घंटे, और ऑथेंटिकेशन के लिए 30 सेकंड से 15 मिनट। जो मैसेज अपने TTL के भीतर डिलीवर नहीं होता, वह छोड़ दिया जाता है। इसलिए घंटों बाद भी sent स्टेटस हो और delivered न हो, तो मैसेज आमतौर पर ग्राहक के फ़ोन पर इंतज़ार कर रहा है, खोया नहीं; कोड और समय-संवेदी अलर्ट के लिए छोटा TTL रखें ताकि देर से डिलीवरी किसी को उलझन में न डाले।
AI जवाबों और ऑटोमेशन पर इसका क्या असर है?
पहले रन पढ़ें, फिर स्टेटस। Runs टैब में Skipped रन ने कुछ नहीं भेजा और कारण बताता है: "More than 24 hours since the customer's last message", "You answered this chat from your phone recently" या "AI reply limit for this chat reached this hour"। Done रन का मतलब है कि Meta ने हर जवाब स्वीकार किया, जो डिलीवरी का प्रमाण नहीं है। easyCoexistence मैसेज स्टेटस संग्रहीत नहीं करता: ऑटोमेशन चालू होने पर, अगर आपने फ़ॉरवर्ड URL सेट किया है तो वे वहाँ पहुँचते हैं, और डायरेक्ट मोड में सीधे आपके अपने एंडपॉइंट पर जाते हैं। ChatGPT या Claude से, अपने AI से get_number_health चलाने को कहें: यह लाइव स्टेटस, क्वालिटी रेटिंग और आखिरी 15 मॉनिटरिंग इवेंट लौटाता है, जिसमें sending ब्लॉक और Meta का कोड शामिल है।
कैसे कॉन्फ़िगर करें
- Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.
आम गड़बड़ियाँ
- 131050 पर दोबारा कोशिश। व्यक्ति ने आपसे मार्केटिंग मैसेज रोकने का फैसला किया है; आगे की कोशिशें कभी डिलीवर नहीं होतीं और केवल नकारात्मक संकेत बढ़ा सकती हैं।
- मैसेज आईडी को डिलीवर हुआ मानना। Meta पहले स्वीकार करता है और विफलताएं बाद में बताता है, इसलिए जो वर्कफ़्लो आईडी पर रुकता है वह हर अस्वीकृत मैसेज को छोड़ देता है।
- एक दिन बाद फ़्री-फ़ॉर्म जवाब भेजना। ग्राहक के मैसेज के बिना 24 घंटे बाद केवल टेम्पलेट स्वीकार होता है।
- वेबहुक डेस्टिनेशन के बिना चलाना। विफल स्टेटस केवल वेबहुक के रूप में आते हैं, इसलिए उसके बिना यह जानकारी खो जाती है कि मैसेज क्यों नहीं पहुँचा।
आपका AI ChatGPT या Claude से get_number_health के साथ किसी नंबर की जाँच कर सकता है। प्रति नंबर प्रति माह US$ 9 से US$ 0.75 तक, नंबर जोड़ने के साथ घटती हुई दर पर, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
एक चेक मार्क कई घंटों तक क्यों दिखता रहा?
एक चेक मार्क sent स्टेटस है: Meta ने भेज दिया, पर फ़ोन को वह नहीं मिला, आमतौर पर इसलिए कि फ़ोन बंद या ऑफ़लाइन है। WhatsApp टेम्पलेट का टाइम टू लिव खत्म होने तक दोबारा कोशिश करता रहता है, यूटिलिटी और मार्केटिंग के लिए डिफ़ॉल्ट 30 दिन।
टेम्पलेट नहीं पहुँचते, पर जवाब पहुँचते हैं, ऐसा क्यों?
आमतौर पर WhatsApp Business Account पर पेमेंट तरीके की समस्या होती है। Meta बिना उसके भी नंबर के मासिक फ़्री टियर के भीतर सर्विस मैसेज डिलीवर करता है, पर टेम्पलेट नहीं। Billing & payments में कार्ड जोड़ें।
क्या मैं WhatsApp Business ऐप में विफल मैसेज देख सकता हूँ?
भरोसेमंद रूप से नहीं। Coexistence नंबर पर एपीआई से भेजे गए मैसेज ऐप की चैट थ्रेड में दिखते हैं, पर मैसेज क्यों विफल हुआ, यह केवल स्टेटस वेबहुक के गड़बड़ी कोड में आता है।
क्या Meta उन मैसेज का शुल्क लेता है जो डिलीवर नहीं हुए?
नहीं। Meta केवल डिलीवर हुए मैसेज का शुल्क लेता है, और पॉज़्ड टेम्पलेट के प्रयासों का भी शुल्क नहीं लिया जाता।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित