Skip to main content

Create outbound campaign

This article provides how to create campaigns for any channel. The process for creating a campaign remains same for all channels. However, certain steps change in Step 2: Message template depending on the channel and variables used in the selected template.

1. Prerequisites

For WhatsApp

  • You need to have Whatsapp channel configured with a business number.
  • Add only whitelisted templates (approved templates) in the templates module.

2. Create Outbound campaign

  1. Navigate to your project and go to the Engage module.

  2. Click + Create Campaign.

  1. Provide Basic information.

    a. Enter a suitable Campaign name that resonates well with the purpose of the campaign.

    b. Select your preferred channel through which you want to send communication in active channels.

    c. Click Next.

  1. Select your preferred Message template using the respective radio button. For more details, see Templates overview.

note

To view details of a template, click on the respective template. You can also see the preview of the template once you select it.

You will see template configuration slide screen where you need to configure details like variables mapping, user identifier and so on.

  1. Configure each template details and click Next to continue.
  • For SMS, choose the user's phone number variable and map the variables used in the template to the user property variable.For more details, see here.

  • For Email, choose the variable that contains email Id, select the sender ID (email ID), and map the user variables used in the template. For more details, see here.

  • For WhatsApp or Viber, choose the variable containing WhatsApp number, sender ID, and map the user variables used in the template. For more details, see here.

  • For Microsoft Teams, choose the variable containing Users contact details, sender ID, and map the user variables used in the template same as WhatsApp or Viber template.

note

The user contact details/ recipient column and other others can be selected from user data which you can upload/maintain in Yellow.ai User module.

tip

If you want to switch to User module to add audience, you can save the campaign as draft and continue later.

  1. Select your Target Audience and click Next to proceed to scheduling the message (Schedule).

    • You can either choose audience from the list of segments that you already created [OR]

    • Create a new segment using + Add new segment. For more details, see Users module and segment creation.

  2. Schedule your Campaign: Define when to send the campaign (Timezone: Asia/Kolkata). For detailed procedure, see Schedule message. From the options, select

    • Once to run the campaign for one occurrence.
    • Now to run after 10 min once you schedule the campaign.
    • Later to send out the campaign message on a specific date and time. Use the Calendar box to set your preferred date and time.
    • Run multiple times to configure a recurring campaign.

  3. In Set a goal, set the objective that you want to track for the campaign. For more details, see Campaign goals.

    i. Select and configure your desired goal - Delivery, Conversion or Response. ii. Set the duration (in hours/days) for which you want to track the goal in Track the goal for. For example, if there is a sale in a couple of days, you can set it to track for two days to get the count of messages delivered before the sale ends.

  4. Use Test Campaigns to test it with internal team members before sending out actual audience. You can add upto five recipients. For a detailed procedure on how to test campaigns, see Test campaign.

  5. Review and Launch the campaign. Preview all the campaign details on this page. You can go back to previous steps if you want to make any changes.

note

Click Save as draft to save all your changes. You can resume from here anytime.

i. Once you have reviewed all the details and is good to go, click on Launch Campaign to schedule.

The system prompts you with a pop-up screen to convert the outbound campaign to a Flow campaign, mentioning all the benefits post-conversion.

ii. Click Not interested to proceed with creating outbound campaign. [OR] Click Explore flows to convert the Outbound flow to a Flow campaign.

Once you create the outbound campaign, you will be redirected to the campaigns dashboard page.


3. Configure templates for different channels

This appears in the Basic information screen once you select a channel template. You need to configure some settings depending on the channel and template. For example, setting up the sender ID, and mapping variables used in the template.

This section guides you on how to configure template for each channel -

3.1 SMS campaign

  1. In Choose the field that contains users contact or number where they can receive the campaign, select the variable that contains the user's phone number.

  2. In Map variables, associate each variable mentioned in the template with the user variables. You can map a variable or provide a bot link

  3. To monitor URL clicks, select URL click tracking for variables that contain URLs.

