WhatsApp Cloud API දෝෂ කේත
අප ලේඛනගත කරන සියලු WhatsApp Cloud API දෝෂ කේත මෙහි එක වගුවක ඇත. එක් එක් දෝෂයේ අර්ථය සහ නැවත උත්සාහ කිරීමෙන් ප්‍රතිඵලයක් ලැබේද යන්නද ඇතුළත්ය. බොහෝ දෝෂ එසේ නොවේ, ඒවා නිශ්චිත බැවින් එකම request එක එකම ආකාරයෙන් අසාර්ථක වේ. එවිට නැවත උත්සාහ කිරීමේ loop එකක් දෝෂ සහිත request එකක් rate limit එකක් බවට පත් කරයි.
Request
| Code | What it means | Retry |
|---|---|---|
| 100 | A parameter is unsupported, misspelled or malformed. | No |
| 131008 | A required parameter was not included at all. | No |
| 131009 | A parameter is present with a value the endpoint rejects. | No |
| 131021 | Sender and recipient are the same number. | No |
| 131051 | The message type is not supported, often a Coexistence limit. | No |
| 131052 | Meta could not download media a customer sent. | No |
| 131053 | Meta could not upload media you sent. Size, format or reach. | No |
Template
| Code | What it means | Retry |
|---|---|---|
| 132000 | The number of parameters does not match the template. | No |
| 132001 | No template exists with that name and language pair. | No |
| 132007 | The template breaks messaging policy. Rewrite and resubmit. | No |
| 132012 | Parameter format does not match what the template defines. | No |
| 132015 | The template is paused after a quality decline. Temporary. | Wait |
| 132016 | The template is permanently disabled. It will not come back. | No |
Window and recipient
Registration and PIN
| Code | What it means | Retry |
|---|---|---|
| 131045 | The number was never registered for Cloud API messaging. | No |
| 133010 | The number is not registered. Registration must be completed. | No |
| 133006 | The number must be verified before it can be registered. | No |
| 133005 | The two-step verification PIN was wrong. Stop guessing. | No |
| 133008 | Too many PIN attempts. Registration is locked for a period. | Wait |
Access and account
| Code | What it means | Retry |
|---|---|---|
| 190 | The access token expired or was invalidated. | No |
| 368 | The account is restricted after a policy violation. | No |
| 131031 | The account is restricted, or its data does not match Meta's. | No |
| 131042 | A payment problem on the business account blocks sending. | No |
| 131049 | Meta blocked the message to protect ecosystem health. | No |
Rate limits
Transient
Coexistence sync
නැවත උත්සාහ තීරුව කියවන්නේ කෙසේද
එහි අගයන් තුනක් ඇත. ඒවා අතර වැරදි තේරීම මෙම සම්පූර්ණ යොමුවේ මිල අධිකම වැරැද්දයි.
නැත යන්නෙන් අදහස් වන්නේ අසාර්ථකත්වය නිශ්චිත බවයි. අසාර්ථක වූයේ request එක, template එක හෝ ලබන්නාගේ තත්ත්වයයි. එකම request එක නැවත යැවීමෙන් එකම දෝෂය ලැබෙන අතර පසුව ඔබට අවශ්‍ය වන throughput එකද වැය වේ. ඔව් යන්නෙන් අසාර්ථකත්වය Meta පාර්ශ්වයෙන් වූ බවත් backoff එකකින් එය සැබෑවටම විසඳෙන බවත් අදහස් වේ. රැඳී සිටින්න යන්නෙන් තත්ත්වය සැබෑ නමුත් තාවකාලික බව අදහස් වේ. එය සීමාවක් හෝ තනිව ඉවත් වන lock එකක් විය හැක. එය ඉවත් වීමට පෙර නැවත උත්සාහ කිරීමෙන් කිසිවක් සිදු නොවන අතර කාලය තවත් දිගු විය හැක.
මේවායින් බොහොමයක් නැවත උත්සාහ කළ නොහැක්කේ ඇයි
platform එක සාමාන්‍ය දෝෂ වෙනුවට නිශ්චිත කේත ලබා දෙන බැවිනි. වැරදි parameter එකක්, නොපවතින template එකක්, වසා ඇති messaging window එකක් සහ අවසර ඉවත් කළ ලබන්නෙකු response එක ලැබෙන මොහොතේම හඳුනාගත හැක. එබැවින් Meta ඒවා අපැහැදිලි ලෙස අසාර්ථක නොකර නම් කරයි.
- request එකක ගැටලුවක් දෙවන උත්සාහයෙන් නිවැරදි නොවේ.
- template එකේ ගැටලුව template එක තුළම ඇත. request එකට එය වෙනස් කළ නොහැක.
- window එකක හෝ අවසර ඉවත් කිරීමක ගැටලුව ඔබේ තත්ත්වය නොව ලබන්නාගේ තත්ත්වය ගැනයි.
- ගිණුම් සීමාවක් යනු තීරණයකි. නැවත උත්සාහ කිරීම අභියාචනයක් නොවේ.
මේවායින් එකක් ලැබුණු විට ලොග් කළ යුත්තේ කුමක්ද
එය නැවත නිර්මාණය නොකර හඳුනාගැනීමට ප්‍රමාණවත් තොරතුරු ලොග් කරන්න. එය මිනිත්තු පහක විසඳුමක් සහ දවසක් පුරා අනුමාන කිරීම අතර වෙනසයි.
- trace id එක ඇතුළුව සම්පූර්ණ දෝෂ ප්‍රතිචාරය ලොග් කරන්න. Meta සහාය ඉල්ලා සිටින්නේ එයයි.
- යැවූ ආකාරයේ request body එක ලොග් කරන්න, අදහස් කළ ආකාරයේ නොවේ. මේ දෙක අතර පරතරය සාමාන්යයෙන් දෝෂයයි.
- phone number id එක ලොග් කරන්න. එවිට එක් අංකයක ගැටලුවක් මුළු ගිණුමේ ගැටලුවකින් වෙන්කර හඳුනාගත හැක.
- timestamp එක ලොග් කරන්න. එවිට එම මොහොතේ සම්බන්ධතාවයේ තත්ත්වය සමඟ අසාර්ථකත්වය පරීක්ෂා කළ හැක.
Coexistence මත පමණක් පවතින කේත
ඒවා දෙකකි. සාමාන්‍ය යැවීමේ අසාර්ථකත්වයන් මෙන් පෙනෙන නිසා ඒවා මිනිසුන්ට ව්‍යාකූල වේ. 2593107 සහ 2593108 යන දෙකම chat history synchronisation ගැනයි. අංකයක් පළමු වරට සම්බන්ධ කළ විට WhatsApp Business app එකෙන් මෑත සංවාද පිටපත් කරන පියවර මෙයයි.
ඒවා messaging දෝෂ නොවන අතර සම්බන්ධතාවය අසාර්ථක වූ බවක්ද අදහස් නොකරයි. sync එකක් එහි සීමාව ඉක්මවා ගියහොත් හෝ window එකෙන් පිටත ක්‍රියා කළහොත් අංකය සම්බන්ධවම පවතින අතර සාමාන්යයෙන් යැවීම සිදු කරයි. බලාපොරොත්තු වූවාට වඩා අඩු ඉතිහාසයක් පමණක් පිටපත් වේ. ඒවා කැඩුණු සම්බන්ධතාවයක් ලෙස කියවා disconnect කර නැවත ආරම්භ කිරීමෙන් නැති වන ඉතිහාසය තවත් වැඩි වේ, එය නැවත ලබා නොදේ.
නිතර අසන ප්‍රශ්න
මා නැවත උත්සාහ කළ යුත්තේ කුමන දෝෂද?
131016 සහ 131000 සඳහා exponential backoff සමඟ නැවත උත්සාහ කරන්න. 130429, 132015 සහ 133008 රැඳී සිටියහොත් ස්වයංක්‍රීයව ඉවත් වේ. අනෙක් සියල්ල නිශ්චිතය.
දෝෂ කේතයකින් මගේ අංකය විසන්ධි වී ඇති බව අදහස් වේද?
සාමාන්යයෙන් නැත. මේවායින් බොහොමයක් request එක, template එක හෝ ලබන්නා ගැනයි. සම්බන්ධතා ගැටලු යැවීමේ දෝෂ ලෙස නොව ගිණුම් සහ ගුණාත්මක webhook ලෙස පෙනේ.
trace id එකක් යනු කුමක්ද?
නිශ්චිත request එක සොයාගැනීමට Meta සහායට ඉඩ දෙන දෝෂ ප්රතිචාරයේ identifier එකකි. සෑම අසාර්ථකත්වයකදීම එය ලොග් කරන්න. එය නොමැතිව සහාය ඉල්ලීම ක්රියාත්මක කළ නොහැක.
සෑම provider එකකම මේ කේත එකමද?
ඔව්. ඒවා Meta හි Cloud API වෙතින් ලැබෙන බැවින් අංකය සම්බන්ධ කළ provider එක කුමක් වුවත් එකමය. provider එකකට වෙනස් කළ හැක්කේ ඒවා ඔබ වෙත කොතරම් පැහැදිලිව ළඟා කරන්නේද යන්න පමණි.
ආරම්භ කිරීමට සූදානම්ද?
WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්‍රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නදින 7ක් කිසිදු ගාස්තුවක් නැත. ඕනෑම වේලාවක අවලංගු කරන්න.