Articles on: Troubleshooting

Messages Getting Failed? Read this!

Last updated: 5th Nov, 2024


If you’re not able to send messages or your messages are getting Failed, there can be multiple reasons for that. In this article, we’ll go through some of the common reasons why the messages might not be getting sent from your account.


Step 1 - Find the error


If your Notifications are getting failed, the first thing to do is check Delivery Status Report of your Notification on the Analytics page.


  1. Visit the Analytics > Notifications page.
  2. Select your Notification from the dropdown on top. You can also reach this page from the Notifications page by clicking on the bar graph icon in front of your Notification.
  3. Scroll down to the Delivery Report section where you will see the messages with Failed status. You'll find the reason for the failed message under the "Info" column.


Once you've found the exact error, it's time to fix it.


Step 2 - Fix the error


Following are some of the common errors that you’ll find in the delivery report. We've provided the exact solution on how to resolve them.


Error Message 1 – Message not sent. Parameter of type text is missing text value


This error usually happen when you’re using a message template with variables like {{1}}, {{2}}, {{3}} and so on and one or all of these variables are getting empty value when the notification is triggered. Make sure you are sending value for every variable from your website / app.


If you do not have control over the values, you can set Fallback value for each of these variables on the Notification page so that when an empty value comes, it can use the Fallback value.


Error Message 2 – ERROR: Message not sent. Recipient phone number not in allowed list: Add recipient phone number to recipient list and try again.


This error happens when you setup Phone Number ID and WhatsApp Business Account ID of a test phone number provided by WhatsApp, instead of setting up credentials of your own phone number. When using test number credentials you can only send messages to the recipient phone numbers that you add add to Meta portal and not to any other phone numbers.


The solution for this is to either add your own phone number and use that number’s API credentials or add a few recipient numbers if you only want to do test. Click here to read more about Test Number limitations.


Error Message 3 – ERROR: Message Undeliverable


This error happens when WhatsApp is not able to deliver the message. This can happen because of one of the reasons given below:


  1. WhatsApp restricts the number of marketing message templates you can send to a contact during a specific period of time. If you exceed this limit, WhatsApp will not deliver your message to those contacts and return this error. WhatsApp puts this limit to maintain quality of engagement on the platform and reduce number of marketing messages you can send to a particular contact. Click here to learn more.
  2. The recipient phone number is not a WhatsApp phone number .
  3. Recipient has blocked your number. Or they can not send message back to you.
  4. Recipient has not accepted WhatsApp's new Terms of Service and Privacy Policy .
  5. 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.


There is no solution to fix this error. If the phone number you send to is correct, not blocked and compatible, the message will get delivered and you'll not get this error.


Error Message 4 – ERROR: Message not sent. Message failed to send because there were too many messages sent from this phone number in short period of time.


The max limit of incoming and outgoing messages per second is 80 messages per second. Sometimes when messages are getting sent and you also have a stream of incoming messages this limit may get crossed temporarily and that causes the error.


The solution for this issue would be to freshly resend messages to these contacts.


Error Message 5 – ERROR: Message not sent. body: number of localizable_params ( x ) does not match the expected number of params ( y ).


The error is caused when WhatsApp is not able to recognize correct number of variables in the template.


The solution for this is to make a little modification in the template and resubmit for approval.


Error Message 6 – ERROR: Message not sent. WhatsApp provided number needs display name approval before message can be sent.


Note that when you use a WhatsApp provided free number, you need to get Display Name approved for it before you are able to send messages.

Follow the instructions in this article to get your display name approved and then try sending messages again.

How to Get Display Name Approved? — https://help.wanotifier.com/en/article/how-to-get-display-name-approved-1p3u79a/


NOTE: If you do not want to wait for the Display Name approval, then you can setup your own phone number which does not require display name approval for sending messages.


Step 3 - Still not resolved? Other common issues...


Here are some of the other common issues that you might face when trying to send messages along with their solutions:


1. I’m not seeing any sent, delivery or read stats on Notifications page



When you do not see any stats on the Notification page in front of your notification and everything shows 0, then that is caused because of not setting up webhook correctly. Please refer to the Step 4. Configure webhooks step in this How to Setup WhatsApp Cloud API? article and complete setting up the webhook to fix this issue.


We hope this article was able to help you solve your issue. If you’re still facing the issue, I request you to please start a chat with us and we’ll be happy to look into this for you.

Updated on: 25/06/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!