Failed WhatsApp Broadcast Message with CSV or API
Following are some common errors when sending broadcasts and how to solve them:
| ERROR | CAUSE | WHAT TO DO |
| The value can't be empty at row X | There is a missed parameter value in a particular row of CSV. | Fill in the parameter value at row X, then reupload the CSV. Sample: Incorrect: phone_number, customer_name, body_variable1, header_variable 628123456, YOUR_CUSTOMER_NAME, body_value1, Correct: phone_number, customer_name, body_variable1, header_variable628123456, YOUR_CUSTOMER_NAME, body_value1, https://url.com/image.jpg |
| Missing phone_number at row X | There is no phone number or incorrect phone number format at row X | Please check the row X, fill in the phone number with the format: country code without + (e.g. 62xxxx) |
| Invalid csv header / body format at row X | The number of CSV header, body, and delimiter is different or not as expected in your template. | You have to input the CSV header or body according to the approved message template. You may need to remove or add a delimiter, header, or body. Incorrect: phone_number, customer_name, body_variable1, header_variable628123456, YOUR_CUSTOMER_NAME, body_value1, https://url.com/image.jpg, 628123456, YOUR_CUSTOMER_NAME, body_value1 Correct: phone_number, customer_name, body_variable1, header_variable628123456, YOUR_CUSTOMER_NAME, body_value1, https://url.com/image.jpg |
| Link Required | Your template has a media header but is empty in your CSV. | Just fill in the correct media URL in the body, or if you want to use the default media (when submitting the template) just remove the header_variable column. Sample (after removing header_variable): phone_number, customer_name, body_variable1628123456, YOUR_CUSTOMER_NAME, body_value1 |
| Value entered for a parameter is of the wrong type or other problem | Different submission format | You must resubmit your template with a different name |
No match of right hand side value: error or
| There are any characters or values that are not supported or problems with CSV encoding | Please re-check your CSV data, and make sure the phone number and all variables are normal text characters. We recommend you download the provided CSV template from the dashboard. Different WhatsApp broadcast templates will have different CSV templates. Ensure the body or header values are correct.
|
mismatch btn_vars number with existing template or invalid button_type at row X | Incorrect button type or there is no button variable on your CSV | If your template has a dynamic button, you must add it to your CSV
|
| You exceeded maximum broadcast attempts | Exceeded the maximum broadcast at the same time (mostly because of scheduled broadcast) and same WhatsApp channel. | Add time intervals between the broadcast schedule, at least a 1-minute difference. For instance, if you have got this error at 10.10, please create another broadcast (schedule) at 10.11 or 10.12. |
| {"message":"Insufficient whatsapp balance"},"status":400} | The estimated credit required for broadcast to all customers is not sufficient | You need to top up the credit according to the required estimate. In some cases, the account still has a remaining Quota which can actually be used to send broadcast messages, but the use of credit and quota will be deducted according to the current session (BI/CI) on the destination number. |
Error 1000, Image file format (text/html) is not supported
Error 131053, Downloading media from weblink failed with http code 502, status message Failed to resolve host | The media URL for the header (image, video, pdf) is not supported or is not a direct URL. | Make sure the URL for the header (media) is direct or ended by media extension (shortened URL is not allowed).
Sample: Correct https://d1edrlpyc25xu0.cloudfront.net/win-tbqucu68w4bes1ial/image/upload/brLFVSk8wf/WhatsApp-Image-2021-11-29-at-4.11.52-PM.jpeg Incorrect: https://bit.ly/image-url Solution:
Sample (after removing header_variable): phone_number, customer_name, body_variable1628123456, YOUR_CUSTOMER_NAME, body_value1 |
| Error 131048, 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 | Your WhatsApp Business Account is restricted or exceeds the tier limit to send a broadcast (What is tier?). | Please wait for 24 hours from the first time this error happened. If you would like to find out more about your tier limit, contact us. |
| (#131009) parameter value is not valid | Already input the parameter but invalid. It could be the phone number is not a WhatsApp account or other parameters with the incorrect format. | The phone number must be an active WhatsApp account. Check it out by using this URL https://wa.me/+(country code)number Sample: https://wa.me/+62898883537 > click and open WhatsApp If this doesn't redirect you to start a chat (return "Phone number shared via url is invalid"), it is an invalid account. Please use the phone number with the format: country code without + (e.g. 62xxxx) for both broadcasts using CSV and API. If there is no problem with the phone number, please check other parameter values. |
| (#131000) Failure due to an internal error. Please retry. | Exceed the media size limit or other internal issues from WhatsApp | Avoid using media more than the size limit on WhatsApp. See this reference.
If the media size and format are correct, please wait for a few minutes and then try to send it again.
|
| (#132005) Translated text too long | Your template message exceeds the maximum character limit. | The limit (including parameters):
You can reduce the parameter's character or resubmit the WhatsApp broadcast template with fewer characters. |
| (#132001) Template name does not exist (in the translation) | 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. |
| (#131008) Required parameter is missing | There is a missed parameter value | Fill the parameter according to your message template. |
| (#132000) Number of parameters does not match the expected number of params | Different parameters between the template and what you have sent | Please input the expected parameter. If you send a broadcast using CSV, use the provided CSV template for each message template. If you are using API, refer to this article to see the samples. |
(#131026) Message Undeliverable or (#131026) Receiver is incapable of receiving this message | Unable to deliver message. Reasons can include:
| Using a non-WhatsApp communication method, ask the WhatsApp user to:
|
(#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. |
| Other errors | See all the common Error Codes on WhatsApp | If you still facing any issues, please contact our Support Team |
