WhatsApp campaigns
A WhatsApp campaign sends one approved template to the segments and lists you choose. Use it for launches, offers and restock alerts that bring subscribers back to buy. You pick the template, decide what fills each variable, add media and button links, send yourself a test, and launch now or on a schedule.
Las guías están en inglés.
Before you start
- Connect a WhatsApp Business number. See Connect WhatsApp.
- Have at least one approved template. Campaigns cannot send free-form text. See WhatsApp templates.
- Have an audience of WhatsApp subscribers: contacts with a phone number who opted in to WhatsApp. See Collect opt-ins.
This article covers the WhatsApp message itself. Audience, scheduling and launch work the same way for every channel and are explained in Campaigns overview.
Create a WhatsApp campaign
- Open Campaigns and start a new campaign.
- On the channel screen, find the Whatsapp card ("Send one time Whatsapp messages to your selected subscribers") and click Create Whatsapp. If the button says Install Whatsapp, connect WhatsApp first.
- Enter a Campaign Name. Names can only contain letters, numbers, underscores and spaces.
- Under Send To, select the segments and lists that should receive the campaign. Under Don't Send To, select any to exclude.
- Check the Audience Count. It is an estimate of the WhatsApp subscribers in your selection, and the actual number may vary.
- Set the Scheduled Time: Now, or pick a date and time.
- Build the message as described in the next sections.
- Send yourself a test, then click Launch Campaign and confirm.
You can also add up to 50 Tags to a campaign to group it in your campaign list. Click Save changes at any time to keep the campaign as a draft.
Choose a template
- In the Message Body card, click Browse Templates.
- Search by name or message, select a template and click Load Template.
- The template's text appears in the card, with a control for each variable. The phone preview shows the message as the customer will see it.
- Only approved templates are listed.
- If your account has more than one WhatsApp number (MSG91 or Gupshup), templates are shown for the selected number, and the number is displayed next to Browse Templates.
- If the picker says No templates found, check the template's status under WhatsApp templates and click Refresh there.
Fill the variables
Each placeholder in the template shows as a button in the message. Click it and choose how it is filled. Use the previous and next arrows to move between variables.
| Mode | What it does |
|---|---|
| Tags | Pre-defined variables that are replaced with each customer's own data: First Name, Last Name, Shop Name, Shop Url and Discount. |
| Custom | Text you type, which is the same in every message. |
| URL | A custom link added to the message. Contlo sends it as a shortened URL. |
- First Name and Last Name need a Default value, used when a contact has no name on file. Without one you see Please provide a default value for var and the variable's number.
- Every variable must be filled before you can save or launch. An empty one shows Please provide a value for var and its number.
Discount codes
When a variable uses the Discount tag, a coupon selector appears under the message. Choose the coupon that should supply the code. If the coupon uses a fixed list of codes and there are fewer codes than recipients, launch is blocked with Not enough discount codes available for this campaign. Please use a different discount rule. See Coupons.
Auto retry failed messages
Turn on Auto retry to send failed messages to have Contlo try again when a message fails to send. Failed messages are retried automatically at the interval you choose, until the deadline you set, with no manual work.
| Setting | Options |
|---|---|
| Retry Intervals | 6 hours, 9 hours, 12 hours or 24 hours |
| End Retrying | After 3 days, After 7 days, After 14 days or On a specific date |
If you don't see this option, auto retry isn't enabled for your account yet. Ask your account manager or write to hello@contlo.com. Retry results are shown per attempt in the campaign report. See Campaign reports.
Send a test
- Finish the message: template, variables, button links and media.
- In the Test Message card, enter a phone number with its country code.
- Click Send Test.
The campaign is saved first, then the test is sent. You see Test message sent on success or Test message could not be sent if it fails. The same checks as a launch apply, so a missing variable or file stops the test and tells you what to fix.
Launch
Click Launch Campaign. A confirmation shows roughly how many subscribers the campaign will be sent to and, for a scheduled campaign, the time. Click Launch Now or Schedule to confirm, or Back to Edit to make changes.
- If the send time falls in your quiet period, a warning tells you the campaign will go out right after the quiet period ends.
- If your segments were used in recently sent campaigns, a Smart Send Alert! reminds you that some contacts may be skipped.
- If you have reached your plan's audience or message limit, you are asked to upgrade before launching. See Billing and plans.
The full launch flow, including scheduling by customer time zone, is covered in Campaigns overview.
Who receives the campaign
- Only WhatsApp subscribers in your Send To selection, minus anyone in Don't Send To.
- Contacts who are unsubscribed from WhatsApp, have an invalid number, or were messaged too recently under smart sending are skipped.
- A contact who appears in several selected segments or lists is sent the message once.
- Replies from customers arrive in the Conversations inbox, where the campaign message is shown in the thread labeled Campaign. A reply opens the 24-hour window, so your team can answer freely and help the customer complete the order.
Errors and failure reasons
While building the campaign
| Message | What to do |
|---|---|
| Please select a template | Click Browse Templates and load an approved template. |
| Please provide a value for var (number) | Open that variable and choose a tag or type a custom value. |
| Please provide a default value for var (number) | Add a Default for the first name or last name tag. |
| Please provide a cta button mapping | Choose Shop Url or Custom Url for each dynamic button. |
| Please provide a cta button mapping url | You chose Custom Url or Static Code but left the link or code empty. |
| Please provide a discount value | A variable uses the Discount tag. Select a coupon. |
| Please upload a media for card (number) | Each carousel card needs its own image or video. |
| Please enter campaign name or a name error | Give the campaign a name using only letters, numbers, underscores and spaces. |
| Please select valid Segments/Lists | Choose at least one segment or list under Send To. |
| An error occurred while saving campaign details. Please try again. | Save again. If it keeps failing, write to hello@contlo.com. |
After sending
Open the campaign to see its results. The report groups contacts who did not receive the message by reason. See Campaign reports.
| Reason in the report | Meaning |
|---|---|
| Skipped (unsubscribed, invalid or recently messaged) | The contact was not eligible: no WhatsApp opt-in, an invalid number, or held back by smart sending. |
| Duplicate contact | The same contact was already included once in this campaign. |
| Failed before sending | The message could not be prepared or handed to WhatsApp. |
| Cancelled | The send was cancelled before this contact's message went out. |
| Bounced/Failed | WhatsApp or your provider did not deliver the message. |
Guías relacionadas
- Campaigns overviewFind, filter and manage every campaign, and follow the steps all channels share: name, audience, schedule, review and launch.
- WhatsApp templatesCreate WhatsApp message templates with headers, variables, media and buttons, submit them for Meta approval, and test, edit or delete them.
- Connect WhatsAppConnect your WhatsApp Business account to Contlo, check your number and quality rating, and learn what each WhatsApp settings tab does.
- Campaign reportsRead a campaign's results: sent, opens, clicks, bounces, unsubscribes, orders and revenue, plus the click map, A/B results and export.
- CouponsCreate static or unique Shopify discount codes in Contlo and add them to SMS, WhatsApp and automation messages.