WhatsApp मेसेज का अयशस्वी झाला: अयशस्वी स्टेटस आणि त्रुटी वाचणे
अयशस्वी स्टेटस वेबहुक म्हणजे व्यवसायाने एपीआयद्वारे पाठवलेला मेसेज Meta ला पाठवता किंवा पोहोचवता आला नाही. तो messages फील्डवर status failed आणि errors array सह येतो, ज्यात code, title, message, error_data.details आणि href असतात. code वरून कारण कळते: 131047 विंडो बंद, 131026 पोहोचवता न येणारा, 131049 मार्केटिंग मर्यादा, 131050 मार्केटिंग थांबवलेले, 131042 पेमेंट समस्या.
easyCoexistence तुमचा WhatsApp Business ॲप नंबर Coexistence द्वारे Meta च्या Cloud API ला जोडते आणि अयशस्वी स्टेटस तुमच्या सर्व्हरकडे पाठवते, थेट किंवा ऑटोमेशन चालू असताना साइन केलेल्या फॉरवर्डद्वारे.
प्राप्तकर्त्याने शेवटच्या वेळी रिप्लाय दिल्यापासून 24 तासांहून अधिक काळ उलटला आहे; Meta चा उपाय म्हणजे त्याऐवजी टेम्प्लेट पाठवणे.
इकोसिस्टमचा सहभाग निरोगी राहावा यासाठी मेसेज पोहोचवला जात नाही; मार्केटिंग टेम्प्लेट पुन्हा पाठवण्यापूर्वी किमान 24 तास थांबा.
प्राप्तकर्त्याने व्यवसायाकडून मार्केटिंग मेसेज थांबवण्याचा पर्याय निवडला आहे; Meta सांगते की पुन्हा प्रयत्न करू नका.
अयशस्वी स्टेटसमध्ये contacts array नसतो, त्यामुळे statuses.id वापरून अपयश जुळवा.
Meta मेसेज पोहोचल्यावर शुल्क आकारते, पाठवल्यावर नाही.
अयशस्वी स्टेटस कसा दिसतो?
इतर स्टेटससारखाच, पण त्यात errors असतात. contacts array नसतो, मेसेज फोन नंबरवर पाठवलेला असल्यास recipient_user_id वगळला जातो आणि pricing ऑब्जेक्ट नसतो. title आणि message एकच मजकूर देतात, error_data.details एका वाक्यात कारण स्पष्ट करते, आणि href Meta च्या त्रुटी कोड यादीकडे नेतो. हे Meta चे स्वतःचे उदाहरण आहे: प्रति-वापरकर्ता मर्यादेमुळे थांबवलेला मार्केटिंग टेम्प्लेट:
{
"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 त्रुटी पाठवणीच्या प्रतिसादात, अयशस्वी स्टेटसमध्ये किंवा दोन्हीत परत करते, त्यामुळे तोच कोड दोन्ही प्रकारे येऊ शकतो; तुमच्या हँडलरने दोन्ही ठिकाणी वाचले पाहिजे. मेसेज न पोहोचण्यामागील बहुतेक कारणे स्पष्ट करणारे हे कोड आहेत, Meta चे स्वतःचे कारण आणि पहिली कृती यासह; संपूर्ण यादी Meta च्या त्रुटी कोड संदर्भात आहे:
हँडलरने प्रत्येक प्रकारच्या अपयशावर कशी प्रतिक्रिया द्यावी?
पुन्हा प्रयत्न होण्यापूर्वी कोड पुढील कृतीनुसार वर्गीकृत करा. सरसकट पुन्हा प्रयत्न केल्यास मार्केटिंग ऑप्ट-आउट वारंवार अपयशात बदलते आणि ब्लॉक वाढवू शकते, तर तात्पुरती त्रुटी वगळल्यास एका मिनिटात पोहोचला असता असा मेसेज हरवतो.
- बॅकऑफसह पुन्हा प्रयत्न करा: 131000 अज्ञात, 131016 सेवा उपलब्ध नाही, 130429 थ्रूपुट मर्यादा गाठली.
- आधी थांबा: 131049, किमान 24 तास, कारण लवकरच्या प्रयत्नांमुळे त्या वापरकर्त्याला आणखी 24 तासांपर्यंत ब्लॉक केले जाऊ शकते.
- मेसेज बदला: 131047 ला मंजूर टेम्प्लेट हवा, कारण 24 तासांची विंडो बंद आहे.
- या ग्राहकासाठी थांबवा: 131050,
user_preferencesमधील resume सूचना येईपर्यंत. - खाते किंवा कंटेंट दुरुस्त करा: 131042 पेमेंट, 131031 खाते प्रतिबंधित, 131053 मीडिया.
कोणती अपयशे फक्त अयशस्वी स्टेटसमध्ये दिसतात?
ती जी Meta विनंती स्वीकारल्यानंतर ठरवते. पाठवणीत wamid परत येतो आणि नकार नंतर या webhook वर येतो. Meta अमेरिकेचे फोन नंबर (+1 आणि अमेरिकन एरिया कोड) असलेल्या WhatsApp वापरकर्त्यांना मार्केटिंग टेम्प्लेट पोहोचवत नाही; मार्केटिंग मेसेज थांबवलेल्या ग्राहकाला पाठवलेला मार्केटिंग टेम्प्लेट प्रक्रिया होतो आणि मग 131050 सह अयशस्वी म्हणून कळवला जातो, आणि प्रति-वापरकर्ता मार्केटिंग मर्यादा त्याच पद्धतीने 131049 कळवते.
जर नंबरला webhook गंतव्य नसेल, तर ही अपयशे तुम्हाला कुठेच दिसत नाहीत आणि मेसेज फक्त पाठवलेला दिसतो. ग्राहकाला काहीच मिळाले नसेल तेव्हा तपासणीचा पूर्ण क्रम पाहण्यासाठी WhatsApp एपीआय मेसेज न पोहोचणे हे पान पाहा.
Coexistence नंबरवर काय बदलते?
दोन गोष्टी महत्त्वाच्या आहेत. पहिली, 24 तासांची विंडो फक्त एपीआयला लागू होते. Meta चे Coexistence मार्गदर्शक सांगते की WhatsApp Business ॲपवरून पाठवलेले मेसेज ग्राहक सेवा विंडोच्या अधीन नसतात, त्यामुळे 131047 नंतरही मालक फोनवरून त्या ग्राहकाला उत्तर देऊ शकतो, तर तुमची प्रणाली मंजूर टेम्प्लेट पाठवते.
दुसरी, थ्रूपुट निश्चित आहे. ॲप आणि एपीआय दोन्हीत एकाच वेळी वापरले जाणारे नंबर प्रति सेकंद जास्तीत जास्त 20 मेसेज पाठवते, आणि त्यापुढे गेल्यास 130429 परत येतो. बाकी सर्व कोणत्याही Cloud API नंबरसारखेच दिसते: तेच फील्ड, तोच errors array, तेच कोड.
ऑटोमेशन आणि तुमचा AI अपयश कसे पाहतात?
ते Meta कधी नकार देते यावर अवलंबून. पाठवण्याच्या वेळी नकार, जसे की 131047, ऑटोमेशनच्या स्टेपला अयशस्वी करतो: रन Runs टॅबमध्ये Meta च्या मेसेजसह Failed दाखवतो आणि मालकाला ईमेल मिळतो, जेणेकरून तो त्या ग्राहकाला स्वतः उत्तर देऊ शकेल. ऑटोमेशन मुक्त मजकूराचे उत्तर पाठवण्यापूर्वी विंडो तपासतात आणि प्रयत्न करण्याऐवजी window_closed सह वगळतात.
नंतर Meta कळवणारे अपयश तुमच्या Forward URL किंवा थेट गंतव्यावर अयशस्वी स्टेटस म्हणून येते आणि रन जसा होता तसाच राहतो. MCP कनेक्टरद्वारे टेम्प्लेट पाठवणारा AI wamid आणि "sent: true" पाहतो; त्या wamid चे स्टेटस तुमच्या प्रणालीला विचारा, किंवा अनेक मेसेज एकाच वेळी अयशस्वी झाल्यास असिस्टंटला get_number_health चालवायला सांगा.
सामान्य चुका
- 131050 लूपमध्ये पुन्हा प्रयत्न करणे. ग्राहकाने मार्केटिंग मेसेज थांबवले आहेत, त्यामुळे प्रत्येक प्रयत्न तसाच अयशस्वी होतो, जोपर्यंत ते पुन्हा सुरू करत नाहीत.
- 131049 मार्केटिंग टेम्प्लेट काही तासांत पुन्हा पाठवणे. Meta किमान 24 तास मागते, आणि लवकरचे प्रयत्न त्या वापरकर्त्याला आणखी 24 तासांपर्यंत ब्लॉक करू शकतात.
- फक्त title लॉग करणे. error_data.details मध्ये विशिष्ट कारण असते, त्यामुळे code आणि details एकत्र wamid सोबत साठवा.
- webhook गंतव्याशिवाय चालवणे आणि पाठवण्याच्या प्रतिसादावरून डिलिव्हरी ठरवणे, जो फक्त Meta ने मेसेज स्वीकारल्याचे सांगतो.
ऑटोमेशनचे उत्तर पाठवण्याच्या वेळी नाकारले गेल्यास रन Meta ची त्रुटी दाखवतो आणि तुम्हाला ईमेल मिळतो, आणि प्रत्येक नंबर डिस्कनेक्शन व गुणवत्तेतील घसरणीसाठी 24/7 तपासला जातो. प्रति नंबर प्रति महिना US$ 9 पासून US$ 0.75 पर्यंत, नंबर वाढवताना कमी होत जाते, आणि पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
Meta कडून अयशस्वी मेसेजवर शुल्क आकारले जाते का?
Meta च्या किंमत पृष्ठांनुसार ती पोहोचलेल्या मेसेजसाठी शुल्क आकारते, फक्त पाठवलेल्यासाठी नाही. अयशस्वी स्टेटसमध्ये pricing ऑब्जेक्ट नसतो. शुल्क व्यवसायाच्या स्वतःच्या WhatsApp Business Account वर जाते; easyCoexistence त्यावर कधीही मार्कअप लावत नाही.
131026 म्हणजे ग्राहकाने व्यवसायाला ब्लॉक केले आहे का?
131026 साठी Meta ची यादी इतर कारणे नमूद करते: नंबर WhatsApp वर नाही, प्राप्तकर्त्याने नवीनतम अटी स्वीकारलेल्या नाहीत, किंवा त्यांची WhatsApp आवृत्ती खूप जुनी आहे. Meta सुचवते की हे तपासण्यासाठी ग्राहकाला दुसऱ्या चॅनेलद्वारे विचारा.
recipient_user_id काही अपयशांवर का दिसतो आणि इतरांवर का नाही?
फोन नंबरवर मेसेज पाठवलेला असल्यास Meta तो अयशस्वी स्टेटसमधून वगळते. ग्राहकाच्या BSUID वर पाठवल्यास अपयशात तो असतो, आणि कदाचित recipient_id गहाळ असतो.
मेसेज डिलिव्हर झाल्यानंतर अपयश येऊ शकते का?
Meta चा संदर्भ अयशस्वी म्हणजे पाठवण्यात किंवा पोहोचवण्यात अपयश असे वर्णन करतो. मेसेज डिव्हाइसपर्यंत पोहोचल्यावर, तुम्हाला अपेक्षित पुढील स्टेटस read, किंवा व्हॉइस मेसेजसाठी played असतो.
पुढे वाचा
सुरुवात करण्यासाठी तयार आहात?
WhatsApp Coexistence काही मिनिटांत सेट करा, काही महिन्यांत नाही. ॲप फोनवर काम करत राहते.
मोफत ट्रायल सुरू करापडताळले: