පුරනය වන්නනොමිලේ trial කාලය ආරම්භ කරන්න
Meta Tech Provider

WhatsApp පණිවිඩයක් අසාර්ථක වූයේ ඇයි: failed status සහ දෝෂ කියවීම

failed status webhook එක යනු ව්‍යාපාරය API හරහා යැවූ පණිවිඩයක් Meta ට යැවීමට හෝ බාරදීමට නොහැකි වූ බවයි. එය messages field එකේ status failed සමඟ පැමිණෙන අතර, code, title, message, error_data.details සහ href ඇති errors array එකක් ද ලැබේ. කේතය හේතුව කියයි: 131047 කාල සීමාව වසා ඇත, 131026 බාරදිය නොහැකි, 131049 marketing සීමාව, 131050 marketing නතර කර ඇත, 131042 ගෙවීම් ගැටලුවක්.

easyCoexistence ඔබේ WhatsApp Business යෙදුමේ අංකය Coexistence හරහා Meta ගේ Cloud API එකට සම්බන්ධ කර, failed status සෘජුව හෝ automations ක්‍රියාත්මක නම් අත්සන් කළ forwards ලෙස ඔබේ server එකට යවයි.

131047

ලබන්නා අවසන් වරට පිළිතුරු දුන් දා සිට පැය 24 ට වඩා ගත වී ඇත; Meta ගේ විසඳුම වන්නේ ඒ වෙනුවට template එකක් යැවීමයි.

131049

ecosystem engagement සෞඛ්‍ය සම්පන්නව තබා ගැනීමට බාරදී නැත; marketing template එක නැවත යැවීමට පෙර අවම වශයෙන් පැය 24ක් රැඳී සිටින්න.

131050

ලබන්නා ව්‍යාපාරයෙන් marketing පණිවිඩ නතර කිරීමට තෝරා ගෙන ඇත; Meta කියන්නේ නැවත උත්සාහ නොකරන ලෙසයි.

No contacts

failed status එකේ contacts array නැත, එබැවින් අසාර්ථකත්වය statuses.id හරහා සම්බන්ධ කරන්න.

Delivered

Meta අය කරන්නේ: පණිවිඩ බාරදුන් විට බිල් කෙරේ, යවන විට නොවේ.

failed status එකක් කෙසේ පෙනේද?

ඕනෑම status එකක් මෙන්, නමුත් errors ද සහිතව. contacts array නැත, පණිවිඩය phone number එකකට යැවූ විට recipient_user_id නැත, සහ pricing object නැත. title සහ message එකම පාඨය දරයි, error_data.details එය වාක්‍යයකින් පැහැදිලි කරයි, href Meta ගේ දෝෂ කේත ලැයිස්තුව වෙත යොමු කරයි. මෙය Meta ගේම උදාහරණයයි, පුද්ගලයා අනුව සීමාව නිසා නතර කළ marketing template එකක්:

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 status එකේ, හෝ දෙකෙහිම, එබැවින් එකම කේතය ඕනෑම ආකාරයකින් ඔබ වෙත පැමිණිය හැකිය, ඔබේ handler ස්ථාන දෙකම කියවිය යුතුය. පණිවිඩ කිසිදා නොපැමිණීමට බොහෝ හේතු වන මේ කේතවල 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.

එක් එක් වර්gයේ අසාර්ථකත්වයට handler එක කෙසේ ප්‍රතිචාර දැක්විය යුතුද?

නැවත උත්සාහ කිරීමට පෙර කේතය ඊළඟට කළ යුතු දේට වර්ග කරන්න. සියල්ල නැවත උත්සාහ කිරීම marketing ප්‍රතික්ෂේප කිරීමක් නැවත නැවත අසාර්ථක වීම් බවට පරිවර්තනය කර අවහිර කාලය දීර්ඝ කළ හැකිය, තාවකාලික දෝෂයක් අත්හැරීම විනාඩියකට පසු සාර්ථක වන්නට තිබූ පණිවිඩයක් නැති කරයි.

  • backoff සහිතව නැවත උත්සාහ කරන්න: 131000 නොදන්නා, 131016 සේවාව ලබා ගත නොහැකි, 130429 throughput සීමාවට ළඟා විය.
  • පළමුව රැඳී සිටින්න: 131049, අවම වශයෙන් පැය 24ක්, මන්ද කල් නොයා නැවත උත්සාහ කිරීම එම පරිශීලකයා පැය 24 ක් තවත් අවහිර කළ හැකිය.
  • පණිවිඩය මාරු කරන්න: 131047 අනුමත template එකක් අවශ්‍යයි, මන්ද පැය 24 කාල සීමාව වසා ඇත.
  • මෙම ගනුදෙනුකරු සඳහා නතර කරන්න: 131050, user_preferences resume එකක් පැමිණෙන තෙක්.
  • ගිණුම හෝ අන්තර්ගතය නිවැරදි කරන්න: 131042 ගෙවීම, 131031 ගිණුම සීමා කර ඇත, 131053 media.

failed status එකක් ලෙස පමණක් දිස්වන අසාර්ථකත්වයන් මොනවාද?

Meta විසින් ඉල්ලීම පිළිගැනීමෙන් පසු තීරණය කරන ඒවා. යැවීම wamid එකක් ලබා දෙන අතර, ප්‍රතික්ෂේපය පසුව මෙම webhook එකට පැමිණේ. Meta, එක්සත් ජනපද දුරකථන අංක (+1 සහ US area code) සහිත WhatsApp පරිශීලකයින්ට marketing templates බාරදීම නොකරයි; marketing පණිවිඩ නතර කළ ගනුදෙනුකරුවෙකුට marketing template එක සැකසී පසුව 131050 සමඟ failed ලෙස වාර්තා වේ, සහ පුද්ගලයා අනුව marketing සීමාව 131049 ලෙසම වාර්තා කරයි.

දුරකථන අංකයට webhook destination එකක් නොමැති නම්, මෙම අසාර්ථකත්වයන් ඔබට දැකිය හැකි කොතැනකවත් නොපැමිණෙන අතර, පණිවිඩය යවා ඇතැයි පෙනේ. ගනුදෙනුකරුවෙකුට කිසිවක් නොලැබුණු විට පරීක්ෂා කළ යුතු සම්පූර්ණ අනුපිළිවෙල සඳහා, WhatsApp API messages not delivered පිටුව බලන්න.

Coexistence අංකයක දී කුමක් වෙනස් වේද?

කරුණු දෙකක් වැදගත්ය. පළමුව, පැය 24 කාල සීමාව බැඳී ඇත්තේ API එකට පමණි. Meta ගේ Coexistence මාර්ගෝපදේශයට අනුව WhatsApp Business යෙදුමෙන් යවන පණිවිඩ customer service කාල සීමාවට යටත් නොවේ, එබැවින් 131047 සිදු වූ පසුවත් හිමිකරුට දුරකථනයෙන් එම ගනුදෙනුකරුට පිළිතුරු දිය හැකිය, ඔබේ පද්ධතිය අනුමත template එකක් යවන අතරතුර.

දෙවනුව, throughput ස්ථිරයි. යෙදුමෙන් සහ API එකෙන් එකවර භාවිත වන අංකයක් තත්පරයට උපරිම පණිවිඩ 20 ක් යවයි, ඊට වැඩි වුවහොත් 130429 ලැබේ. අනෙක් සියල්ල ඕනෑම Cloud API අංකයක් මෙන්ම කියවේ: එම field එක, එම errors array එක, එම කේත.

automations සහ ඔබේ AI අසාර්ථකත්වයක් දකින්නේ කෙසේද?

