WhatsApp Business API·Popular

WhatsApp कैंपेन की आम एरर्स की ट्रबलशूटिंग

SparkTG में WhatsApp कैंपेन की बार-बार आने वाली विफलताएँ ठीक करें — डिलीवरी एरर, टेम्पलेट की समस्याएँ, अकाउंट पाबंदियाँ, मीडिया अपलोड फ़ेल होना और Meta की मैसेजिंग सीमाएँ।

8 मिनट readLast updated 19 May, 2026By SparkTG Support Team

SparkTG के ज़रिए WhatsApp कैंपेन भेजते समय कभी-कभी ऐसी एरर आ सकती हैं जो मैसेज डिलीवर होने से रोकती हैं। इनमें से ज़्यादातर Meta (WhatsApp) की अपनी नीतियों, टेम्पलेट कॉन्फ़िगरेशन की समस्याओं या अकाउंट-स्तर की पाबंदियों की वजह से होती हैं। यह गाइड हर एरर प्रकार, उसका मतलब और उसे ठीक करने का सटीक तरीका बताती है।

SparkTG कैंपेन WhatsApp Business API (WABA) का उपयोग करते हैं। सभी टेम्पलेट अप्रूवल, मैसेजिंग सीमाएँ और अकाउंट पाबंदियाँ Meta द्वारा लागू की जाती हैं — SparkTG ये एरर कोड सीधे आप तक पहुँचाता है ताकि आप बिना देरी कार्रवाई कर सकें।

1. मैसेज डिलीवर नहीं हुआ — अनडिलीवरेबल नंबर

अगर कोई कैंपेन मैसेज फ़ेल हो जाता है और लॉग में किसी खास कॉन्टैक्ट के सामने डिलीवरी फ़ेल्योर दिखता है, तो संभव है कि प्राप्तकर्ता के नंबर में इनमें से कोई समस्या हो:

नंबर WhatsApp पर रजिस्टर्ड नहीं है या उस नंबर से जुड़ा अकाउंट डिएक्टिवेट हो चुका है।
आपकी कॉन्टैक्ट लिस्ट में कंट्री कोड (भारत के लिए +91 आदि) नहीं है या गलत है।
प्राप्तकर्ता WhatsApp का पुराना वर्शन इस्तेमाल कर रहा है जो Business API मैसेज रिसीव नहीं कर सकता।
प्राप्तकर्ता ने WhatsApp की नवीनतम Terms of Service स्वीकार नहीं की हैं — मैसेज डिलीवर होने से पहले उन्हें WhatsApp खोलकर अपडेटेड शर्तें स्वीकार करनी होंगी।

1
कॉन्टैक्ट का फ़ॉर्मेट जाँचें
SparkTG → Contacts में प्रभावित कॉन्टैक्ट खोलें और पक्का करें कि नंबर में पूरा कंट्री कोड है और कोई स्पेस या विशेष वर्ण नहीं है। उदाहरण: 919876543210 (09876543210 नहीं)।
2
कैंपेन से अमान्य नंबर हटाएँ
कैंपेन भेजने से पहले Validate Numbers विकल्प इस्तेमाल करें। SparkTG उन नंबरों को फ़्लैग कर देगा जो WhatsApp पर रजिस्टर्ड नहीं हैं, ताकि आप भेजने से पहले उन्हें बाहर कर सकें।
3
प्राप्तकर्ता से WhatsApp अपडेट करने को कहें
अगर कॉन्टैक्ट किसी और चैनल पर उपलब्ध है, तो उनसे WhatsApp ऐप अपडेट करने और नवीनतम Terms of Service स्वीकार करने को कहें, फिर मैसेज दोबारा भेजें।

2. Meta की क्वालिटी पाबंदियों के कारण मार्केटिंग मैसेज ब्लॉक

Meta, Business API से भेजे जाने वाले मार्केटिंग मैसेज की क्वालिटी पर सक्रिय रूप से नज़र रखता है। अगर आपके टेम्पलेट की क्वालिटी रेटिंग कम है — आमतौर पर इसलिए कि प्राप्तकर्ता आपके मैसेज ब्लॉक या रिपोर्ट कर रहे हैं — तो Meta आगे की डिलीवरी अस्थायी रूप से रोक देगा और कूलिंग-ऑफ अवधि के बाद दोबारा कोशिश करने को कहेगा।

