लग इननिःशुल्क ट्रायल सुरु गर्नुहोस्
Meta Tech Provider

WhatsApp म्यासेज किन असफल भयो: failed स्ट्याटस र त्यसका त्रुटिहरू पढ्ने तरिका

failed स्ट्याटस वेबहुकको अर्थ हो, व्यवसायले एपीआई मार्फत पठाएको म्यासेज Meta ले पठाउन वा डेलिभर गर्न सकेन। यो messages फिल्डमा status failed सहित आउँछ, र यसमा code, title, message, error_data.details र href भएको errors एरे हुन्छ। कोडले कारण बताउँछ: 131047 विन्डो बन्द, 131026 डेलिभर हुन नसक्ने, 131049 मार्केटिङ सीमा, 131050 मार्केटिङ बन्द, 131042 भुक्तानी समस्या।

easyCoexistence ले तपाईंको WhatsApp Business एपको नम्बरलाई Coexistence मार्फत Meta को Cloud API सँग जोड्छ, र failed स्ट्याटसहरू तपाईंको सर्भरमा पठाउँछ, सिधै वा स्वचालन सक्रिय हुँदा हस्ताक्षरित forward का रूपमा।

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 को त्रुटि कोड सूचीमा लैजान्छ। यो 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"
        }
      ]
    }
  ]
}

कुन त्रुटि कोड सबैभन्दा बढी देखिन्छन्, र तिनको अर्थ के हो?

Meta ले त्रुटिहरू पठाउने प्रतिक्रियामा, failed स्ट्याटसमा, वा दुवैमा पठाउँछ, त्यसैले एउटै कोड जुनसुकै तरिकाले आउन सक्छ, र तपाईंको ह्यान्डलरले दुवै ठाउँ पढ्नुपर्छ। यी कोडहरूले धेरैजसो नपुगेका म्यासेजको कारण बताउँछन्, Meta को आफ्नै कारण र पहिले गर्नुपर्ने कामसहित; पूरा सूची Meta को त्रुटि कोड सन्दर्भमा छ:

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.

प्रत्येक प्रकारको असफलतामा ह्यान्डलरले कसरी प्रतिक्रिया दिनुपर्छ?

पुनः प्रयास गर्नुअघि कोडलाई अर्को कदम अनुसार छुट्याउनुहोस्। अन्धाधुन्ध पुनः प्रयासले मार्केटिङ अप्ट-आउटलाई बारम्बार असफलतामा बदल्छ र ब्लक लम्ब्याउन सक्छ, जबकि अस्थायी त्रुटि छाडिदिँदा एक मिनेटमा पुग्ने म्यासेज हराउँछ।

  • ब्याकअफसहित पुनः प्रयास: 131000 अज्ञात, 131016 सेवा उपलब्ध छैन, 130429 थ्रुपुट सीमा पुगेको।
  • पहिले पर्खनुहोस्: 131049, कम्तीमा 24 घण्टा, किनभने चाँडो पुनः प्रयासले त्यो प्रयोगकर्तालाई थप 24 घण्टासम्म ब्लक गर्न सक्छ।
  • म्यासेज बदल्नुहोस्: 131047 मा स्वीकृत टेम्प्लेट चाहिन्छ, किनभने 24 घण्टाको विन्डो बन्द भइसकेको छ।
  • यो ग्राहकका लागि रोक्नुहोस्: 131050, user_preferences resume आउँदासम्म।
  • खाता वा सामग्री सुधार्नुहोस्: 131042 भुक्तानी, 131031 खाता प्रतिबन्धित, 131053 मिडिया।

कुन असफलता केवल failed स्ट्याटसमा देखिन्छ?

Meta ले अनुरोध स्वीकार गरेपछि मात्र निर्णय गर्ने असफलता। पठाउने कलले wamid फर्काउँछ, र इन्कार पछि यही webhook मा आउँछ। Meta ले मार्केटिङ टेम्प्लेट United States फोन नम्बर (+1 र US क्षेत्र कोड) भएका WhatsApp प्रयोगकर्तालाई डेलिभर गर्दैन। मार्केटिङ म्यासेज रोक्ने छनोट गरेको ग्राहकलाई मार्केटिङ टेम्प्लेट प्रशोधन भएर 131050 सहित असफल भनेर रिपोर्ट हुन्छ, र प्रति प्रयोगकर्ता मार्केटिङ सीमाले 131049 त्यसैगरी रिपोर्ट गर्छ।