එය රඳා පවතින්නේ Meta නැත කියන වේලාව මත ය. යැවීමේ වේලාවේ ප්‍රතික්ෂේපයක්, උදාහරණයක් ලෙස 131047, automation හි පියවර Failed බවට පත් කරයි: run එක Runs tab එකේ Meta ගේ පණිවිඩය සමඟ පෙන්වන අතර, හිමිකරුට email එකක් ලැබේ, එවිට ඔහුට එම ගනුදෙනුකරුට තමාම පිළිතුරු දිය හැකිය. Automations ද නිදහස් පෙළ පිළිතුරක් යැවීමට පෙර කාල සීමාව පරීක්ෂා කර, උත්සාහ කිරීමට වෙනුවට window_closed සමඟ මඟ හරියි.

Meta පසුව වාර්තා කරන අසාර්ථකත්වයක් ඔබේ Forward URL එකට හෝ සෘජු destination එකට failed status එකක් ලෙස පැමිණෙන අතර, run එක තිබූ ආකාරයෙන්ම පවතී. MCP connector හරහා template එකක් යැවූ AI එකට wamid එක සහ "sent: true" පෙනේ; එම wamid එකේ status එක ඔබේ පද්ධතියෙන් විමසන්න, හෝ පණිවිඩ රාශියක් එකවර අසාර්ථක වන විට assistant ට get_number_health run කරන්න කියන්න.

සාමාන්‍ය වැරදි

  • 131050 ලූපයක නැවත උත්සාහ කිරීම. ගනුදෙනුකරු marketing පණිවිඩ නතර කර ඇත, එබැවින් ඔවුන් නැවත ආරම්භ කරන තෙක් සෑම උත්සාහයක්ම එකම ආකාරයෙන් අසාර්ථක වේ.
  • පැය කිහිපයක් ඇතුළත 131049 marketing template එක නැවත යැවීම. Meta අවම වශයෙන් පැය 24ක් ඉල්ලයි, සහ කල් නොයා නැවත උත්සාහ කිරීම එම පරිශීලකයා පැය 24ක් තවත් අවහිර කළ හැකිය.
  • title පමණක් ලොග් කිරීම. error_data.details නිශ්චිත හේතුව දරයි, එබැවින් කේතය සහ details එකට wamid සමඟ ගබඩා කරන්න.
  • webhook destination එකක් නොමැතිව ක්‍රියාත්මක වී, බාරදීම යැවීමේ ප්‍රතිචාරයෙන් විනිශ්චය කිරීම. එය කියන්නේ පමණක් Meta පණිවිඩය පිළිගත් බවයි.
EasyCoexistence සමඟ මෙය කිරීම

automation පිළිතුරක් යැවීමේ වේලාවේ ප්‍රතික්ෂේප වන විට, run එක Meta ගේ දෝෂය පෙන්වන අතර ඔබට email එකක් ලැබේ, සහ සෑම අංකයක්ම විසන්ධි වීම් සහ ගුණාත්මක පහත වැටීම් සඳහා 24/7 නිරීක්ෂණය කරයි. අංකයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, අංක එකතු කරන විට අඩු වෙමින්, පළමු දින 3ක නොමිලේ trial කාලය.

නිතර අසන ප්‍රශ්න

Meta, failed පණිවිඩයකට ගාස්තු අය කරනවාද?

Meta ගේ pricing පිටු පවසන්නේ ඔවුන් අය කරන්නේ බාරදුන් පණිවිඩ සඳහා ය, යවා පමණක් ඇති පණිවිඩ සඳහා නොවේ. failed status එකක pricing object එකක් නැත. ගාස්තු ව්‍යාපාරයේ තමන්ගේම WhatsApp Business Account එකට යයි; easyCoexistence කිසිවිට මිල ඉහළ නංවන්නේ නැත.

131026 යනු ගනුදෙනුකරු ව්‍යාපාරය අවහිර කළ බව අර්ථද?

