Articles in this section

See more

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_variable
628123456,YOUR_CUSTOMER_NAME,body_value1,https://url.com/image.jpg
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.

Sample:

Incorrect:

phone_number,customer_name,body_variable1,header_variable
628123456,YOUR_CUSTOMER_NAME,body_value1,https://url.com/image.jpg,
628123456,YOUR_CUSTOMER_NAME,body_value1

Correct:

phone_number,customer_name,body_variable1,header_variable
628123456,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 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
628123456,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 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 

mceclip0.png
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

  • Download the CSV template from the dashboard after you choose the template
  • You will see the columns button1_type and button1_variable1. Please fill in like this: (button1_variable1 is your dynamic URL)
    phone_number,customer_name,button1_type,button1_variable1
    628123456,YOUR_CUSTOMER_NAME,url,test
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).

  • .MP4 for Video
  • .JPG/JPEG/PNG for Image
  • .PDF for Pdf

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

  • Image 5MB
  • Video & Audio 16MB

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):

  • Header text 60 characters
  • Body 1024 characters

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

Related articles

Powered by Zendesk