यदि नम्बरमा webhook गन्तव्य छैन भने, यी असफलता तपाईंले देख्न सक्ने कुनै ठाउँमा जाँदैनन् र म्यासेज पठाइएको जस्तो मात्र देखिन्छ। ग्राहकले केही नपाएको बेला जाँच गर्ने पूरा क्रमका लागि WhatsApp API म्यासेज डेलिभर नभएको पृष्ठ हेर्नुहोस्।

Coexistence नम्बरमा के फरक पर्छ?

दुई कुरा महत्त्वपूर्ण छन्। पहिलो, 24 घण्टाको विन्डो केवल API मा लागू हुन्छ। Meta को Coexistence गाइडले भन्छ WhatsApp Business एपबाट पठाइएका म्यासेजमा ग्राहक सेवा विन्डो लाग्दैन, त्यसैले 131047 पछि मालिकले फोनबाट अझै त्यो ग्राहकलाई उत्तर दिन सक्छ, जबकि तपाईंको प्रणालीले स्वीकृत टेम्प्लेट पठाउँछ।

दोस्रो, थ्रुपुट स्थिर छ। एप र API मा एकैसाथ प्रयोग गरिएको नम्बरले प्रति सेकेन्ड अधिकतम 20 म्यासेज पठाउँछ, र त्योभन्दा बढी गर्दा 130429 फर्किन्छ। बाँकी सबै कुरा Cloud API नम्बरमा जस्तै नै पढिन्छ: उही फिल्ड, उही errors एरे, उही कोड।

स्वचालन र तपाईंको AI ले असफलतालाई कसरी देख्छन्?

यो Meta ले कहिले इन्कार गर्छ त्यसमा निर्भर गर्छ। पठाउने समयमा आएको इन्कार, जस्तै 131047, ले स्वचालनको चरण असफल बनाउँछ: Runs ट्याबमा रन Failed देखिन्छ, Meta को म्यासेजसहित, र मालिकले इमेल पाउँछ ताकि उनीहरू त्यो ग्राहकलाई आफैं उत्तर दिन सकून्। स्वचालनले स्वतन्त्र टेक्स्ट उत्तर पठाउनुअघि पनि विन्डो जाँच गर्छ र प्रयास नगरी window_closed सँग छोड्छ।

Meta ले पछि रिपोर्ट गरेको असफलता तपाईंको Forward URL वा सिधै गन्तव्यमा failed स्ट्याटसको रूपमा आउँछ, र रन जस्तो थियो त्यस्तै रहन्छ। MCP connector मार्फत टेम्प्लेट पठाएको AI ले wamid र "sent: true" देख्छ। धेरै म्यासेज एकैसाथ असफल हुँदा wamid को स्ट्याटस तपाईंको प्रणालीलाई सोध्नुहोस्, वा सहायकलाई get_number_health चलाउन लगाउनुहोस्।

सामान्य गल्तीहरू

  • 131050 लाई लुपमा पुनः प्रयास गर्नु। ग्राहकले मार्केटिङ म्यासेज रोकेको छ, त्यसैले फिर्ता नआएसम्म हरेक प्रयास उही तरिकाले असफल हुन्छ।
  • 131049 मार्केटिङ टेम्प्लेट घण्टाभित्रै फेरि पठाउनु। Meta ले कम्तीमा 24 घण्टा माग्छ, र चाँडो पुनः प्रयासले त्यो प्रयोगकर्तालाई थप 24 घण्टासम्म ब्लक गर्न सक्छ।
  • केवल title लग गर्नु। error_data.details ले विशिष्ट कारण बोक्छ, त्यसैले code र details दुवै wamid सँगै भण्डारण गर्नुहोस्।
  • webhook गन्तव्य बिना चलाएर पठाउने प्रतिक्रियाबाट डेलिभरी जाँच्नु, जसले केवल Meta ले म्यासेज स्वीकार गरेको मात्र भन्छ।
EasyCoexistence मार्फत यो काम

स्वचालनको उत्तर पठाउँदा इन्कार भएमा रनले Meta को त्रुटि देखाउँछ र तपाईंले इमेल पाउनुहुन्छ। हरेक नम्बरको 24/7 डिस्कनेक्सन र गुणस्तर घट्ने कुरामा निगरानी गरिन्छ। प्रति नम्बर प्रति महिना US$ 9 देखि US$ 0.75 सम्म, नम्बर थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।

