WhatsTool Business
Signup / LoginSupportBlog
  • Get started with WhatsTool Business
  • 📌WHATSTOOL BUSINESS
    • Create an account in WhatsTool Business.
    • How to connect your number to WhatsApp API ?
    • WhatsTool Business Demo - Complete Walkthrough
    • Quick Short Videos
  • 📖Meta Guide
    • Q&A Best Practices
      • 1. How to verify facebook business account ?
      • 2. How to see quality score ?
      • 3. How to apply for green tick ?
      • 4. How often phone number status changes ?
      • 5. What are the types of error code for failed message ?
      • 6. How to request review to enable the business manager account ?
      • 7. Template guidelines
      • 8. How to Edit display name and delete the Whatsapp API Number ?
      • 8. How to disable 2FA in the Meta
    • Frequently asked questions
    • Q&A Best Practices
  • 🈁CHATS
    • WhatsTool Business Chats Guide
    • Shared Inbox
    • Reply Box
    • Q&A Best Practices
      • 1. How to initiate a new chat ?
      • 2. How to send a template ?
      • 3. How to send a catalog product ?
      • 4. How to send a quick reply ?
      • 5. How to request payment ?
      • 6. How to add private note ?
      • 7. How to assign label, team member & status in chat ?
      • 8. How to send multiple media in chat ?
      • 9. How to assign labels, custom field & status in bulk ?
      • 10. How to use click to chat ?
    • Efficiently using Chats
  • 📕CONTACTS & CRM
    • WhatsTool Business Contacts guide
    • Features
      • Labels
      • Custom Field
      • Status
      • Quick Reply
    • Q&A Best Practices
      • 1. How to import CSV to add Contacts ?
      • 2. How to add contacts manually ?
      • 3. How to start campaign by selecting contacts ?
      • 4. How to edit the contacts ?
    • Efficiently using Contacts & CRM
    • Frequently asked questions
  • 📣CAMPAIGN
    • WhatsTool Business Campaign guide
    • Broadcasting the message
    • Campaign Analytics
    • Q&A Best Practices
      • 1. How to create a campaign ?
      • 2. How to schedule a campaign ?
      • 3. How to send session message in bulk ?
      • 4. How to retarget the customer using analytics ?
    • Efficiently using the Campaign
    • Frequently asked questions
  • 🤖BOTS
    • WhatsTool Business Bot guide
    • Ask Questions
      • Ask Email
      • Ask Text
      • Ask Date
      • Ask Number
      • Ask Address
      • Ask URL
      • Ask Location
      • Ask Phone
    • Bot Actions
      • Assign Conversation
      • Update Contact Fields
      • Unassign Conversations
      • Update Conversation Fields
    • Set up Default Bot
    • Q&A Best Practices
      • 1. How to create my customise bot message ?
      • 2. How to get the feedback using the bot and retrieve the data in Google sheet ?
    • Efficiently using the Automation
    • Frequently asked questions
  • 🛒COMMERCE
    • WhatsTool Business Commerce guide
    • Connect the Catalog with Meta
    • Q&A Best Practices
      • 1. How to connect my catalogs in WhatsApp API ?
      • 2. How to create a catalogue ?
      • 3. How to add product items to catalogue ?
    • Frequently Asked Questions
    • Efficiently using the Ecommerce
  • 📄TEMPLATES
    • WhatsTool Business Templates guide
    • Q&A Best Practices
      • 1. How to create a template ?
    • Efficiently using Templates
    • Frequently asked questions
  • 🛠️SETTINGS
    • WhatsApp API Number
      • 1. How to update the whatsapp profile ?
    • Manage Team
      • 2. How to add team member in WhatsTool Business ?
      • 3. How to assign team member in assignment rule ?
    • Media Gallery
  • 💰Pricing
    • WhatsApp Conversation Credit (WCC)
    • WhatsTool Platform Pricing
    • Team Member - Add-Ons
  • 🖇️App Integration
    • Google Sheet
    • Zoho CRM
    • Pabbly Integration
    • Razorpay
    • Page
    • Shopify
    • Facebook Ads
  • 👨‍💻API DOCS
  • Miscellaneous
    • WhatsApp Business API - Unsupported Messages
    • Commonly asked questions in support