131026 සඳහා Meta ගේ ලැයිස්තුව වෙනත් හේතු නම් කරයි: අංකය WhatsApp හි නොමැති වීම, ලබන්නා නවතම නියමයන් පිළිගෙන නොමැති වීම, හෝ ඔවුන්ගේ WhatsApp අනුවාදය ඉතා පැරණි වීම. ඒවා පරීක්ෂා කිරීමට වෙනත් නාලිකාවකින් ගනුදෙනුකරුගෙන් අසන ලෙස Meta යෝජනා කරයි.

recipient_user_id සමහර failures වල දිස්වන්නේ මන්ද, අනෙක් ඒවායේ නොවේද?

දුරකථන අංකයට යැවූ විට, Meta එය failed status එකෙන් ඉවත් කරයි. ගනුදෙනුකරුගේ BSUID වෙත යැවූ විට, අසාර්ථකත්වයේ එය ඇතුළත් වන අතර, recipient_id ඉවත් වී තිබිය හැකිය.

බාරදුන් පසු පණිවිඩයක් අසාර්ථක විය හැකිද?

Meta ගේ යොමු ලේඛනයට අනුව failed යනු යැවීම හෝ බාරදීම අසාර්ථක වීමයි. පණිවිඩයක් උපාංගයට ළඟා වූ පසු, ඔබට බලාපොරොත්තු විය හැකි ඊළඟ statuses වන්නේ read, හෝ හඬ පණිවිඩ සඳහා played වේ.

තවදුරටත් කියවන්න

WhatsApp webhook statuses: sent, delivered, read සහ failedWhatsApp ඔබ යැවූ පණිවිඩයට සිදු වූ දේ වාර්තා කරන ආකාරය: statuses array එක, status අගයන්, fields, wamid සහ Meta හි සත්‍ය payload.WhatsApp user_preferences webhook එක: පාරිභෝගිකයෙක් අලෙවිකරණ පණිවිඩ නවත්වන හෝ නැවත ආරම්භ කරන විටපාරිභෝගිකයෙක් අලෙවිකරණ පණිවිඩ නවත්වන හෝ නැවත ආරම්භ කළ විට WhatsApp user_preferences webhook එක ක්‍රියාත්මක වේ. payload එක සහ 131050 fallback ගැන.WhatsApp API පණිවිඩය නොලැබුණේ: හේතු, පිළිවෙලින්WhatsApp API පණිවිඩය නොලැබෙන හේතු: status webhook එක, පැය 24 කාල සීමාව, ගෙවීම, template එක, ලබන්නා සහ සීමා, හේතුව සොයා ගන්නා පිළිවෙලට.WhatsApp template එක විරාම කර හෝ අක්‍රිය කර ඇත: කළ යුතු දේඅඩු ගුණාත්මක WhatsApp template එකක් පැය 3කට, පසු පැය 6කට විරාම වී, අවසානයේ අක්‍රිය වේ. කළ යුතු දේ මෙන්න.WhatsApp දෝෂය 131049: පරිසර පද්ධතියේ health නිසා පණිවිඩය අවහිරයිදෝෂය 131049 යනු 24 පැය කවුළුව වැසුණු නිසා නොව, පරිසර පද්ධතියේ health රැකීමට Meta යැවීම අවහිර කළ බවයි. template එකකින් එය විසඳෙන්නේ නැත්තේ ඇයි.පැය 24ක පාරිභෝගික සේවා කවුළුවපාරිභෝගික සේවා කවුළුව විවෘත වන සහ වැසෙන වේලාව, යැවිය හැකි දේ සහ ඇතුළත ප්‍රතිචාර නොමිලේ වන්නේ ඇයි.

ආරම්භ කිරීමට සූදානම්ද?

WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්‍රියා කරයි.

නොමිලේ trial කාලය ආරම්භ කරන්න

සත්‍යාපනය කළේ