Chatalog Help Centre
Chatalog Help Centre

Broadcast (WhatsApp)

Broadcast saves your time from sending identical messages to users one by one. You can create one single message and broadcast to multiple users.
WhatsApp Business API has a conversation-based pricing model. If a business wish to initiate a conversation to a user, the business needs to send a template message which has been approved by WhatsApp. Click here to view the detailed conversation based pricing policy.
Chatalog Tutorials - Broadcast WhatsApp Preparation 1- Import Contact List
Chatalog Tutorials - Broadcast WhatsApp Preparation 2 - Create WhatsApp Message Template
Chatalog Tutorials - Broadcast WhatsApp

Upload a list to broadcast

Image 1: Contact
Select Contact tab to start importing the list. Step 1, select the WhatsApp inbox you have connected for broadcast from the dropdown. Step 2, click Import button at the top right.
Image 2: Import new contacts
Download a sample file and follow the file format to import your contact list. Step 1, click "sample file" and download the .csv file.
The .csv file has two columns. The first one is the display name of the user, whereas the second column is the user telephone number. The telephone number must include the country code. For example, if the country code is 852, then the number should be 85298765432.
Image 3: Contact file uploaded
Once you have uploaded your file, you will see the number of valid contacts being uploaded. Click "Import" to finish this process.

Create a WhatsApp Message Template

Image 4: Broadcast - Templates
In Broadcast page, step 1, click the dropdown to select the WhatsApp channel you wish to broadcast messages. Step 2, select "Templates" tab. Step 3, select "Add Template" to create a WhatsApp Message Template.
Image 5: Create a Template
Step 1, select the category that indicates the purpose of your broadcast. Step 2, select the language of your broadcast message. Step 3, optionally select the header for your message. You can choose text, image, video, or document as header. It is none by default. Step 4, name your template. Step 5, fill in the broadcast message. Step 6, optionally add buttons for your broadcast message. There is two types of buttons, call to action (i.e. URL or Phone) and quick reply (i.e. text). You can add up to 2 call to action buttons or up to 3 quick reply buttons. Each template only allows one type of buttons. Step 7, submit the template when you have finished filling in all the necessary information.

Common Rejection Reasons

Message templates with the following patterns are commonly rejected by WhatsApp.
  • Variables are placed at the beginning or end of the message.
  • Variables are placed next to each other, such as “{{1}} {{2}}”.
  • Variables have mismatched curly braces, or use words instead of numbers. The correct format is {{1}}, not {{one}}.
  • Variable parameters are not sequential. For example, {{1}}, {{2}}, {{4}}, {{5}} are defined but {{3}} does not exist.
  • Call to action button URL contains a direct link to WhatsApp, such as "", which Meta no longer allows.
  • Template is a duplicate of an existing template. WhatsApp rejects templates submitted with the same wording with a different name.
  • Template contains content violating the WhatsApp Commerce Policy or the WhatsApps Business Policy. Do not request sensitive identifiers from users, such as payment card numbers, financial account numbers, or National Identification numbers. Requesting partial identifiers (ex: last 4 digits of their Social Security number) is OK.
  • Template appears to encourage gaming or gambling. Including words such as "raffle" or "win a prize" almost guarantees template rejection by WhatsApp.
  • Template is overly vague, such as “Hi, {{1}}, thanks”. This type of template could be abused to spam users. You need to surround the parameters with information so that it’s clear what type of information will be inserted.
  • You are using the wrong language. For example, a template in English is submitted with Portuguese language selected.
  • Grammatical or spelling mistakes. Even minor spelling or grammatical mistakes are likely to be rejected by WhatsApp.
Image 6: Template Status
Upon submission, you will see the template showing up in the top of the template list. All the templates will be officially reviewed by WhatsApp. The template status is pending at the beginning, indicating it is to be reviewed. After the review, it will either become approved or rejected. Only approved templates can be broadcast.

Template Statuses

  • Approved: The template was approved by WhatsApp and can be used to notify
  • Pending: Indicates that the template is still under review by WhatsApp. Review can take up to 24 hours.
  • Rejected: The template has been rejected by WhatsApp during the review process.
  • Paused: The template has been paused by WhatsApp due to recurring negative feedback from end users, typically resulting from "block" and "report spam" actions associated with the template. Message templates with this status cannot be sent to end users.
  • Disabled: The template has been disabled by WhatsApp due to recurring negative feedback from end users or for violating one or more of WhatsApp's policies. Message templates with this status cannot be sent to end users.
Image 7: Broadcast
When your template is approved, go back to the "Sent" tab and click "Add Broadcast".
Image 8: Select a template for broadcast
Step 1, select the message template you want to broadcast in green light (i.e. approved). Step 2, name the broadcast. Step 3, in case you have defined any parameter in your broadcast message body, you need to assign the text of that parameter. Step 4, if you have added buttons to the message, you need to define the payload of the button, which means what message do you expect the user to send back to the channel upon clicking the button. Step 5, select audience list for the broadcast. Step 6, determine whether to broadcast now or schedule a time for broadcast. Step 7, click "Submit" to broadcast when you are all done.
If you have set a custom field to users and wish to display its value in the broadcast message, you can input {{customFields.fieldvalue}} to the parameter field as Step 3. If the custom field that you want to display is "membership", where the value is "diamond" for one user, then you can input {{customFields.membership}}. When the broadcast message is blasted, that user will see the value "diamond" in the message.