3.2 Email campaign

  1. In Choose the field that contains users contact or number where they can receive the campaign, select the variable that contains the user's email address.

  2. In Select the email address from which you want to send the campaign, choose the email address from which you want to send the campaign. To know how to add email accounts, see Email channel

  3. In Map variables, associate each variable mentioned in the template with the user variables. You can map a variable or provide a bot link

3.3 WhatsApp campaign

  1. In Choose the field that contains users contact or number where they can receive the campaign, select the variable that contains the WhatsApp number (mobile number) of the user.

  2. In Sender ID, choose the WhatsApp business number from which you want to send the campaign.

  3. In Map variables, associate each variable mentioned in the template with the user variables. You can map a variable or provide a bot link.

  4. To monitor URL clicks, select URL click tracking for variables that contain URLs.

  5. Use Media to configure personalized media for the campaign.

    • Static media: Select to send a common media file to all the recipients. Use Browse to upload the media file.
    • Dynamic media: Select this option to send personalized media to each user. Map the column from the database where you have included these details. For instance, you can send WhatsApp campaigns with personalized video media to your customers.

      To insert a property dynamic URL:
      a. Create a user property with the data type set as URL.

      b. Store the image URL for each user to that user property.
      c. Associate the media with this user property when scheduling the camapign.

3.4 Viber campaign

  1. In Choose the field that contains users contact or number where they can receive the campaign, select the variable that contains the user's WhatsApp number (mobile number).

  2. In Sender ID, choose the WhatsApp business number from which you want to send the campaign.

  3. In Map variables, associate each variable mentioned in the template with the user variables. You can map a variable or provide a bot link.


4. Schedule message

As explained in the Step 6, you can choose when to run your campaign. However, there are advanced options to customize scheduling your message and make your campaign more effective.

4.1 How many times you want to run the campaign

Choose whether to run the campaign only once or on a recurring basis.

Run once
  • Select Now to run after 10 min once you schedule the campaign.

  • Select Later to send out the campaign message on a specific date and time. Use the Calendar box to set your preferred date and time.

Run multiple times

Select this to schedule a recurring campaign.

  • Repeat: Select the frequency of running the campaign.

  • Daily: Set your preferred date and time.

  • Weekly: Select the day of the week (Sun-Sat) when you want to run the campaign and set your preferred Time.

  • Monthly: Select the date of the month (1-31) when you want to send out the message and set your preferred Time.

  • Ends: Choose when you want to end the campaign.

OptionDescription
neverTo run the campaign for ever
onTo end on a specific date and set the desired date and time.
afterto end after n number of occurrences and configure the respective options

4.2 Business hours

This lets you honor DND timings, so that you can prevent users from receiving campaigns during specific periods, such as late nights.

You can set business hours for each day of a week so that your campaign message will be sent out only during the configured business hours.

  1. Enable Business hours.

  1. Click on + Add business hours setting > Add new business hour.

  2. Click on each day of the week and configure business hours for that particular day. Enable Business hours same every day to set a common timeframe for all days.

  1. Message handling during DND hours

You can configure what to do with the messages after the configured business hours using the following options.

  • Discard the message: The message will not be sent and will be marked failed.

  • Postpone to next day: The campaign will be paused and will resume the next business hours.

note

You can Pause a scheduled campaign and Resume it when required using the respective options from the Outbound campaign homepage.

5. Segments

Segment is grouping of users based on certain condition sets. Segmentation can be based on city, tags, names, or any another user property.

  • You can add multiple condition sets as required.

  • In the below example, a segment is created with users whose country is mentioned as "india" from the User module.

  • Once the segment is created, you can see the number of users under the segment.


6. Campaign goal

The campaign goal represents a specific objective that you want to achieve through the campaign. Campaign goals can vary depending on the purpose of the campaign and the desired outcome.

