Create a WhatsApp campaign

AI-generated summary

covering the Genesys Cloud's WhatsApp campaign functionality allows users to select contacts to message from a contact list while excluding numbers on a Do Not Contact (DNC) list. The DNC list must contain records, import successfully, and have the Phone contact method specified. To create a new DNC list, click the DNC box and upload a .csv file with at least one phone number column. When configuring a WhatsApp campaign, select WhatsApp as the message type, specify the contact list column containing the Phone ID, select the WhatsApp template, and specify the WhatsApp integration to use. Enabling Always Running allows continuous messaging as new contacts are added dynamically. The contact list can be sorted by up to 4 columns prior to messaging, such as by Amount_Owed. Delivery status is viewable on the Interactions page under the Delivery Status column. Digital campaign reporting is available in Interactions, not call detail reports

PrerequisitesClick to expand

Genesys Cloud CX 1 Digital Add-on II, Genesys Cloud CX 2, Genesys Cloud CX 2 Digital, Genesys Cloud CX 3, Genesys Cloud CX 3 Digital, or Genesys Cloud CX 4 license
For WhatsApp: Outbound > WhatsApp Campaign > Add, Delete, Edit, View permission
For all campaign types: Outbound > Contact List > Search permission
(Optional) For all campaign types: Outbound > DNC List > View permission
For the WhatsApp integration: Messaging > WhatsApp Integration > Add, Delete, Edit, View permission

Before you set up a WhatsApp campaign, perform these tasks:

Set up your WhatsApp Messenger integration. For more information about the self-service onboarding process for WhatsApp, see WhatsApp Embedded Signup Flow overview.
Create an inbound message flow. For more information, see Create a flow.
Create a message routing entry and associate inbound numbers with an inbound message flow. For more information, see Add an inbound message route.

Next, add the resources required for this campaign mode, or identify existing resources to reuse.

Resource	Required?	Description
Contact List	Yes	Define the list of persons that you want to contact or know which existing list to use. Notes: WhatsApp phone numbers are treated as Phone IDs, not E.164 numbers, by the messaging service today, even though the Phone ID technically represents a real phone number.
Do Not Contact List	Optional	Define a list of numbers that this campaign never messages, even if they are in the contact list. For more information, see Create a new internal DNC list.
Division	Yes	Know which division to associate with this campaign, or whether to use the Home division by default. For more information, see Divisions overview.

Resource

Required?

Description

Contact List

Yes

Define the list of persons that you want to contact or know which existing list to use.

Notes:

WhatsApp phone numbers are treated as Phone IDs, not E.164 numbers, by the messaging service today, even though the Phone ID technically represents a real phone number.

Do Not Contact List

Optional

Define a list of numbers that this campaign never messages, even if they are in the contact list. For more information, see Create a new internal DNC list.

Division

Yes

Know which division to associate with this campaign, or whether to use the Home division by default. For more information, see Divisions overview.

When your setup is complete, create your WhatsApp campaign by following these steps:

Click Admin.
Under Outbound, click Campaign Management.
Click Menu > Digital and Telephony > Outbound > Campaign Management.
Select the Digital Campaigns tab, and then click Create New.
Type a name in the Campaign Name box. The name of a campaign can contain spaces and special characters, but must be unique.
Select a Division or accept the default Home division. For more information, see Work with Divisions in About access control.

Configure your Campaign OptionsClick to expand

Use the Contact List box to select a list of contacts for this campaign to message. To filter the list, type all or part of a name. If you select an unassignable list, a message indicates why. A contact list is invalid if:
- No defined phone number types exist for the list.
- The list has no records.
- The list failed to import.
- An import that created the list is still running.
Tip: If you have not created a contact list, you can do so without leaving the current page:
1. Click the Contact List box and then click Create a New Contact List.
  A dialog box prompts for the contact list name and a .csv file to upload:
