Skip to main content

Sending Active Messages Failed

  • Updated

Index

  1. What are sending failures?
  2. Where do I find sending failures?
  3. What do the errors presented in the report mean?

 

What are sending failures?

These are errors reported by Meta that prevented message delivery to contacts.

Where do I find sending failures?

To access the details, follow the steps below:

How to access:

Access the portal;

Then, choose the chatbot;

Next, go to the "Analysis" tab;

Within Analysis, click on the "Active Messages" menu.

At the end of the report, there is a specific section with the error details, titled "Sending Failures."


What do the errors shown in the report mean?

The possible errors will be detailed below:

Error Group Code Message Detail Possible Solutions
Authorization Errors 0 There was an authentication problem. This usually means that your access token has expired or is invalid. Try generating a new access token. Unable to authenticate the application user. Usually, this means that the included access token has expired, been invalidated, or the app user has changed a setting to prevent all apps from accessing their data. We recommend that you obtain a new access token.
Authorization Errors 3 Your application does not have permission to perform this action. Please check if the necessary permissions to send messages via WhatsApp are enabled for your application. Capacity or permissions issue. Use the access token debugger to check if your application has received the necessary permissions from the endpoint. Learn how to debug here.
Authorization Errors 10 Permission denied. The permission to perform this action was not granted or has been revoked. Please check your application's permission settings. The permission was not granted or has been revoked.

Use the access token debugger to check if your application has received the necessary permissions from the endpoint. If needed, refer to the information about authentication and authorization errors here.

The phone number used to set the company's public key must be on the permissions list.
Authorization Errors 190 Your access token has expired. You need to generate a new token to continue. Your access token has expired. Obtain a new access token.
Authorization Errors 200-299 API Permission Error. The required permission was not granted or has been revoked. Check your application's permissions. The permission was not granted or has been removed. Use the access token debugger to check if your application has received the necessary permissions from the endpoint. If needed, consult the information about authentication and authorization errors here.
Integrity Errors 368 Your account has been temporarily blocked for violating WhatsApp policies. Please review the platform policies to understand the reason and how to resolve it." The WhatsApp Business Account associated with the application has been restricted or disabled for violating a platform policy. Refer to the Policy Enforcement document to learn more about policy violations and how to resolve them.
Integrity Errors 130497 Your business account does not have permission to send messages to users in this country. Please refer to the allowed countries for your business category in Meta's policies. The WhatsApp Business Account is restricted from sending messages to users in certain countries. Check Meta's Policies here for details about the permission and restriction of sending messages to certain countries in your business category.
Integrity Errors 131031 The account was blocked due to a policy violation or data verification failure (such as an incorrect two-step PIN). Check WhatsApp policies and your account status for more details The WhatsApp Business Account associated with the application has been restricted or disabled for violating a platform policy, or we were unable to verify the data included in the request against the data set in the WhatsApp Business Account (for example, the two-step PIN included in the request is incorrect) Refer to the Policy Enforcement document to learn more about policy violations and how to resolve them. You can also check the Messaging Integrity Status document here for additional information about the reason for the account block.
Other errors 1 Unknown error. It could be a temporary issue with the WhatsApp server or an error in your request. Check the API status and verify that your request is correct. Invalid request or possible server error. Check the API status information here. If there are no server outages, review the endpoint reference and ensure your request is properly formatted and meets all endpoint requirements.
Other errors 2 API service unavailable. The service may be temporarily down or overloaded. Check the API status and try again later. Temporary due to downtime or overload. Check the API status information here before trying again.
Other errors 33 Your business phone number has been deleted or is invalid. Please check if the phone number provided is correct. The business phone number has been deleted. Please verify that the business phone number is correct.
Other errors 100 Invalid parameter. Your request contains parameters (submitted information) that are not supported or have typos. Check the documentation to correct possible errors. The request included one or more unsupported or misspelled parameters. Refer to the endpoint reference to determine which parameters are supported and how they are written. When setting the company’s public key, it must follow the instructions described here. Check for any mismatch between the phone number ID you are registering and a previously stored phone number ID. Ensure your parameter complies with the length restrictions for its type.
Other errors 130472 The user's number is part of an experiment. The message was not sent because the destination number is participating in a WhatsApp test. The message was not sent as part of an experiment. Refer to the Marketing Message Experiment.
Other errors 131000 Something went wrong. The message could not be sent due to an unknown error. Please try again. If the error persists, contact support. The message failed to be sent due to an unknown error. When setting a business public key, there was a failure in the signature calculation, in the GraphQL endpoint call, or the GraphQL endpoint returned an error. Please try again. If the error persists, open a ticket here.
Other errors 131005 Access denied. Your application does not have permission to perform this action. Check the granted permissions. The permission was not granted or has been removed. Use the access token debugger to check if your application has received the necessary permissions from the endpoint. Refer to the information about authentication and authorization errors here.
Other errors 131008 Missing required parameter. Your request did not include a necessary piece of information for sending. Check the documentation to identify what is missing. A required parameter is missing from the request. Refer to the endpoint reference to determine which parameters are required.
Other errors 131009 The value of a parameter is invalid. One or more pieces of information sent in your request are not valid. Check the documentation for the correct values. One or more parameter values are invalid. Refer to the endpoint reference to determine which values are supported for each parameter, and see Phone Numbers to learn how to add a phone number to a WhatsApp Business Account.
Other errors 131016 Service unavailable. A WhatsApp service is temporarily unavailable. Check the API status and try again later. A service is temporarily unavailable. Check the information about the API status here before trying again.
Other errors 131021

