Add a new campaign

All timestamps are in GMT.

To add a new campaign:

1. In the Campaign List tab, click + New Campaign Setup.

2. Enter a name for your campaign to identify it easily (max. 255 characters).

3. Select the campaign type:

   • WhatsApp, or

   • SMS

4. Click Next.

Enter a campaign name and select the campaign type.

Setting up a WhatsApp Campaign

1. Select the message template you want to use.

   • The drop-down lists all WhatsApp templates already approved on your Clickatell account.

   • The message body populates automatically and is not editable.

   • For media templates, upload the file you want to add as the template header.

   • A preview of the message is shown on the right.

     • Note that marketing messages over 5 lines of text will be truncated for end-users with a "Read more" option to expand the message.

You can only select from the approved WhatsApp templates on your account. Find out how to apply for and manage your WhatsApp templates here.

Select the specific message template from the drop-down and preview it on the right.

The following template types and components are supported:

• Media Header:

  • Document (PDF, 30 MB max size)

  • Video (MP4 or 3GPP, 5 MB max size)

  • Image (JPEG or PNG, 5 MB max size)

• Text: As set up via the Clickatell Portal and approved by Meta. Must include at least one variable.

• Quick replies: As set up via the Clickatell Portal and approved by Meta.

• Static and dynamic URLs: As set up via the Clickatell Portal and approved by Meta.

All buttons in the template are listed. If it is a call-to-action button, the number and URL(s) linked to each button are shown when hovering over it. This number will be dialed if an end-user taps the Call Phone Number button and the URL launched when they tap the Visit Website button. If the URL button is linked to a dynamic URL, it is shown in the format: https://example.com/order/{{1}}.

The number/URL linked to the call-to-action button for the selected template is shown upon hover.

You cannot change the buttons' text on the templates, as these have been pre-approved. However, if you want to trigger a specific flow in Chat Flow when a customer taps a button, you must ensure the keyword in Chat Flow and the button keywords (as shown below) match exactly.

1. Select when you want to send your campaign:

   • Save a draft campaign to edit later.

   • Send the campaign immediately.

   • Schedule the campaign for a future date.

Select when you want to send your campaign.

1. Indicate who must receive your campaign message.

   • Upload a file from your computer:

   • File types: .xlxs, .txt, or .csv file

   • Maximum file size: 100MB

   • Maximum number of rows: 1 million

   • A column containing the recipients' MSISDN (phone number) is required. Phone numbers must be added in international format.

   • Add any other columns with the information you require.

File names may not contain a full stop. For example, use test_file1.csv instead of test.file1.csv. Commas need to be added at the end of each line.

For an example file, see here.

Upload the list of recipients for this campaign from your computer.

• Or log in to your FTP server and import the recipients' details:

  • File types: .xlxs, .txt, or .csv file

Import the list of recipients for this campaign from your FTP server.

In both cases, the column headings in your file are automatically shown as options in a drop-down for each variable in your template. From each drop-down, select the column that must be used to populate each variable.

It is required to select a column containing the recipients' MSISDN numbers. The rest can be left blank.

Click Save and Import.

The table displays an extract of the file you imported for review. You can search for a specific recipient using the MSISDN (mobile) number.

Review recipients.

1. Click Save/Send/Schedule. This Campaign appears in the Campaign List tab with the applicable status.

Setting up an SMS Campaign

1. Add your campaign message. A preview is shown on the right.

2. Select when you want to send the campaign message:

   • Save a draft campaign to edit later.

   • Send the campaign immediately.

   • Schedule the sending of the campaign for a date in the future.

3. Indicate who must receive your campaign message:

   • Upload a file from your computer (file types: .xlxs, .txt, or .csv; maximum 100MB)

   • Import a file from your FTP server (file types: .xlxs, .txt, or .csv)

4. The column headings in your file are pulled in and displayed in the drop-down. Select the column containing the recipients' phone number (MSISDN).

5. Click Save and Import.

6. Click Save/Send/Schedule in the top right corner. This Campaign will now appear in the Campaign List tab with the applicable status.

Add the message body, select when you want to send, and who to send it to.