अगर यह एरर बार-बार आती है, तो आपके टेम्पलेट कंटेंट या टार्गेटिंग की समीक्षा करनी पड़ सकती है। जिन कॉन्टैक्ट्स ने ऑप्ट-इन नहीं किया है उन्हें मार्केटिंग मैसेज भेजना कम क्वालिटी रेटिंग का सबसे आम कारण है।

अपने टेम्पलेट कंटेंट की समीक्षा करें — पक्का करें कि वह प्राप्तकर्ता के लिए प्रासंगिक, पर्सनलाइज़्ड और अपेक्षित हो।
अपनी कॉन्टैक्ट लिस्ट का ऑडिट करें — उन कॉन्टैक्ट्स को हटाएँ जिन्होंने आपके बिज़नेस से WhatsApp मैसेज पाने के लिए स्पष्ट रूप से ऑप्ट-इन नहीं किया है।
कैंपेन दोबारा चलाने से पहले कूलडाउन अवधि (आमतौर पर 24–48 घंटे) बीतने दें।
Meta Business Manager → WhatsApp Manager → Message Templates में अपने टेम्पलेट की क्वालिटी रेटिंग जाँचें।

3. कॉन्टैक्ट तक पहुँच नहीं — Meta एक्सपेरिमेंट पाबंदी

2023 के मध्य से Meta एक सतत एक्सपेरिमेंट चला रहा है, जिसमें WhatsApp के कुछ प्रतिशत यूज़र को तब तक बिज़नेस के मार्केटिंग टेम्पलेट मैसेज नहीं मिलते जब तक यूज़र ने खुद पहले बातचीत शुरू न की हो। यह SparkTG कैंपेन लॉग में खास कॉन्टैक्ट्स पर डिलीवरी फ़ेल्योर के रूप में दिखता है।

सिर्फ़ मार्केटिंग कैटेगरी के टेम्पलेट प्रभावित होते हैं। Utility और authentication टेम्पलेट पर कोई असर नहीं पड़ता।
अगर कोई कॉन्टैक्ट इस एक्सपेरिमेंट के दायरे में आता है, तो उसे मार्केटिंग मैसेज भेजने का एकमात्र तरीका यह है कि पहले उसकी ओर से कोई इनबाउंड मैसेज मिले।
जैसे ही वे आपको मैसेज भेजते हैं, आपके पास 24 घंटे की विंडो होती है जिसमें आप मार्केटिंग सहित कोई भी टेम्पलेट मैसेज भेज सकते हैं।
प्रभावित कॉन्टैक्ट्स से किसी और चैनल (ईमेल, SMS, फ़ोन कॉल) पर संपर्क करें और उनसे सेशन शुरू करने के लिए आपको WhatsApp मैसेज भेजने को कहें।

4. कैंपेन रुका — मैसेजिंग सीमा पूरी हो गई

WhatsApp सभी Business API अकाउंट पर टियर वाली दैनिक मैसेजिंग सीमाएँ लागू करता है: 24 घंटे में 1,000 → 10,000 → 100,000 यूनिक कॉन्टैक्ट्स। अगर आपका कैंपेन आपके मौजूदा टियर की सीमा पार कर लेता है, तो 24 घंटे की विंडो रीसेट होने तक मैसेज भेजना बंद रहेगा।

1
अपना मौजूदा मैसेजिंग टियर जाँचें
SparkTG Dashboard → WhatsApp → Channel Status। यहाँ आपकी मौजूदा सीमा और रोलिंग 24-घंटे की विंडो का उपयोग दिखाया जाता है।
2
विंडो रीसेट होने का इंतज़ार करें
24 घंटे की विंडो रोलिंग होती है, आधी रात को रीसेट नहीं होती। विंडो खुलते ही, अगर auto-retry चालू है तो रुका हुआ कैंपेन अपने आप दोबारा शुरू हो जाएगा।
3
समय के साथ अपना मैसेजिंग टियर बढ़ाएँ
Meta लगातार ज़्यादा वॉल्यूम में भेजने और अच्छी क्वालिटी रेटिंग के आधार पर आपका टियर अपने आप अपग्रेड करता है। मैन्युअल अपग्रेड अनुरोध का कोई विकल्प नहीं है — जल्दी टियर बढ़ाने के लिए डिलीवरी दर ऊँची और ब्लॉक दर कम रखें।

5. Meta द्वारा अकाउंट लॉक या प्रतिबंधित

