Action

Procedure

Verify WhatsApp connection

Check if WhatsApp is connected in Dotdigital. Learn how.

Check phone number connection and messaging limit

Ensure the phone number is connected to a WhatsApp account and has the correct messaging limit:

Go to Meta > Business Portfolio > WhatsApp Manager > Phone Numbers. If the status is "Connected," everything is fine.

Additionally, verify the current messaging limit.

Ensure templates are active

Only active templates can be used for sending messages.

Check the status of templates in Meta > Business Portfolio > WhatsApp Manager > Manage Templates.

Verify variable replacement

Meta doesn’t deliver messages with unreplaced variables. Ensure that all variables, such as images, text, links, are entered and that dynamic content exists for the contact.

For example, if the @FIRSTNAME@ field is empty for a contact, the message is not delivered.

Code

Description

Possible Solutions

130497

Business account is restricted from messaging users in this country.

The WhatsApp Business Account is restricted from messaging to users in certain countries.

For details on the allowed countries for messaging in your business category, see WhatsApp Business Messaging Policy.

131031

Account has been locked

The WhatsApp Business Account has been restricted or disabled for violating a platform policy, or we were unable to verify data included in the request against data set on the WhatsApp Business Account (e.g, the two-step pin included in the request is incorrect).

Learn about policy violations and how to resolve them in Policy Enforcement.

368

Temporarily blocked for policies violations

The WhatsApp Business Account associated with the app has been restricted or disabled for violating a platform policy.

Learn about policy violations and how to resolve them in Policy Enforcement.

1

API Unknown

Invalid request or possible server error.

Check the WhatsApp Business Platform Status page to see API status information.

2

API Service

Temporary due to downtime or due to being overloaded.

Check the WhatsApp Business Platform Status page to see API status information before trying again.

33

Parameter value is not valid

The business phone number has been deleted.

Verify that the business phone number is correct.

100

Invalid parameter

The request included one or more unsupported parameters.

Dotdigital accepts only “number variables”.

Meta doesn’t deliver messages with unreplaced variables. Ensure that all variables, such as images, text, links, are entered and that dynamic content exists for the contact.

For example, if the @FIRSTNAME@ field is empty for a contact, the message is not delivered.

130472

User's number is part of an experiment

Message was not sent as part of an experiment.

Learn more in Marketing Message Experiment.

131000

Something went wrong

Message failed to send due to an unknown error.

Try again. If the error persists, contact support.

131008

Required parameter is missing

The request is missing a required parameter.

If you send WhatsApp using the API, ensure that all parameters are included. Learn more in our API docs: WhatsApp.

131016

Service unavailable

A service is temporarily unavailable.

Check the WhatsApp Business Platform Status page to see API status information before trying again.

131021

Recipient cannot be sender

Sender and recipient phone number is the same.

Send a message to a phone number different from the sender.

131026

Message Undeliverable

Unable to deliver message. Reasons can include:

Using a non-WhatsApp communication method, ask the WhatsApp user to:

131037

WhatsApp provided number needs display name approval before message can be sent.

The 555 business phone number used to send the request does not have an approved display name.

Change the 555 business phone number's display name. Learn how in How to change your WhatsApp Business display name.

131042

Business eligibility payment issue

There was an error related to your payment method.

If this error occurs, open a support ticket with Dotdigital team.

Learn more in About Billing For Your WhatsApp Business Account and verify that you have set up billing correctly.

Common problems:

131047

Re-engagement message

More than 24 hours have passed since the recipient last replied to the sender number.

Send the recipient a business-initiated message using a message template instead.

131049

Meta chose not to deliver.

This message was not delivered to maintain healthy ecosystem engagement.

Do not retry immediately if you do receive this error code and suspect it is due to the limit. Instead, retry in increasing larger time increments until the message is delivered, since the limit may be in effect for differing periods of time.

Learn more in Per-User Marketing Template Message Limits.

131050

User has stopped reciept of marketing messages.

Unable to deliver the message. This recipient has chosen to stop receiving marketing messages on WhatsApp from your business.

Do not retry sending messages to this user as they will not be received.

131051

Unsupported message type

Unsupported message type.

Ensure you replaced all variables.

131053

Media upload error

Unable to upload the media used in the message.

We were unable to upload the media for one or more reasons, such as an unsupported media type.

Learn more in Supported Media Types.

131057

Account in maintenance mode

Buiness Account is in maintenance mode

The WhatsApp Business Account is in maintenance mode. One reason for this could be that the account is undergoing a throughput upgrade.

132000

Template Param Count Mismatch

The number of variable parameter values included in the request did not match the number of variable parameters defined in the template.

The template can’t have multiple same variables, such as {{1}}, {{2}}, {{1}} (in Dotdigital Editor it will be translated as {{1}}, {{2}}, {{3}} hence the message will fail).

Make sure the request includes all of the variable parameter values that have been defined in the template.

132001

Template does not exist

The template does not exist in the specified language or the template has not been approved.

Make sure your template has been approved and the template name and language locale are correct.

Learn how in message template guidelines.

132007

Template Format Character Policy Violated

Template content violates a WhatsApp policy.

Determine possible reasons for violation in Rejection Reasons.

132012

Template Parameter Format Mismatch

Variable parameter values formatted incorrectly.

The variable parameter values included in the request are not using the format specified in the template. Learn more in Message Template Guidelines.

132015

Template is Paused

Template is paused due to low quality so it cannot be sent in a template message.

Edit the template to improve its quality and try again once it is approved.

132016

Template is Disabled

Template has been paused too many times due to low quality and is now permanently disabled.

Create a new template with different content.

133004

Server Temporarily Unavailable

Server is temporarily unavailable.

Check the WhatsApp Business Platform Status page to see API status information.

133010

Phone number Not Registered

Phone number not registered on the WhatsApp Business Platform.

Cancel integration and create new WhatsApp account.

135000

Generic user error

Message failed to send because of an unknown error with your request parameters.

Contact Dotdigital support team.