WhatsApp API म्यासेज डेलिभर नभएको: कारणहरू, क्रमअनुसार
WhatsApp API बाट स्वीकार गरिएको म्यासेज डेलिभर भएको म्यासेज होइन। 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 दुवैमा प्रयोग हुने नम्बरको तय थ्रुपुट।
किन स्वीकृत भएको म्यासेज पनि पुग्दैन?
किनभने API को उत्तर र डेलिभरी दुई छुट्टाछुट्टै घटना हुन्। तपाईंले पठाउँदा, Meta ले अनुरोध स्वीकार गर्नासाथ म्यासेज आइडी फर्काउँछ; म्यासेज ग्राहकको फोनमा पुग्यो कि पुगेन भन्ने कुरा पछि messages फिल्डमा स्ट्याटस वेबहुकमा आउँछ। sent भनेको Meta को सर्भरबाट निस्कियो (एउटा चेक चिन्ह), delivered भनेको यन्त्रमा पुग्यो (दुईवटा), read भनेको खोलियो (दुईवटा निलो), र failed भनेको पठाउन वा डेलिभर गर्न सकिएन, जुन तपाईंलाई errors सूची सहित देखाइन्छ: 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 प्रतिबन्धित वा निष्क्रिय।
- जडान: नम्बर अब जोडिएको छैन, उदाहरणका लागि 14 दिनसम्म WhatsApp Business एप नखोलेपछि।
प्राप्तकर्ताका कोडहरू कसरी सम्हाल्ने?
फरक तरिकाले, किनभने कुनैमा पुनः प्रयास गर्न उपयुक्त छ र कुनैमा कहिल्यै छैन। 131050 को अर्थ व्यक्तिले तपाईंबाट मार्केटिङ म्यासेज रोक्न रोजेको हो: Meta भन्छ पुनः प्रयास नगर्नुहोस्, र user_preferences वेबहुकले कहिले रोकियो वा फेरि सुरु भयो भन्ने बताउँछ। 131049 मा Meta ले स्वस्थ सहभागिता कायम राख्न मार्केटिङ म्यासेज रोकेको हुन्छ, प्रायः मार्केटिङ टेम्प्लेटमा प्रति प्रयोगकर्ता सीमा; Meta ले कम्तीमा 24 घण्टा पर्खन सल्लाह दिन्छ, किनभने चाँडो पठाउँदा उही त्रुटि फर्किन्छ। 131026 ले WhatsApp मा नभएका नम्बर, WhatsApp को हालको सर्त स्वीकार नगरेका प्रयोगकर्ता र धेरै पुराना एप संस्करण समेट्छ; पहिले नम्बरको फर्म्याट र देश कोड जाँच गर्नुहोस्, त्यसपछि ग्राहकलाई अर्को च्यानलमार्फत सोध्नुहोस्।
WhatsApp ले कति समयसम्म डेलिभर गर्न प्रयास गर्छ?
म्यासेजको जीवनकाल (TTL) सम्म। फोन बन्द वा कभरेज बाहिर हुँदा, WhatsApp तुरुन्तै असफल नभई पुनः प्रयास गर्छ: पूर्वनिर्धारित रूपमा उपयोगिता र मार्केटिङ टेम्प्लेटमा 30 दिन र प्रमाणीकरण टेम्प्लेटमा 10 मिनेट। व्यवसायले प्रति टेम्प्लेट message_send_ttl_seconds सँग यो घटाउन सक्छ: उपयोगिताका लागि 30 सेकेन्डदेखि 12 घण्टासम्म, र प्रमाणीकरणका लागि 30 सेकेन्डदेखि 15 मिनेटसम्म। TTL भित्र डेलिभर हुन नसकेको म्यासेज छोडिन्छ। त्यसैले घण्टौंपछि पनि sent स्ट्याटस भएको र डेलिभर स्ट्याटस नभएको म्यासेज प्रायः ग्राहकको फोनमा पर्खिरहेको हुन्छ, हराएको होइन। कोड र समय-संवेदनशील अलर्टमा छोटो TTL सेट गर्नुहोस्, ताकि ढिलो डेलिभरीले कसैलाई भ्रममा नपारोस्।
AI प्रतिक्रिया र स्वचालनका लागि यसको अर्थ के हो?
पहिले रन, त्यसपछि स्ट्याटस हेर्नुहोस्। Runs ट्याबमा, Skipped रनले केही पठाएन र किन भनेर बताउँछ: ग्राहकको अन्तिम म्यासेजदेखि 24 घण्टाभन्दा बढी भयो, तपाईंले यो च्याटको प्रतिक्रिया हालसालै फोनबाट दिनुभयो, वा यो घण्टाका लागि यो च्याटको AI प्रतिक्रिया सीमा पुग्यो। Done रनको अर्थ Meta ले हरेक प्रतिक्रिया स्वीकार गर्यो, जुन डेलिभरीको प्रमाण होइन। easyCoexistence ले म्यासेज स्ट्याटस भण्डारण गर्दैन: स्वचालन खुला हुँदा, तपाईंले फर्वार्ड यूआरएल सेट गरेमा त्यहाँ पुग्छन्, र डाइरेक्ट मोडमा तिनीहरू सिधै तपाईंको आफ्नै एन्डपोइन्टमा जान्छन्। ChatGPT वा Claude बाट, आफ्नो AI लाई get_number_health चलाउन भन्नुहोस्: यसले प्रत्यक्ष स्ट्याटस, गुणस्तर मूल्याङ्कन र अन्तिम 15 निगरानी घटना फर्काउँछ, जसमा Meta को कोडसहित sending ब्लक पनि समावेश हुन्छ।
यसलाई कसरी सेट अप गर्ने
- 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 घण्टापछि स्वतन्त्र प्रतिक्रिया पठाउनु। ग्राहकको म्यासेज बिना 24 घण्टा बितेपछि केवल टेम्प्लेट स्वीकार हुन्छ।
- वेबहुक गन्तव्य बिना चलाउनु। असफल स्ट्याटस केवल वेबहुकमार्फत आउँछन्, त्यसैले गन्तव्य नभए म्यासेज किन नपुगेको कारण हराउँछ।
तपाईंको AI ले ChatGPT वा Claude बाट get_number_health सँग नम्बर जाँच गर्न सक्छ। प्रति नम्बर प्रति महिना US$ 9 देखि US$ 0.75 सम्म, नम्बर थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
किन म्यासेज घण्टौंसम्म एउटा चेक चिन्ह देखायो?
एउटा चेक चिन्ह भनेको sent स्ट्याटस हो: Meta ले पठायो, तर फोनले प्राप्त गरेन, प्रायः फोन बन्द वा अफलाइन भएकाले। utility र मार्केटिङ टेम्प्लेटको जीवनकाल (TTL) सकिनुअघि WhatsApp पुनः प्रयास गरिरहन्छ, पूर्वनिर्धारित रूपमा 30 दिनसम्म।
किन म्यासेज पुग्छन् तर टेम्प्लेट पुग्दैनन्?
प्रायः WhatsApp Business Account मा भुक्तानी विधिको समस्या हुन्छ। भुक्तानी विधि नभए पनि, नम्बरको मासिक निःशुल्क सीमाभित्र सेवा म्यासेज डेलिभर हुन्छ, तर टेम्प्लेट हुँदैन। Billing & payments मा कार्ड थप्नुहोस्।
के मैले WhatsApp Business एपमा असफल म्यासेज देख्न सक्छु?
भरपर्दो रूपमा होइन। Coexistence नम्बरमा API मार्फत पठाइएका म्यासेज एपको च्याट थ्रेडमा देखिन्छन्, तर म्यासेज किन असफल भयो भन्ने कारण स्ट्याटस वेबहुकको त्रुटि कोडमा मात्र आउँछ।
के Meta ले डेलिभर नभएका म्यासेजको शुल्क लिन्छ?
लिँदैन। Meta ले डेलिभर भएका म्यासेजको मात्र शुल्क लिन्छ, र रोकिएको टेम्प्लेटमा गरिएका प्रयासको पनि शुल्क लाग्दैन।
पढ्दै जानुहोस्
सुरु गर्न तयार हुनुहुन्छ?
महिनौं होइन, केही मिनेटमै WhatsApp Coexistence सेट अप गर्नुहोस्। एप फोनमा चलिरहन्छ।
निःशुल्क ट्रायल सुरु गर्नुहोस्प्रमाणीकरण गरिएको