अगर आपके WhatsApp Business Account (WABA) को नीति उल्लंघन के लिए फ़्लैग किया गया है, तो Meta उसे प्रतिबंधित या पूरी तरह बंद कर सकता है। ऐसा होने पर SparkTG सभी कैंपेन में अकाउंट-स्तर की एरर दिखाएगा।

1
Meta Business Manager में अकाउंट स्टेटस जाँचें
business.facebook.com → Settings → WhatsApp Accounts में लॉग-इन करें। अगर अकाउंट प्रतिबंधित है, तो आपको कारण और अपील के विकल्प वाला बैनर दिखेगा।
2
Meta को अपील सबमिट करें
Meta Business Manager में Request Review पर क्लिक करें। समीक्षा में आमतौर पर 24–48 घंटे लगते हैं। निर्णय होते ही आपको ईमेल नोटिफ़िकेशन मिलेगा।
3
पाबंदी हटने के बाद भी एरर रहे तो SparkTG सपोर्ट से संपर्क करें
Meta के पाबंदी हटाने के बाद बदलाव SparkTG प्लेटफ़ॉर्म तक पहुँचने में 2 घंटे तक लग सकते हैं। उसके बाद भी एरर जारी रहे, तो अपनी WABA ID के साथ सपोर्ट टिकट बनाएँ।

6. टेम्पलेट एरर — फ़ॉर्मेटिंग, वेरिएबल और अप्रूवल की समस्याएँ

टेम्पलेट एरर WhatsApp कैंपेन की विफलताओं की सबसे आम श्रेणी हैं। ये आमतौर पर वेरिएबल की कमी, गलत फ़ॉर्मेटिंग, या Meta द्वारा पॉज़ या रिजेक्ट किए गए टेम्पलेट की वजह से होती हैं।

खाली या गायब वेरिएबल: आपके टेम्पलेट के हर {{variable}} प्लेसहोल्डर को भेजते समय कोई वैल्यू देनी होगी। अगर कोई भी वेरिएबल खाली है, तो मैसेज फ़ेल हो जाएगा। अपना कॉन्टैक्ट डेटा जाँचें कि सभी ज़रूरी फ़ील्ड भरे हैं।
मीडिया गायब या अमान्य: अगर आपके टेम्पलेट में इमेज, वीडियो या डॉक्यूमेंट हेडर है, तो हर सेंड के लिए एक वैध मीडिया फ़ाइल देनी होगी। डॉक्यूमेंट हेडर के लिए सिर्फ़ PDF फ़ॉर्मेट सपोर्टेड है।
वेरिएबल में न्यूलाइन या टैब: किसी भी टेम्पलेट वेरिएबल वैल्यू में लाइन ब्रेक, टैब कैरेक्टर या लगातार चार से ज़्यादा स्पेस न रखें — Meta मैसेज रिजेक्ट कर देगा।
Meta द्वारा टेम्पलेट पॉज़: Meta कम क्वालिटी रेटिंग वाले टेम्पलेट को अपने आप पॉज़ कर देता है। WhatsApp Manager → Message Templates में जाकर स्टेटस जाँचें। अगर मूल टेम्पलेट स्थायी रूप से डिसेबल हो गया है, तो आप कंटेंट को नए टेम्पलेट के रूप में दोबारा सबमिट कर सकते हैं।
टेम्पलेट का नाम नहीं मिला: अगर SparkTG API से भेज रहे हैं, तो पक्का करें कि टेम्पलेट का नाम हू-ब-हू सही है — यह केस-सेंसिटिव है। नए अप्रूव हुए टेम्पलेट को API से उपलब्ध होने में 30 मिनट तक लग सकते हैं।

किसी मौजूदा अप्रूव्ड टेम्पलेट में वेरिएबल की संख्या बदलने के लिए उसे एडिट न करें। Meta इसे नया टेम्पलेट मानता है और दोबारा अप्रूवल माँगेगा। वेरिएबल की संख्या बदलनी हो तो हमेशा नया टेम्पलेट बनाएँ।

7. पेमेंट या बिलिंग की समस्याओं के कारण मैसेज फ़ेल

WhatsApp प्रति कन्वर्सेशन शुल्क लेता है (प्रति मैसेज नहीं)। अगर Meta आपके पेमेंट मेथड से शुल्क नहीं ले पाता, तो आउटबाउंड मैसेज API स्तर पर पेमेंट-संबंधी एरर कोड के साथ फ़ेल हो जाएँगे।