2. Type a name in the Contact List Name box and click Browse to select a contact file to upload. For more information, see Create a new contact list.
  Ignore the Attempt Control option in the Advanced section. Attempt controls only apply to voice campaigns and are not applicable to digital campaigns.
3. Click Save.
Note: Wrap-up code mapping is not applicable to digital campaigns.
Optional. From the Contact List Filter box, select the contact list filter relevant to this campaign to limit the messages to contacts that match the filter. For more information, see Contact list filters view.
From the Messages per Minute box, enter the number of messages to be sent each minute during the campaign. If you set the value to anything greater than the maximum message limit, an error occurs.
Optional. From the DNC Lists box, select a table of Phone IDs that this campaign should never message. To filter the list, type all or part of a name. When this campaign selects records to message from its contact list, it excludes numbers that match entries in this DNC list. If you select an unassignable list, a message appears. A Do Not Contact list is invalid if:
- All or part of the list contains no records.
- All or part of the list failed to import.
- The Contact Method for the list is not Phone.
Tip: If you have not created a DNC list, you can do so without leaving the current page:
1. Click the Do Not Contact Lists box and then click Create a New DNC List.
  A dialog box prompts for the DNC list name and for a .csv file to upload.
2. Type a name in the DNC List Name box and to select a DNC file, click Browse. At minimum, the .csv file can contain a single column of telephone numbers. A DNC file contains multiple phone number columns and redundant information, such as contact names.
  Example:
```
Last Name, First Name,DNC_Home,DNC_Cell,DNC_Work
Smith,Bill,317-153-4777,317-981-6233,317-333-2174
Thomas,Terry,424-999-2334,424-384-9993,424-973-8828
```
  Genesys recommends that you include only phone number columns in your .csv file.
3. Click Save.

Set up your Type configurationClick to expand

Enable the Advanced optionsClick to expand

Optional. Enable Always Running if you want the campaign to continue running even if there are currently no contacts in the contact list. The campaign does not complete when it runs out of records, and instead sits idle waiting for more records to be added. This option is useful if the contact list is dynamically updated from another source.
Optional. Sort the contact list by column before messaging begins. For example, if your contact list has an Amount_Owed column, you could sort the list to message people who owe the highest amount first. Under Advanced > Contact Sorting, select a contact list column in Sort by. Select a Sort order: ascending (default) or descending. If the sort column contains numeric information such as a telephone number or monetary amount, switch the Field is Numeric toggle to Yes. Contact list sorting takes place at the campaign start. If you add a contact while a campaign is running, the new contact is messaged but it is not included in contact list sorting. To sort by extra columns, click the plus sign. You can sort up to four contact list columns, with the first sort taking the highest precedence.
Note: Special considerations apply when sorting a date column. The system does not sort a contact column that represents a date formatted mm/dd/yy as a date. It sorts the column as a string since the system does not recognize that format as a date. To work around this limitation, format dates using ISO 8601 format (yyyy-mm-dd). That format sorts in the same order whether considered a string or a date. To denote Christmas Day for example, enter 2017-12-25 instead of 12/25/17.

When you complete your WhatsApp campaign configuration, click Save. The new campaign is available on the Campaign Management page.

Notes:

A message appears if the new campaign exceeds the maximum limit count of 1,000 campaigns. Delete old or obsolete campaigns as needed and click Save again to complete the new campaign configuration.
You can see and export digital campaign reporting from the interaction view, and not in the call detail report. For digital campaigns, you can see the dispositions OUTBOUND-MESSAGE-SENT or OUTBOUND-MESSAGE-FAILED.
To view the delivery status of your WhatsApp campaign interactions, click Performance > Workspace > Interactions. The data is contained in the Delivery Status column. For more information, see Interactions view.

[NEXT] Was this article helpful?

Get user feedback about articles.

Create a WhatsApp campaign View summary

[NEXT] Was this article helpful?

Create a WhatsApp campaign