Tracking the progress of campaign goals is important to ensure the effectiveness of the campaign in meeting its objectives. This could include the template used, user segment targetted, scheduled time, or any other parameter.

Goals are categorised into three types depending on the purpose of the campaign:

1. Delivery goal

The delivery goal helps you track the messages delivery status and assess the campaign reach. For example, for promoting a new outlet, your goal could be the number of messages delivered.

Currently, there are three delivery statuses supported - sent, delivered, and read. However, not all channels support all three statuses. For example, the message read cannot be tracked for SMS.

  • In What do you want to track, select the delivery status to track.

2. Conversion goal

This refers to the process of identifying a specific user action or interaction that indicates a successful completion of a predefined objective or desired outcome.

When users perform the conversion event, it signifies that they have taken the intended action or achieved the goal you have set for the campaign. This could be anything from making a purchase, signing up for a newsletter, filling out a form, or any other action that aligns with the campaign's objectives.

In Select event, choose the event that you want to track.

3. Response goal

This goal helps you track the reactions or clicks received for the campaign. However, CTA events are not captured from WhatsApp and button clicks are not included in the tracked events.

  • Select Any response: Tracks all types of responses received for the campaign.
  • Button clicks: Tracks only button clicks received for the campaign. You can use this only for templates with CTAs.

It is recommended to test your campaign with internal or test users before launching to ensure the campaign notifications are flawless. Especially, verify if images, buttons, deep links, and elements of personalisation are working or rendering as expected.

The following are the benefits of testing a campaign before launching -

  • Prevent sending wrong content to the customers.
  • Enables viewing the notification messages as and how the end-users receive.
  • Ensures the variables are mapped to the right user properties.
  • Reduces campaign failures due to mismatch in parameters or issues with images size.

Prerequisites for adding test user details

  • Test users data should be available in the User 360 module
  • Test users should have all the data which will be mapped to the variables used in the template.

Test campaign

  1. Once you Schedule a campaign, you will see an option to Test campaign in Step 8 of Create campaign, Review and launch.

  1. Click on Test campaign.

  1. Search for test users.
  • A wizard will be opened to add test user details.

  • You can search users by name, email, phone number or userID. You will see auto-suggestions in the drop-down as you type.

  1. Add test users

    a. Click on the relevant user to populate all values like recipient ID and other parameters if any.

    b. Check whether all the parameters are mapped correctly to the desired user columns.

    c. Ensure all the values are available for the user. If not, use a different user use whose required details are available.

d. To add more users (up to 5 test users) click on +Add Users and repeat the process.

  1. Click on Send test campaign to trigger campaign to the selected users.

You will see the Sending status. You can see the actual delivery status after a while (about 15 seconds) - Delivered or Failed.

  • To send the test campaign to more users, click on Send new test campaign.

For Failed messages, you can also see the reason for failure.

note
  • It takes 15 seconds to update the sent status of messages.
  • If there is any mismatch in the data, save the campaign using Save as draft. Then, navigate to templates step, correct your mappings and test again.

8. Campaign errors

Here are some common errors that you may encounter when working with campaigns:

note

For API related error codes and descriptions, see Notification API response codes.

9. Notifications on Campaign status & progress

You can get notified via email for critical campaign status and progress alerts. For broader awareness and efficient resolution of campaign-related concerns, you can specify preferred users to receive notifications in case of any issues with the campaign. By default, email alerts are sent automatically to the template creator for critical template statuses and to the campaign creator for campaign failures due to template disablement.

To enable email alerts:

  1. On Engage, navigate to Preferences.

  2. Toggle the Enable campaign alerts.

  3. Check Send alerts on campaign progress to receive campaign progress related updates. By default, Send alerts when campaigns are paused/failed is enabled, you cannot uncheck it.

  4. In Sending email alerts enter your preferred email addresses separating each with comma (,).

  5. Click Add.

What next