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 Correct: phone_number,customer_name,body_variable1,header_variable |
Invalid csv header / body format at row X | The number of CSV header, body, and the 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_variable Correct: phone_number,customer_name,body_variable1,header_variable |
Link Required |
Your template has a media header but is empty in your CSV. |
Just fill 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_variable1 |
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 | There are any characters or values that are not supported or problems with CSV encoding |
We recommend you download the provided CSV template from the dashboard. Different WhatsApp broadcast templates will have different CSV templates. Ensure |
mismatch btn_vars number with exisiting template | There is no button variable on your CSV |
If your template has a dynamic button, you must add it to your CSV
|
Error 1000, Image file format (text/html) is not supported | The media URL for the header (image, video, pdf) is not supported or is not a direct URL. |
Make sure the URL 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: |
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. |
(#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. Contact us if it still happening. |
(#131005) 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. |
(#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. |
Other errors | See all the common Error Codes on WhatsApp | If you still facing any issues, please contact our Support Team |