With a campaign you send the same message to a list of numbers, personalized for each one: offers, reminders, payment dates or any important notice. This article covers campaigns sent with the WhatsApp Business API, from an Excel or CSV file.
Using a number connected to WhatsApp Web by QR code? See How to send a WhatsApp Web campaign. To pick the recipients by tag instead of uploading a file, see How to send a campaign to the people with a tag.
Before you start
A WhatsApp Business API channel connected in 2Chat.
At least one approved template. With this channel, campaigns can only send WhatsApp templates. See How to manage WhatsApp Business templates in 2Chat.
WhatsApp credit in your 2Chat balance: template messages are charged when they are delivered. Without credit, the campaign can't be started. If the balance runs out while it sends, the campaign moves to Waiting for payment and continues on its own once you top up.
Step 1: Recipients
Go to Campaigns in the side menu and click New Campaign.
Choose Upload a file.
Click download this template reference file to get the example file and fill it in, one row per number.
Drop your file on the box (or click it to pick the file) and click Next.
What the file needs
The columns id, first_name, last_name and phone_number, with those names in English.
The phone number in international format, with the country code, for example +5215512345678. If the + is missing, 2Chat adds it.
Excel (xlsx or xls) with a single sheet, or CSV.
Up to 5,000 rows. To send to more numbers, split them into several campaigns.
Any other column you add (an order number, a discount code, a date…) becomes a variable you can use in the message. On trial accounts, only the first 50 numbers of each campaign are sent. Trial accounts can also create up to 10 campaigns.
Step 2: Configure
The card at the top shows how many recipients and countries the list has. If some numbers are invalid, it shows them too: click Remove invalid numbers for me to continue.
Campaign Name: only you see it, in the campaign list.
Timezone: the one used for the sending hours.
Campaign Speed & Time Range: how many messages are sent per minute, hour or day (12 per hour by default). The gear icon opens the time window, where you choose the days and hours the campaign sends; by default it sends every day, all day.
In Send from channel, choose your WhatsApp Business API number. Below it you'll see that this channel can only send WhatsApp templates.
Click Select Template, pick the template and confirm. Only approved templates can be selected.
Under Map Template Variables, choose what goes in each variable of the template: a column of your file, or the recipient's First Name or Last Name. Sample Value shows what the first recipient will get.
Check the preview on the right and click Next.
If the template has an image, video or document in the header, enter its public link, starting with https. The same file is sent to everyone.
If the message uses the first name and some recipients have none, 2Chat asks what to use instead (Name for those without one), for example "customer". If you leave it empty, the name is left blank in their message.
Save as contact if the number is new adds the numbers that aren't in your contacts yet, with the name from the file.
Step 3: Review and create the campaign
The last step shows a summary: name, channel, message, speed and timezone. If something needs fixing, it is listed at the top, for example repeated numbers: Remove duplicates for me keeps the first one. When you see Everything is ready, click Create campaign.
If the campaign would take more than 4 hours to finish, 2Chat shows an alert before creating it, so you can review the speed and the time window.
Step 4: Start the campaign
The campaign is created as Ready to Start: nothing is sent yet. Click the ▶ button (Start campaign) under Controls to start it.
While it runs you can pause it (⏸) and resume it, or stop it (⏹; a stopped campaign can't be restarted). The counters show how many messages were sent, failed or are still queued, and the Contacts tab shows the status of each number.
After creating it you can still change the timezone, the speed and the time window, and click Save. To change the message, the channel or the recipients, use Options › Clone and create a new one.
When it finishes, Options › Generate Report prepares a CSV with every number and its status; we email you when it's ready.
Starting a campaign requires a Pro or Basic plan, or a trial account.
The status of each number can be Processing or Sent to WhatsApp while WhatsApp confirms the delivery, and then sent, read, answered or failed. If a number has a tag excluded from campaigns, it shows as Excluded; see How to send a campaign to the people with a tag.