The recipient cannot be the sender. You are trying to send a message to the same number that is sending it Change the recipient's number.


 

 The sender's and recipient's phone numbers are the same. Send a message to a phone number different from the sender.
Other errors 131026 The message could not be delivered. This may happen because the recipient's number is not a WhatsApp number, they have not accepted the new terms of service, or they are using an outdated version of the app. Ask the user to check these points. The message could not be delivered. Possible reasons include: * The recipient's phone number is not a WhatsApp number. * The recipient has not accepted our new Terms of Service and Privacy Policy. * The recipient is using an old version of WhatsApp; they must use the following version or higher: + Android: 2.21.15.15 + SMBA: 2.21.15.15 + iOS: 2.21.170.4 + SMBI: 2.21.170.4 + KaiOS: 2.2130.10 + Web: 2.2132.6

Using a communication method other than WhatsApp, ask the WhatsApp user to:

Confirm that they can actually send a message to your company's phone number on WhatsApp.
 

Confirm that they have accepted our latest Terms of Service (Settings > Help or Settings > About will prompt them to accept the latest terms/policies if they haven't done so yet).
 

Update to the latest version of the WhatsApp client.
Other errors 131037 The display name of your test number (starting with 555) needs to be approved before you can send messages. Change the display name to an approved one. The business phone number 555 used to send the request does not have an approved display name. Change the display name of the business phone number 555. See our Help Center article (here) to learn how to make the change.
Other errors 131042 Payment issue. An error occurred with your payment method. Please check if your payment account is properly set up, active, and has no pending issues. There was an error related to your payment method.

Check the billing information here and verify if you have configured everything correctly. Common issues include:

The payment account is not attached to a WhatsApp Business Account

The credit line is over the limit

The credit line (Payment Account) is not set or active

The WhatsApp Business Account has been deleted

The WhatsApp Business Account is suspended

Time zone not set


 

Other errors


 

 131045 Incorrect certificate. Message sending failed due to a phone number registration error. Try registering the number again. The message sending failed due to a phone number registration error. Access the registration information here before trying again.

Other errors


 

 131047 Reengagement message. More than 24 hours have passed since the customer's last reply. To start a new conversation, you must use a message template. More than 24 hours have passed since the recipient last replied to the sender's number. Send the recipient a business-initiated message using a message template.
Other errors 131049 Meta (the company that owns WhatsApp) has chosen not to deliver this message to maintain service quality. Do not try again immediately. Meta understands that this message does not promote healthy engagement within the ecosystem. For this reason, it was not delivered. Do not retry immediately if you receive this error code. Instead, try waiting progressively longer intervals before sending the message again until it is delivered. The limit may be in effect for different periods of time. See more information about message template limits here.
Other errors 131050 The user has unsubscribed from marketing messages. The recipient has chosen not to receive marketing messages from your business anymore. Do not send new messages to this user. The message could not be delivered. This recipient has opted out of receiving marketing messages on WhatsApp from your business. Do not attempt to send messages to this user again. To receive notifications whenever a WhatsApp user requests to pause or resume the delivery of marketing message templates from your business, subscribe to the user_preferences webhook.
Other errors 131051 Unsupported message type. The type of message you are trying to send (for example, text, image, audio) is not supported. Check the allowed message types. Unsupported message type. Check the supported message types under Messages. After that, try again using a supported message type.
Other errors 131052 Media download error. The media file sent by the user could not be downloaded. Ask the user to send the file through another method. The media sent by the user could not be downloaded. The media included in the WhatsApp user's message could not be downloaded. For more information, check the error.error_data.details value in any messages webhooks triggered when this message was received. Ask the WhatsApp user to send the media file using a method other than WhatsApp.
Other errors 131053 Media upload error. The media file could not be uploaded. Check if the file format (for example, JPG, PNG, MP4) is supported. The media used in the message could not be uploaded. The media upload failed for one or more reasons, such as an unsupported media type. For more information, check the error.error_data.details value in any messages webhooks triggered when this message failed to send. We recommend reviewing the media files causing errors and confirming that they are indeed supported. On UNIX, for example, you can use the command line file -I rejected-file.mov to determine the MIME type. You can then confirm whether the MIME type is supported. See the WhatsApp Cloud API documentation here.
Other errors 131057 Account in maintenance mode. Your WhatsApp Business account is under maintenance, such as a productivity capacity upgrade. Please try again later. The Business Account is in maintenance mode. The WhatsApp Business Account is in maintenance mode. One possible reason is that the account is undergoing a data throughput rate upgrade.
Other errors 132000 Parameter count mismatch in the template. The number of variables in your message template does not match what was sent You must fill in all the variable fields of your template. The number of variable parameter values included in the request did not match the number of variable parameters defined in the template. Check the Message Template Guidelines here and ensure that the request includes all variable parameter values defined in the template.
Other errors 132001 The template does not exist. Verify that the template name and language are correct and that it has been approved by WhatsApp. The template does not exist in the specified language or the template has not been approved. Verify that the template has been approved and that the template name and language locale are correct. You must follow the message template guidelines.
Other errors 132005 Hydrated template text too long. The translated text of your message template is too long. Check your template translations in the WhatsApp Manager. The translated text is too long. Check the WhatsApp Manager to verify if your template has been translated. You must follow the message template guidelines here.
Other errors 132007 The content of your message template violates a WhatsApp policy. Check the guidelines to understand the reason for the violation. The template content violates a WhatsApp policy. Refer to the message template guidelines here to determine the possible reasons for the violation. 
Other errors 132012 Template parameter format mismatch. The format of the variables in your message template is incorrect. Verify that the format of the information you are sending matches what was defined in the template. Variable parameter values are incorrectly formatted. The variable parameter values included in the request are not using the format specified in the template. Check the message template guidelines here.
Other errors 132015 The template is paused due to low quality and cannot be sent. Edit the template to improve its quality and try again after approval. The template is paused due to [low quality](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines#quality-rating),Therefore, it cannot be sent as a template message. [Edit the template] Follow the guidelines to improve the quality of the template and try again once it is approved.
Other errors 132016 The template was permanently disabled after being paused many times due to low quality. Create a new template with different content. The template was paused many times due to [low quality](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines#quality-rating) and is now permanently disabled. Create a new template with different content.
Other errors 132068 The flow is blocked. Fix the flow to continue. The flow is in a blocked state. Fix the flow
Other errors 132069 The flow is limited. 10 messages have already been sent using this flow in the last hour. Fix the flow. The flow is in a limited state, and 10 messages using this flow have already been sent in the last hour. Fix the flow
Other errors 133000 Incomplete deregistration. A previous attempt to deregister the number failed. Try deregistering again before registering. A previous deregistration attempt failed.

Follow the steps below before registering:

Link 01

Link 02
Other errors 133004 Server temporarily unavailable. Check the WhatsApp API status page and try again. The server is temporarily unavailable. Check the information on the WhatsApp Business API status page here and verify the details value in the response before trying again. 
Other errors 133005 The two-step verification PIN is incorrect. Verify that the PIN is correct or reset it. Two-step verification PIN incorrect.

Verify that the two-step verification PIN included in the request is correct. To reset the two-step verification PIN:

  1. Follow the steps described here and here.
     
  2. Send a POST request including the new PIN to the [Phone Number] endpoint. Details here.
Other errors 133006 New phone number verification required. Verify the phone number before attempting to register it. The phone number needs to be verified before registration. Verify the phone number before registering it.
Other errors 133008 Too many attempts to guess the two-step verification PIN. Please wait the specified time and try again. Too many attempts to guess the two-step verification PIN for this phone number. Try again after the time specified in the details value of the response.
Other errors 133009 The two-step verification PIN was guessed too quickly. Check the response to see when you can try again. The two-step verification PIN was entered too quickly. Check the details value in the response before trying again.
Other errors 133010 The phone number is not registered. Register the phone number on the WhatsApp Business Platform before trying again. Phone number not registered on the WhatsApp Business Platform.

Check the following links before trying again:

Link 01

Link 02.
Other errors 133015 Wait a few minutes before registering this number. The number was recently deleted and the process was not completed. Wait 5 minutes and try again. The phone number you are trying to register was recently deleted and the deletion has not yet been completed. Wait 5 minutes before trying the request again.
Other errors 135000 Generic user error. The message sending failed due to an unknown error in the parameters of your request. Check the syntax of your request or contact support. The message sending failed due to an unknown error with the parameters of your request. Refer to the endpoint reference to determine if you are querying the endpoint using the correct syntax. Contact customer support if you continue to receive this error code in response.
Synchronization errors 2593107 Synchronization request limit exceeded. You can only sync contacts and message history once. Undo the integration and then redo the client integration to try again. You have exceeded the maximum number of times to call the synchronization API for this phone number.. You can only call this endpoint once to synchronize the business phone number's contacts and once to synchronize its message history. Please refer to Business App User Integration. Unlink the business client and then link it again.
Synchronization errors 2593108 Synchronization request made outside the allowed time window. Synchronization can only be performed within 24 hours after the user integration. Unlink the user integration and then link the user again to try again. The synchronization request can only be made within 24 hours after the integration. You can only initiate synchronization of contacts and message history for a WhatsApp Business app user within 24 hours after the user integration. Please refer to Business App User Integration. Unlink the user integration and then link it again.

For more information, visit the discussion about this topic in our community or the videos on our channel. 😃

Related articles