1
Meta Business Manager में पेमेंट मेथड जाँचें
business.facebook.com → Settings → Payments में जाएँ। पक्का करें कि एक वैध पेमेंट मेथड फ़ाइल पर है और कोई इनवॉइस बकाया नहीं है।
2
SparkTG अकाउंट क्रेडिट जाँचें
SparkTG Dashboard → Billing। पक्का करें कि आपके SparkTG अकाउंट का बैलेंस कैंपेन के वॉल्यूम के लिए पर्याप्त है। अकाउंट क्रेडिट न्यूनतम सीमा से नीचे जाने पर कैंपेन डिस्पैच नहीं होंगे।
3
हाल ही में माइग्रेट किया हो तो ऑनबोर्डिंग दोबारा सत्यापित करें
अगर आपने हाल ही में अपना WhatsApp नंबर किसी दूसरे प्रोवाइडर से SparkTG पर माइग्रेट किया है, तो पक्का करें कि Meta Business Manager में Business Verification और पेमेंट सेटअप के सभी स्टेप पूरी तरह किए गए थे। अधूरे माइग्रेशन से पेमेंट एरर बार-बार आ सकती हैं।

8. मीडिया अपलोड एरर

अगर आपके टेम्पलेट में मीडिया हेडर है और अपलोड फ़ेल हो जाता है, तो पूरा कैंपेन सेंड ब्लॉक हो जाएगा। WhatsApp की मीडिया फ़ॉर्मेट और कोडेक पर सख़्त आवश्यकताएँ हैं।

इमेज: JPEG या PNG होनी चाहिए, 8-बिट कलर, RGB या RGBA मोड। अधिकतम फ़ाइल साइज़ 5 MB।
वीडियो: H.264 वीडियो कोडेक और AAC ऑडियो कोडेक होना चाहिए। केवल एक ऑडियो स्ट्रीम की अनुमति है। अधिकतम फ़ाइल साइज़ 16 MB।
डॉक्यूमेंट: टेम्पलेट मैसेज हेडर के लिए केवल PDF फ़ॉर्मेट सपोर्टेड है। अधिकतम फ़ाइल साइज़ 100 MB।
अगर वीडियो साइज़ सीमा में है फिर भी फ़ेल हो रहा है, तो समस्या शायद कोडेक की है। HandBrake (H.264 + AAC) जैसे टूल से वीडियो को दोबारा एन्कोड करें और फिर अपलोड करें।

9. मैसेज टेक्स्ट बहुत लंबा है

WhatsApp टेम्पलेट के हर हिस्से पर सख़्त कैरेक्टर सीमा लागू करता है। अगर कोई भी सेक्शन अपनी सीमा से ज़्यादा हुआ, तो मैसेज नहीं जाएगा।

हेडर टेक्स्ट: अधिकतम 60 कैरेक्टर।
बॉडी टेक्स्ट: अधिकतम 1,024 कैरेक्टर।
फ़ुटर टेक्स्ट: अधिकतम 60 कैरेक्टर।
कॉल-टू-एक्शन बटन URL: अधिकतम 2,000 कैरेक्टर।
फ़ॉर्मेटिंग चिह्न (*, _, ~) भी कैरेक्टर सीमा में गिने जाते हैं।

SparkTG का टेम्पलेट एडिटर हर सेक्शन के लिए लाइव कैरेक्टर काउंट दिखाता है। टेम्पलेट बनाते समय इन सीमाओं के भीतर रहें — अप्रूवल के लिए सबमिट होने के बाद इसे ठीक करना कठिन होता है।

10. कैंपेन ब्लॉक — क्रेडिट अपर्याप्त

SparkTG Dashboard → Billing में जाएँ और अपना उपलब्ध क्रेडिट बैलेंस जाँचें।
कैंपेन दोबारा लॉन्च करने से पहले अपना अकाउंट टॉप-अप करें।
पक्का करें कि आपकी कैंपेन लिस्ट के सभी कॉन्टैक्ट्स के कंट्री कोड वैध हैं — अमान्य नंबर फ़ेल डिलीवरी प्रयासों पर भी क्रेडिट खर्च करते हैं।

अगर आपने ऊपर दिए स्टेप अपना लिए हैं और समस्या बनी हुई है, तो SparkTG Dashboard → Help → Contact Support से सपोर्ट टिकट बनाएँ। सबसे तेज़ समाधान के लिए Campaign ID, प्रभावित कॉन्टैक्ट नंबर (ज़रूरत हो तो मास्क करके) और एरर मैसेज का स्क्रीनशॉट शामिल करें।

