Error Glossary
WhatsApp Error Message
Error Message | Meaning | Possible Cause | Recommended Action | Troubleshooting |
"This message is not available"
| The message cannot be retrieved or displayed. | - Message expired or deleted- Delay in sync or message loading | - Refresh the chat window- Wait briefly and check again- Note: Older messages may not be recoverable if past retention period | |
The system failed to register a button or poll response. | - Recipient did not submit a response- Button or poll expired or removed | - Ask the recipient to respond again- Reissue the button/poll if needed | ||
Bulk Images with text could not be sent simultaneously | Bulk images with compiled and sent | - Re-upload using a smaller file- Convert the file to a supported format (.mp4, .mov, .avi) | ||
Bulk images could not be sent simultaneously | Bulk images compiled and sent | Reupload image and send. | ||
a WhatsApp message template includes placeholders (like {{1}}) improperly | A marketing template message cannot be recognized by ChatDaddy | |||
A message is being pinned by recipient | A trigger happen when recipient pin a message and ChatDaddy tracks the event. | A fix is required to ensure event | ||
A Video note send as message | Unsupported format | It will be included as feature request to have this available in the near future. |
Meta ( Facebook ) Error messages
Authorization Errors
Error Code | Meaning | Possible Cause | Recommended Action |
401 (0) | Unauthorized – Token expired | The access token used has expired and can no longer be used to authenticate requests. | Get a new access token. |
401 (190) | Unauthorized – Token invalidated/revoked | The access token has been invalidated, or the app user has revoked app access via settings. | Get a new access token. |
403 (10) | Forbidden – Permission denied | The app does not have the necessary permissions, or permissions have been removed. | Use the Access Token Debugger to verify app permissions. |
403 (200-299) | Forbidden – Number not allowlisted | The phone number used to set the business public key is not allowlisted. | Ensure the phone number is allowlisted and tied to your business settings. |
404 | Recipient not on WhatsApp | - Phone number is not registered with WhatsApp | - Verify the contact number- Ensure the recipient is using WhatsApp |
500 | Internal Server Error | A capability or permission issue occurred on the server side. | Use the Access Token Debugger to verify your app has the required permissions. See Troubleshooting. |
551 | Recipient not available | - User has blocked the number- User account may be inactive | - Confirm recipient status- Attempt to reach via another method |
Integrity Errors
Error Code | Meaning | Possible Cause | Recommended Action |
403 (368) | Temporarily blocked for policy violations | The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy. | Refer to the Policy Enforcement documentation to understand and resolve the violation. |
403 (130497) | Business account is restricted from messaging users in this country | The WhatsApp Business Account is restricted from messaging users in certain countries. | Refer to the WhatsApp Business Messaging Policy to check allowed countries for your business category. |
403 (131031) | Account has been locked | The account has been restricted due to policy violation or because the request data (e.g., two-step PIN) could not be verified against the WhatsApp Business Account. | Review the Policy Enforcement documentation and use the Health Status API for details. |
Other Errors
Error Code | Meaning | Possible Cause | Recommended Action |
400 (1) | API Unknown | Invalid request or possible server error. | Check the WhatsApp Business Platform Status page and verify your request format. |
400 (33) | Parameter value is not valid | The business phone number has been deleted. | Verify that the business phone number is correct. |
400 (100) | Invalid parameter | Unsupported or misspelled parameters, invalid public key, or mismatched phone ID. | Check parameter spelling and requirements. Verify public key and phone ID. |
400 (130472) | User's number is part of experiment | Message was not sent due to experimental restrictions. | Refer to Marketing Message Experiment documentation. |
400 (131008) | Required parameter is missing | A required parameter is missing in the request. | Refer to endpoint documentation for required parameters. |
400 (131009) | Parameter value is not valid | One or more parameter values are invalid. | Refer to endpoint docs and confirm values. |
400 (131021) | Recipient cannot be sender | Sender and recipient phone number are the same. | Use a different recipient number. |
400 (131026) | Message Undeliverable | Recipient issues (not on WhatsApp, outdated app, terms not accepted). | Ask recipient to accept T&Cs, update WhatsApp, or verify delivery settings. |
400 (131037) | Display name approval needed | Display name not approved for business phone number. | Submit an approved display name per WhatsApp guidelines. |
400 (131042) | Business eligibility payment issue | Payment account issues, WABA not linked, or credit problems. | Ensure billing account is active, with currency and timezone set. |
400 (131047) | Re-engagement message | 24-hour reply window expired. | Use a pre-approved message template for re-engagement. |
400 (131049) | Meta chose not to deliver | Meta prevented delivery to maintain healthy engagement. | Wait and retry using exponential backoff. Review messaging limits. |
400 (131050) | User opted out of marketing messages | User has opted out of receiving marketing messages. | Do not retry. Subscribe to user_preferences webhook for updates. |
400 (131051) | Unsupported message type | Message type is not supported by WhatsApp. | Refer to supported message types in documentation. |
400 (131052) | Media download error | Media could not be downloaded from WhatsApp message. | Ask user to resend media via another method. |
400 (131053) | Media upload error | Media file type is unsupported or upload failed. | Inspect MIME type and confirm support. See supported media types. |
400 (132000) | Template Param Count Mismatch | Variable count in template doesn't match values sent. | Match the number of variables with the template design. |
400 (132005) | Template Hydrated Text Too Long | Translated template text is too long. | Check template translation in WhatsApp Manager. |
400 (132007) | Template Format Character Violation | Template content violates a WhatsApp policy. | Review message template rejection reasons. |
400 (132012) | Template Parameter Format Mismatch | Variable formatting doesn't match the template. | Ensure values follow required formatting. |
400 (132015) | Template is Paused | Template has low quality and is paused. | Edit and improve the template, then resubmit for approval. |
400 (132016) | Template is Disabled | Repeated poor quality led to template deactivation. | Create a new, higher-quality template. |
400 (132068) | Flow is blocked | Flow is currently blocked. | Correct or reconfigure the Flow. |
400 (132069) | Flow is throttled | Message limit reached for the Flow. | Reduce usage or wait before retrying. |
400 (133005) | Two-step PIN mismatch | Incorrect two-step verification PIN. | Reset the two-step verification PIN and resend request. |
400 (133006) | Re-verification needed | Phone number must be verified before registration. | Verify the phone number before proceeding. |
400 (133008) | Too many PIN guesses | Excessive incorrect attempts. | Wait as instructed in the error response. |
400 (133009) | PIN guesses too fast | PINs were guessed too quickly. | Delay and try again. |
400 (133010) | Phone not registered | The number isn't yet registered with WhatsApp Business Platform. | Register the phone number. |
400 (133015) | Wait before re-registering | Number was recently deleted and is not ready to re-register. | Wait 5 minutes before retrying. |
400 (134011) | Payments TOS not accepted | Payments terms of service not accepted. | Accept the terms using the link in the error message. |
400 (135000) | Generic user error | Unknown parameter error. | Double-check endpoint usage and syntax. Contact support if issue persists. |
403 (131005) | Access Denied | Permissions missing or revoked. | Use token debugger to verify granted permissions. |
404 (132001) | Template not found | Template not approved or not available in specified language. | Ensure correct name, locale, and approval. |
500 (131000) | Something went wrong | Unknown send error, signature, or GraphQL issue. | Retry. If persistent, open a Direct Support ticket. |
500 (131016) | Service unavailable | A backend service is temporarily unavailable. | Check platform status and retry. |
500 (131045) | Incorrect certificate | Registration-related certificate error. | Register the phone number again. |
500 (131057) | Account in maintenance | Account is undergoing upgrades or maintenance. | Wait until maintenance completes. |
500 (133000) | Incomplete deregistration | Prior deregistration failed. | Retry deregistration before registering. |
503 (2) | API Service | Temporary downtime or service overloaded. | Check platform status and try again later. |
503 (133004) | Server temporarily unavailable | Server is down or overloaded. | Check status and response details before retrying. |
Error Code | Meaning | Possible Cause | Recommended Action |
400 (4) | API Too Many Calls | The app has reached its API call rate limit. | Check the App Dashboard > Application Rate Limit. Retry later or reduce the frequency of API requests. |
400 (80007) | Rate limit issues | The WhatsApp Business Account has reached its rate limit. | See WhatsApp Business Account Rate Limits. Retry later or reduce API query frequency. |
400 (130429) | Rate limit hit | Cloud API message throughput has been reached. | See Throughput documentation. Retry later or slow down message sending rate. |
400 (131048) | Spam rate limit hit | Too many messages were blocked or flagged as spam, triggering restrictions on sending messages. | Check the quality rating in WhatsApp Manager. Review Quality-Based Rate Limits. |
400 (131056) | (Business, Consumer) pair limit hit | Too many messages sent from one business phone number to the same user in a short time. | Wait before retrying to the same number. You may continue sending to other numbers. |
400 (133016) | Register/Deregister rate limit hit | Too many registration/deregistration attempts for the same phone number in a short time. | Wait until the number is unblocked before retrying. See “Limitations” in Registration documentation. |
Did this answer your question?
😞
😐
🤩