WhatsApp మెసేజ్ ఎందుకు విఫలమైంది: విఫల స్టేటస్, ఎర్రర్ వివరాలు చదవడం
ఫెయిల్డ్ స్టేటస్ వెబ్హుక్ అంటే, వ్యాపారం API ద్వారా పంపిన మెసేజ్ను Meta పంపలేకపోయింది లేదా చేర్చలేకపోయింది అని అర్థం. ఇది messages ఫీల్డ్పై status failed తో వస్తుంది, దానిలో code, title, message, error_data.details మరియు href ఉన్న errors అర్రే ఉంటుంది. కోడ్ కారణాన్ని చెబుతుంది: 131047 విండో మూసివేయబడింది, 131026 చేర్చలేనిది, 131049 మార్కెటింగ్ పరిమితి, 131050 మార్కెటింగ్ నిలిపివేయబడింది, 131042 చెల్లింపు సమస్య.
easyCoexistence మీ WhatsApp Business యాప్ నంబర్ను Coexistence ద్వారా Meta యొక్క Cloud API కి కలుపుతుంది, మరియు విఫల స్టేటస్లను ఆటోమేషన్లు ఆన్లో ఉంటే నేరుగా లేదా సంతకం చేసిన ఫార్వర్డ్లుగా మీ సర్వర్కు పంపుతుంది.
గ్రహీత చివరిసారి ప్రతిస్పందించి 24 గంటలకు పైగా గడిచాయి; అప్పుడు Meta సూచించేది టెంప్లేట్ పంపడం.
ఎకోసిస్టమ్ ఎంగేజ్మెంట్ను ఆరోగ్యంగా ఉంచడానికి డెలివరీ చేయలేదు; మార్కెటింగ్ టెంప్లేట్ను మళ్లీ పంపే ముందు కనీసం 24 గంటలు వేచి ఉండండి.
గ్రహీత ఈ వ్యాపారం నుండి మార్కెటింగ్ మెసేజ్లు ఆపమని ఎంచుకున్నారు; Meta మళ్లీ ప్రయత్నించవద్దని చెబుతుంది.
విఫల స్టేటస్లో contacts అర్రే ఉండదు, కాబట్టి statuses.id ద్వారా వైఫల్యాన్ని సరిపోల్చండి.
Meta ఛార్జ్ చేసేది: మెసేజ్లు పంపినప్పుడు కాదు, డెలివరీ అయినప్పుడు మాత్రమే బిల్ చేయబడతాయి.
విఫల స్టేటస్ ఎలా కనిపిస్తుంది?
మరే స్టేటస్లాగానే, కానీ errors కూడా ఉంటుంది. contacts అర్రే ఉండదు, మెసేజ్ ఫోన్ నంబర్కు పంపినప్పుడు 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_preferencesresume వచ్చే వరకు. - ఖాతా లేదా కంటెంట్ సరిచేయండి: 131042 చెల్లింపు, 131031 ఖాతా పరిమితం చేయబడింది, 131053 మీడియా.
ఏ వైఫల్యాలు కేవలం విఫల స్టేటస్గా మాత్రమే కనిపిస్తాయి?
Meta అభ్యర్థనను అంగీకరించిన తర్వాత నిర్ణయించేవి. పంపే కాల్ wamid ను తిరిగి ఇస్తుంది, తిరస్కరణ తర్వాత ఈ వెబ్హుక్పై వస్తుంది. Meta యునైటెడ్ స్టేట్స్ ఫోన్ నంబర్లు (+1 తో US ఏరియా కోడ్) ఉన్న WhatsApp వినియోగదారులకు మార్కెటింగ్ టెంప్లేట్లను డెలివరీ చేయదు; మార్కెటింగ్ మెసేజ్లు ఆపమని కోరిన కస్టమర్కు మార్కెటింగ్ టెంప్లేట్ ప్రాసెస్ అయ్యి, 131050 తో ఫెయిల్ అయినట్టు నివేదించబడుతుంది, అలాగే ప్రతి-వినియోగదారు మార్కెటింగ్ పరిమితి 131049 ను అదే విధంగా నివేదిస్తుంది.
ఫోన్ నంబర్కు వెబ్హుక్ గమ్యస్థానం లేకపోతే, ఈ వైఫల్యాలు మీకు కనిపించే చోట చేరవు, మెసేజ్ పంపినట్టే కనిపిస్తుంది. కస్టమర్కు ఏమీ అందనప్పుడు తనిఖీల పూర్తి క్రమం కోసం, WhatsApp API మెసేజ్లు డెలివరీ కాకపోవడం పేజీ చూడండి.
Coexistence నంబర్లో ఏమి మారుతుంది?
రెండు విషయాలు ముఖ్యం. మొదటిది, 24 గంటల విండో APIకు మాత్రమే వర్తిస్తుంది. Meta యొక్క Coexistence గైడ్ చెబుతుంది WhatsApp Business యాప్ నుండి పంపిన మెసేజ్లకు కస్టమర్ సర్వీస్ విండో వర్తించదు, కాబట్టి 131047 తర్వాత యజమాని ఫోన్ నుండే ఆ కస్టమర్కు సమాధానం ఇవ్వగలడు, అదే సమయంలో మీ సిస్టమ్ ఆమోదించిన టెంప్లేట్ పంపుతుంది.
రెండవది, థ్రూపుట్ స్థిరంగా ఉంటుంది. ఒకేసారి యాప్లో మరియు APIలో ఉపయోగించే నంబర్ సెకనుకు గరిష్టంగా 20 మెసేజ్లు పంపుతుంది, అంతకు మించితే 130429 వస్తుంది. మిగతావన్నీ ఏ Cloud API నంబర్పై అయినా ఒకేలా కనిపిస్తాయి: అదే ఫీల్డ్, అదే errors అర్రే, అదే కోడ్లు.
ఆటోమేషన్లు మరియు మీ 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 నిర్దిష్ట కారణాన్ని కలిగి ఉంటుంది, కాబట్టి కోడ్ మరియు వివరాలు రెండింటినీ wamid తో కలిపి నిల్వ చేయండి.
- వెబ్హుక్ గమ్యస్థానం లేకుండా నడిపి, డెలివరీని పంపే ప్రతిస్పందన నుండి అంచనా వేయడం; అది కేవలం 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 రిఫరెన్స్ 'failed' ను పంపడంలో లేదా డెలివరీ చేయడంలో వైఫల్యంగా వివరిస్తుంది. మెసేజ్ పరికరానికి చేరిన తర్వాత మీరు ఆశించే తదుపరి స్టేటస్లు read, లేదా వాయిస్ మెసేజ్ల కోసం played.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండిధృవీకరించిన తేదీ