Powered by GitBook
On this page

Was this helpful?

  1. Meta Guide
  2. Q&A Best Practices

5. What are the types of error code for failed message ?

Previous4. How often phone number status changes ?Next6. How to request review to enable the business manager account ?

Last updated 1 year ago

Was this helpful?

The Cloud API is built on the Graph API, so if you are unfamiliar with handling Graph API error responses, see Graph API's documentation.

In general, we recommend that you build your app's error handling logic around code values and details payload properties. These properties and their values are more indicative of the underlying error.

Code titles, which do not have a dedicated property in API error response payloads, are included as part of the message value. However, we recommend that you do not rely on titles for your error handling logic as titles will eventually be deprecated.

Types of Error Codes

Error Code
Description
Posssible Solutions

80007

Rate limit issues

The WhatsApp Business Account has reached its rate limit.

See WhatsApp Business Account . Try again later or reduce the frequency or amount of API queries the app is making.

131048

Spam rate limit hit

Message failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam.

Check your quality status in the WhatsApp Manager and see the documentation for more information.

131056

(Business Account, Consumer Account) pair rate limit hit

Too many messages sent from the sender phone number to the same recipient phone number in a short period of time.

Wait and retry the operation, if you intend to send messages to the same phone number. You can still send messages to a different phone number without waiting

368

Temporarily blocked for policies violations

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

See the document to learn about policy violations and how to resolve them.

131031

Account has been locked

The WhatsApp Business Account associated with the app 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).

See the document to learn about policy violations and how to resolve them.

You can also use the , which may provide additional insight into the reason or reasons for the account lock.

100

Invalid parameter

The request included one or more unsupported or misspelled parameters.

See the endpoint's to determine which parameters are supported and how they are spelled.

Ensure when setting the business public key, it is a .

Ensure there is no mismatch between the phone number id you are and a previously stored phone number id.

130472

User's number is part of an experiment

Message was not sent as part of an .

See .

131000

Something went wrong

Message failed to send due to an unknown error.

When , it either failed to calculate the signature, call the GraphQL endpoint, or the GraphQL endpoint returned an error.

Try again. If the error persists, open a ticket.

131026

Message Undeliverable

Unable to deliver message. Reasons can include:

  • The recipient phone number is not a WhatsApp phone number.

  • Sending an to a WhatsApp user who has a +91 country calling code (India). Authentication templates currently cannot be sent to WhatsApp users in India.

  • Recipient has not accepted our new Terms of Service and Privacy Policy.

  • Recipient using an old WhatsApp version; must use the following WhatsApp version or greater:

    • 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

  • The message was not delivered to create a high quality user experience. See .

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

  • Confirm that they can actually send a message to your WhatsApp business phone number.

  • Confirm that your WhatsApp business phone number is not in their list of blocked numbers (Settings > Privacy > Blocked or Blocked contacts).

  • Confirm that they have accepted our latest Terms of Service (Settings > Help, or Settings > Application information will prompt them to accept the latest terms/policies if they haven't done so already)

  • Update to the latest version of the WhatsApp client.

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 instead.

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. Please ensure you follow .

135000

Generic user error

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

See the endpoint's to determine if you are querying the endpoint using the correct syntax. Contact if you continue receiving this error code in response.

📖
error handling
Rate Limits
Quality-Based Rate Limits
Policy Enforcement
Policy Enforcement
Health Status API
reference
valid 2048-bit RSA public key in PEM format
registering
experiment
Marketing Message Experiment
setting a business public key
Direct Support
authentication template
Per-User Marketing Template Message Limits
message template
message template guidelines
reference
customer support