Failed WhatsApp Broadcast Message with CSV or API

  • Updated

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

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

or


Error saving broadcast jobs

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.

mceclip0.png

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

  • 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_type must be url and button1_variable1 is your dynamic URL)
    phone_number, customer_name, button1_type, button1_variable1
    628123456, YOUR_CUSTOMER_NAME, url, testdynamic
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.
Reference:
What Should I Do If I Get This Error Message "You exceeded maximum broadcast attempts"?

{"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


(#100) Param template['components'][0]['parameters'][0]['image']['link'] is not a valid URI.

 

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

  • .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 
https://fill.this/leaveempty

 

Solution:
How to Get Direct Media Link From Omnichannel? 

  1. Copy the default media URL from the approved template
    Open Outbound Menu > WhatsApp Broadcast Templates > choose the desired template > Copy Media Link
  2. If you want to use the default media (when submitting the template) just remove the header_variable column. Note: make sure you have uploaded the media when submitting the template.

Sample (after removing header_variable):

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

  • 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.
Also, make sure the URL is direct or ended by media extension (shortened URL is not allowed). Reference: 
How to Get Direct Media Link From Omnichannel? 


Contact us
if it still happening.

(#132005) 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.

(#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:

  • The recipient phone number is not a WhatsApp phone number.
  • The recipient has not accepted WhatsApp's new Terms of Service and Privacy Policy. Please send your customer this link https://wa.me/tos/20210210 to accept the latest Terms of Service.
  • Recipients are using an old WhatsApp version. They should use the following 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 Per-User Marketing Template Message Limits.

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 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.
Other errors See all the common Error Codes on WhatsApp If you still facing any issues, please contact our Support Team

 

Was this article helpful?

Comments

0 comments

Article is closed for comments.