बारम्बार सोधिने प्रश्नहरू

के Meta ले असफल म्यासेजको शुल्क लिन्छ?

Meta का मूल्य निर्धारण पृष्ठले भन्छ, यसले डेलिभर भएका म्यासेजको मात्र शुल्क लिन्छ, केवल पठाइएका म्यासेजको होइन। failed स्ट्याटसमा pricing अब्जेक्ट हुँदैन। शुल्क व्यवसायको आफ्नै WhatsApp Business खाता मा जान्छ, र easyCoexistence ले त्यसमा कहिल्यै अतिरिक्त शुल्क जोड्दैन।

के 131026 को अर्थ ग्राहकले व्यवसायलाई ब्लक गरेको हो?

Meta को 131026 सूचीले अरू कारण उल्लेख गर्छ: नम्बर WhatsApp मा छैन, प्राप्तकर्ताले नयाँ सर्तहरू स्वीकार गरेका छैनन्, वा उनीहरूको WhatsApp संस्करण धेरै पुरानो छ। Meta ले ती जाँच गर्न अर्को च्यानलमार्फत ग्राहकलाई सोध्न सुझाउँछ।

recipient_user_id कुनैमा किन आउँछ र कुनैमा किन आउँदैन?

Meta ले फोन नम्बरमा पठाइएको म्यासेज असफल हुँदा यसलाई failed स्ट्याटसमा छोड्छ। ग्राहकको BSUID मा पठाउँदा असफलतामा यो समावेश हुन्छ, र recipient_id छुट्न सक्छ।

के म्यासेज डेलिभर भइसकेपछि पनि असफल हुन सक्छ?

Meta को सन्दर्भले failed लाई पठाउन वा डेलिभर गर्न नसकेको असफलता भनेर परिभाषित गर्छ। म्यासेज यन्त्रमा पुगिसकेपछि, तपाईंले अपेक्षा गर्न सक्ने अर्को स्ट्याटस read हो, वा आवाज म्यासेजका लागि played।

पढ्दै जानुहोस्

WhatsApp वेबहुक स्ट्याटस: sent, delivered, read र failedWhatsApp ले तपाईंले पठाएको म्यासेजमा के भयो भनी जनाउँछ: statuses array, प्रत्येक status मान, फिल्ड र wamid सँग मिल्ने पेलोड।WhatsApp user_preferences वेबहुक: ग्राहकले मार्केटिङ म्यासेज कहिले रोक्छ वा पुनः सुरु गर्छWhatsApp user_preferences वेबहुक ग्राहकले तपाईंका मार्केटिङ म्यासेज रोक्दा वा फेरि सुरु गर्दा ट्रिगर हुन्छ। पेलोड, त्यसपछि के गर्ने र 131050 फलब्याक।WhatsApp API म्यासेज डेलिभर नभएको: कारणहरू, क्रमअनुसारWhatsApp API म्यासेज नपुग्दा: स्ट्याटस वेबहुक, 24 घण्टाको विन्डो, भुक्तानी, टेम्प्लेट, प्राप्तकर्ता र सीमा, फेला पार्ने क्रममा जाँच।WhatsApp टेम्प्लेट रोकिएको वा असक्षम: के गर्नेकम गुणस्तरको WhatsApp टेम्प्लेट 3 घण्टा, त्यसपछि 6 घण्टा रोकिन्छ र तेस्रो पटक असक्षम हुन्छ। कसरी थाहा पाउने, के बदल्ने र अर्को कदम।WhatsApp त्रुटि 131049: इकोसिस्टमको स्वस्थताका लागि म्यासेज रोकियोत्रुटि 131049 मा Meta ले इकोसिस्टमको स्वस्थता जोगाउन म्यासेज रोक्छ, 24 घण्टे समयसीमा सकिएर होइन। टेम्प्लेटले किन समाधान गर्दैन।24 घण्टाको ग्राहक सेवा विन्डोग्राहक सेवा विन्डो के हो, कहिले खुल्छ र बन्द हुन्छ, यसभित्र वा बाहिर के पठाउन सकिन्छ, र प्रतिक्रिया निःशुल्क किन हुन्छन्।

सुरु गर्न तयार हुनुहुन्छ?

महिनौं होइन, केही मिनेटमै WhatsApp Coexistence सेट अप गर्नुहोस्। एप फोनमा चलिरहन्छ।

निःशुल्क ट्रायल सुरु गर्नुहोस्

प्रमाणीकरण गरिएको