Skip to content
Contlo by QuestionPro
Browse documentation

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.

Campaigns → new campaign → WhatsappApproved templates onlySent to WhatsApp subscribersPersonalized with contact details

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

  1. Open Campaigns and start a new campaign.
  2. 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.
  3. Enter a Campaign Name. Names can only contain letters, numbers, underscores and spaces.
  4. Under Send To, select the segments and lists that should receive the campaign. Under Don't Send To, select any to exclude.
  5. Check the Audience Count. It is an estimate of the WhatsApp subscribers in your selection, and the actual number may vary.
  6. Set the Scheduled Time: Now, or pick a date and time.
  7. Build the message as described in the next sections.
  8. 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

  1. In the Message Body card, click Browse Templates.
  2. Search by name or message, select a template and click Load Template.
  3. 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.

ModeWhat it does
TagsPre-defined variables that are replaced with each customer's own data: First Name, Last Name, Shop Name, Shop Url and Discount.
CustomText you type, which is the same in every message.
URLA 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.

Buttons, links and media

CTA Button Details

If the template has a dynamic link button or a copy-code button, a CTA Button Details section appears. Each button is labeled by kind: STATIC BUTTON, DYNAMIC BUTTON, QUICK REPLY, CALL US or COPY CODE.

Button kindWhat you set in the campaign
Dynamic buttonChoose Shop Url to link to your store, or Custom Url and enter the link.
Copy codeChoose Static Code and enter the Code customers will copy.
Static button, quick reply, call usNothing. These were fixed when the template was approved.

Media

If the template has an image, video or document header, click Click to Upload and choose the file to send with this campaign. You can preview a document, replace the file or delete the upload. A campaign with a media template cannot be saved without a file.

Carousel cards

For a carousel template, a Cards section lists every card. For each one, upload its media, fill the variables in the Card Description, and set the link for each dynamic button under Buttons.

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.

SettingOptions
Retry Intervals6 hours, 9 hours, 12 hours or 24 hours
End RetryingAfter 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

  1. Finish the message: template, variables, button links and media.
  2. In the Test Message card, enter a phone number with its country code.
  3. 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

MessageWhat to do
Please select a templateClick 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 mappingChoose Shop Url or Custom Url for each dynamic button.
Please provide a cta button mapping urlYou chose Custom Url or Static Code but left the link or code empty.
Please provide a discount valueA 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 errorGive the campaign a name using only letters, numbers, underscores and spaces.
Please select valid Segments/ListsChoose 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 reportMeaning
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 contactThe same contact was already included once in this campaign.
Failed before sendingThe message could not be prepared or handed to WhatsApp.
CancelledThe send was cancelled before this contact's message went out.
Bounced/FailedWhatsApp or your provider did not deliver the message.

Related guides

Can't find something? Email us