Frequently asked questions

मेरे WhatsApp कैंपेन के कुछ कॉन्टैक्ट्स में डिलीवरी फ़ेल क्यों दिख रही है?

सबसे आम कारण ये हैं: प्राप्तकर्ता का नंबर WhatsApp पर रजिस्टर्ड नहीं है, नंबर में कंट्री कोड (भारत के लिए +91) नहीं है, प्राप्तकर्ता ने आपका बिज़नेस नंबर ब्लॉक कर दिया है, या उस कॉन्टैक्ट के लिए Meta की प्रति-यूज़र मार्केटिंग फ़्रीक्वेंसी सीमा पूरी हो चुकी है। हर फ़ेल कॉन्टैक्ट के सामने दिए गए एरर कोड के लिए SparkTG Dashboard → Campaigns → Delivery Report देखें।

Meta ने मेरे WhatsApp अकाउंट पर पाबंदी लगा दी है — इसे अनलॉक कैसे करवाऊँ?

business.facebook.com → Settings → WhatsApp Accounts में लॉग-इन करें। अगर अकाउंट प्रतिबंधित है, तो Request Review बटन दिखेगा। अपील सबमिट करें — Meta आमतौर पर 24–48 घंटे में जवाब देता है। समीक्षा के दौरान आप आउटबाउंड कैंपेन मैसेज नहीं भेज सकते। अगर समीक्षा के बाद भी पाबंदी बनी रहे, तो अपनी WABA ID के साथ SparkTG सपोर्ट से संपर्क करें।

मैं अपनी WhatsApp मैसेजिंग सीमा को प्रतिदिन 1,000 कॉन्टैक्ट्स से ऊपर कैसे बढ़ाऊँ?

WhatsApp टियर अपग्रेड अपने आप होते हैं — इन्हें मैन्युअली माँगा नहीं जा सकता। अच्छी क्वालिटी रेटिंग के साथ समय के साथ लगातार ज़्यादा वॉल्यूम में मैसेज भेजते रहें। जब WhatsApp का सिस्टम आपके भेजने के पैटर्न और कम ब्लॉक/रिपोर्ट दर की पुष्टि कर देता है, तो आपका टियर 24 घंटे में 1,000 → 10,000 → 100,000 कॉन्टैक्ट्स तक बढ़ता जाता है।

SparkTG में मेरा WhatsApp टेम्पलेट ‘Paused’ क्यों दिख रहा है?

Meta कम क्वालिटी रेटिंग वाले टेम्पलेट को अपने आप पॉज़ कर देता है, जो तब होता है जब बहुत से प्राप्तकर्ता आपके मैसेज ब्लॉक या रिपोर्ट करते हैं। स्टेटस देखने के लिए Meta Business Manager → WhatsApp Manager → Message Templates में जाएँ। आप संशोधित कंटेंट के साथ नया टेम्पलेट बनाकर दोबारा अप्रूवल के लिए सबमिट कर सकते हैं।

क्या मैं SparkTG WhatsApp कैंपेन में फ़ेल हुए कॉन्टैक्ट्स को दोबारा भेज सकता हूँ?

हाँ — SparkTG Dashboard → Campaigns → अपना कैंपेन चुनें → Delivery Report में जाएँ। फ़ेल हुए कॉन्टैक्ट्स चुनें और Retry विकल्प इस्तेमाल करें। ऑटोमैटिक रीट्राई के लिए, कैंपेन लॉन्च करने से पहले Campaign Settings में Retry Policy कॉन्फ़िगर करें।

क्या डिलीवर न होने वाले WhatsApp मैसेज के लिए मुझसे शुल्क लिया जाएगा?

WhatsApp प्रति कन्वर्सेशन सेशन शुल्क लेता है, प्रति मैसेज नहीं। अगर किसी कॉन्टैक्ट के साथ कोई कन्वर्सेशन सेशन शुरू ही नहीं हुआ (यानी मैसेज कभी डिलीवर नहीं हुआ), तो कोई कन्वर्सेशन शुल्क नहीं लगता। प्रति-कॉन्टैक्ट ब्रेकडाउन के लिए SparkTG Dashboard → Billing → Usage देखें।

Was this article helpful?

Still stuck? Contact our support team →

Back to WhatsApp Business API