Campaign management

Contact Center AI Platform provides the ability to perform outbound calling campaigns. A campaign includes a list of customers that should be contacted and are managed through the CCAI Platform campaign manager.

Campaign manager

Users with administrator role can set up the outbound dialer using campaign manager.

The campaign manager allows for the manual control of campaigns (start and pause buttons in the Action column).

Creates campaigns in the campaign manager by:

  • Uploading a contact list.

  • Setting the dialing mode.

  • Selecting the target queue.

When a campaign starts, it reserves available agents in the selected target queue and sends them contacts from the campaign contact list, following the flow defined for the selected dialing mode.

To access the campaign manager, go to Campaigns in the CCAI Platform portal.

The campaign manager includes the following columns:

  • Campaign name

  • Assigned queue

  • Mode: the type of campaign:

    • Preview: a preview campaign has the agent manually dial the contact.

    • Predictive: a predictive campaign predicts how many contacts need to be dialed.

    • Progressive: a progressive campaign uses reserved agents.

  • Status: the current status of the campaign:

    • Ready: the campaign is ready to be started

    • Running: the campaign is currently being executed

    • Paused: the campaign has been paused, and execution is halted

    • Completed: the campaign has completed execution

  • Action: change the status of the campaign:

    • Play: pause the execution of the campaign

    • Pause: temporarily halt the execution of the campaign

  • Total Volume

  • Progress

Start a campaign

To get a campaign to progress, be sure that the following requirements are met.

  • Queue: One queue must be pre-built. See IVR: Adding and Editing Queues Menus.

  • Agent: One agent must be in Available status. See Agent statuses.

Action column

The Action column is used to start, pause, or restart campaigns. The action buttons available are based on the current execution status of the campaign.

  • For a new campaign, click Play to begin the campaign. The status for this campaign will be updated to Running and the refresh cycle for the progress bar will begin.

  • If the campaign execution needs to be placed on hold, click Pause in the action column. The execution status is set to paused and the progress bar will stop refreshing.

  • To resume the execution of a paused campaign, click Play again to restart execution of the campaign. The execution status will return to Running and the refresh cycle for the progress bar will be reset.

Once a campaign has completed, no buttons will be displayed in the Action column for that campaign.

Campaign progress

The progress column indicates the list position of the next contact to be called.

When the green progress bar is full, the campaign has reached the end of the list and the campaign execution status is updated to Completed. If the campaign execution is manually paused, the progress bar will also be paused until the campaign is restarted.

Campaign data is processed in real-time and automatically updates the progress bar, the campaign metrics, campaign status, and the action buttons as calls are made.

You can also click the Refresh icon to see new campaigns that have been added since your last refresh.

Campaign call status

The call status window shows the number of calls from the campaign by status.

These metrics provide real-time feedback that allows managers to quickly adjust their strategies for upcoming campaigns and ensure agent productivity. These metrics also provide insight into any data quality issues in their CSV file.

To access the call status window, click the campaign for which you want to view statistics and click the External link icon adjacent to the progress bar to bring up the call status.

In the call status window, you can see the volume of calls by status.

The status types available in this window will vary by campaign type.

Campaign display

Outbound dialer campaign call status window

The call status window shows the number of calls from the campaign that fall into each of the various statuses. These metrics provide real-time feedback that allows managers to quickly adjust their strategies for upcoming campaigns and ensure agent productivity. These metrics also provide insight into any data quality issues in their campaign file.

To access the call status window, click the campaign for which you want to view statistics and click the External link icon adjacent to the progress bar.

Call status window

In the call status window you can see call volumes by status for various metrics. The metrics available in this window will vary by campaign type.

Call status window

Reached

  • Finished: agent connected to end-user

  • Call transferred: agent connected to end-user, then transferred the end-user to another agent

Not Yet Reached

  • Queued: calls in a queue waiting to be called

  • Dialing: contacts that are currently being dialer

  • Connected: currently connected calls

  • Upcoming: number has not yet been called

  • Skipped: the agent clicked Skip, which keeps the contact in the campaign (Preview campaigns only)

Not Reached

  • Carrier Error: dialer experienced a call error, such as prolonged ringing with no pickup

  • General Error: any error that does not fall into another error category

  • Invalid Number or Name: number from the CSV file is in an unsupported format, isn't the right number of digits, is a duplicate within the campaign, or is missing a name

  • Not Picked Up: calls that were not answered by the end-user

  • Skip & Close: agent clicked Skip & close to take the contact out of the campaign (preview campaigns only)

  • Abandon by Contact: the end-user answered, but hung up. For example, a short abandon.

  • Voicemail Hung Up: the dialer encountered a voicemail and the agent hung up without leaving a message

Click X in the corner to close the Call Status window.

Outbound number

Outbound number is a feature of the outbound dialer that allows you to specify which outbound number to use when dialing out for each contact. With this feature, you can rotate outbound phone numbers for more control over the outbound phone numbers you use to make your outbound calls.

You can specify which outbound number to use when dialing out for each contact by adding a new column named outbound number to your campaign management CSV. If the outbound number column is missing or the value is not committed, the default outbound phone number will be used.

The dialer will use this number when dialing out if it has been validated on the CCAI Platform. If the outbound number is not validated, the contact will fail and log an error. The outbound number is displayed in the CCAI Platform agent adapter.

Outbound dialer campaign mode global settings

To enable Campaign Mode at the global settings:

  1. Go to Settings > Campaign.

  2. On the panel, turn on the campaign by clicking the switch next to the campaign you would like to enable.

  3. Click Save.

Add a Unique ID for campaign reporting

The following instructions outline how to add a Unique ID column to a campaign management CSV file for reporting purposes.

The process includes adding a Unique ID column to a .csv file using spreadsheet software, uploading the file to a campaign, running the campaign to populate the data, and viewing the Unique ID in the reporting data.

The Unique ID column in the CSV file has no restrictions on formatting. It accepts both alphanumeric and special characters, with no maximum length enforced. You can use Unique ID to represent any relevant identifier such as a customer ID in another CRM, a SKU, or any other identifier.

Add a Unique ID column and upload the CSV file to a campaign

  1. Open the campaign CSV file that you want to upload and add a column called Unique ID. Save the changes to the CSV file.

  2. In the CCAI Platform portal, go to the campaign manager.

  3. Click +Add campaign. A campaign settings dialogue will display.

  4. Click choose file and select the file with the Unique ID column added.

  5. Click open to upload the file.

  6. Select your desired queue.

  7. Click Save.

Populate data through the campaign for reporting purposes

  1. After the CSV file has been uploaded, the campaign execution status will progress to Ready.

  2. Click *Start to start the execution of the campaign.

  3. Wait for the status of the file to change to Ready.

  4. Click Start to begin the execution of the campaign. Allow the campaign to run for a while.

View the Unique ID results in detailed campaign reporting

  1. Go to Reports > Campaigns.

  2. Under Step 1: Select Campaign Mode, choose which type of campaign you want to generate reports on.

  3. Under Step 2: Select Campaigns, choose the campaign associated with the CSV file containing a Unique ID.

  4. In Step 3: Select Reports Desired, choose the reports you would like to download by checking the box next to the report (options appear based on campaign type selected in Step 1). Be sure to select a detailed report.

  5. In Step 4: Choose Filters, configure the filter the reports by timeframe or timezone.

  6. Click Download.

  7. After the file is downloaded, open it to view the Unique ID column.

Company DNC list

CCAI Platform allows you to create your own DNC registry for campaign calls at the Company level. You can configure the DNC list th block direct, manual, and outbound calls, as well as outbound and scheduled calls created by the Apps API. If an agent attempts to contact an end-user on the list, they will receive a message "This call cannot be placed because the phone number is on the Company DNC list".

The dialer checks the DNC list before dialing each number, and skips blocked numbers. Configured emergency numbers cannot be added to the Company DNC list or blocked from outbound calls.

  • Automated callback scenarios will not be blocked (such as during a dropped call).

  • For outbound calls in Preview mode, the contact is presented to the agent only if it's not on the DNC list.

  • Third party additions will also be blocked if the third party number is on the Company DNC.

Enable the DNC list

  1. Go to Settings > Campaigns > Company Do Not Call (DNC) List and toggle the switch to ON. When toggle is set to ON, additional menu options will appear.

  2. (Optional) Check the box to apply the DNC list check to direct, manual outbound calls made by agents in addition to outbound and scheduled calls created by the Apps API.

  3. (Optional) Enable the Do Not Call Again disposition code to use this code to add end-users to the DNC list. Both the disposition code and the DNC list itself must be enabled in order for the DNC list to work in conjunction with the disposition code.

After both the DNC feature and Do Not Call Again disposition code are enabled, the DNC list will be continually updated with new contacts tagged with the disposition code. The DNC list contains of contact entries with the following fields:

  • Note (a string of 200 characters)
  • Phone number
  • Timestamp: When the contact was added to the list.
  • expires_at: A date/time when number can be removed from the DNC list. Contacts will be removed from the DNC list within an hour of the expiration time. If this parameter is not set, the number remains on the list indefinitely.

View the DNC and blocked numbers in Reporting

  • Attempted calls to a blocked number will be logged in the real-time metrics popup.

  • Attempted calls that were blocked by the DNC are logged as dnc_abandoned with the reason: Company DNC.

  • Numbers on the DNC list are reported in the Campaign Summary Report.

API commands for the company DNC list

The Company DNC API endpoints allow you to:

  • Add multiple phone numbers to the DNC list simultaneously.
  • Remove phone numbers from the DNC list.
  • Check whether a phone number is on the DNC list.

See the Apps API documentation for complete details.

Timezone list management

Timezone management simplifies managing different timezones and call time regulations. For example, some regions have strict rules for when telemarketing calls are allowed. You can use time zone management settings to configure only calling authorized numbers during permitted time frames.

Timezone management is based on creating rules and organizing them into schemas:

  • Timezone rule: A rule specifying when an outbound call can be placed. Includes the timezone, code, and time span.

  • Timezone schema: A set of timezone rules with a unique name, used to organize and manage timezone settings.

You can access timezone management settings under Settings > Campaigns. Click Manage setting to open the timezone management settings menu.

Timezone rules

The timezone rules tab allows you to create, edit, and delete timezone rules. Rules can be grouped together to create a timezone schema.

Timezone rules consist of three component parts:

  • Code: A label for the timezone rule)

  • Timezone: Each rule can only contain one timezone.

  • Time span: A list of which times apply to which days.

Create a timezone rule

  1. Click Add timezone rule in the upper right corner.

  2. Select a timezone from the dropdown in the timezone field. The time zones in the list align with existing hours of operations timezones.

  3. Enter a name for your timezone rule in the Code field.

  4. Select a time span option:

    • Default time span: This option chooses every weekday by default. You just need to specify the time span for the rule (in 24 hour time).

    • Custom time span: This option allows you to adjust the hours for each day of the week individually (in 24 hour time).

  • Click Save. You will see the new rule in the timezone rules tab.

Edit or delete a timezone rule

  1. Select the Options menu (3 horizontal dots) on the right-hand side of the timezone rules list. You will see the option to delete or edit each rule.

  2. If you choose to edit the rule, a box will pop up that allows you to make changes.

  3. If you delete a rule, the rule will be removed from all schemas that contain it.

Timezone schemas

A timezone schema is made up of one or more timezone rules. You can create up to 100 different schemas.

Create new timezone schema

  1. In the CCAI Platform portal, go to the timezone schema tab.

  2. Click Add timezone schema.

  3. Enter a name for the new schema in the Name field. Names must be unique and no longer than 64 alphanumeric characters.

  4. Select a timezone from the drop-down list in the timezone field.

  5. Select a timezone option to create a default timezone rule. You must create a default rule for each new schema before you can add additional rules.

    • Default time span: This option chooses every weekday by default. Adjust the time span for the rule (in 24 hour time format).
    • Customme span: This option allows you to adjust the hours for each day of the week individually (in 24 hour time format).
  6. Click Save to save the schema. You can now add additional rules to the schema as needed.

Add new rules to an existing timezone schema

  1. In the CCAI Platform portal go to the Campaign management > timezone schema tab.

  2. Select the name of the timezone schema you want to add a rule to. You will see a list of all the rules contained within the schema. Click add timezone rule to add an existing rule, or create timezone rule to create new rule.

Edit rules of a timezone schema

To edit the timezone schema rule:

  1. In the CCAI Platform portal go to Campaign management > timezone schema tab.

  2. Select the menu (3 horizontal lines) adjacent to the schema you want to edit. You will see the option to delete or edit the schema.

  3. Select edit schema. A new box will appear where you can change the name of the schema and the timezone associated with the default rule.

  4. Make your selections and click save. The default rule for the schema is now changed.

To edit a non-default rule in the schema:

  1. In the CCAI Platform portal, navigate to the campaign management > timezone schema tab and click on timezone schema you want to change. You will see the full list of rules contained in the schema.

  2. Select the options menu (3 horizontal dashes) adjacent to the rule you want to change. You will see the option to delete or edit each rule.

    • If you choose to edit a rule, a box will pop up that allows you to make changes. Changes will be applied to all schemas that contain the same rule.

    • If you choose to delete a rule, the rule will be removed from all schemas that contain it.

Apply timezone schema to an existing campaign

To apply a timezone schema to an existing campaign, follow these steps:

  1. Access the campaign manager by clicking Campaigns.

  2. Click the campaign you want to add a schema to. A pencil-shaped icon will appear adjacent to the entry. Click the pencil icon to bring up the edit campaign window.

  3. In the Assign timezone schema, select your desired schema from the drop-down list.

  4. Click Save to apply changes.

Apply a schema to a new campaign

In order to be able to apply a timezone schema to new campaign, follow these steps:

  1. In the CCAI Platform portal, access the campaign manager by clicking on Campaigns.

  2. Click Create campaign to open the add campaign window.

  3. In the Assign timezone schema, select your desired schema from the drop-down list.

  4. Click Save to apply changes.

Expected behavior for campaigns with assigned timezone schemas

  • When you upload a campaign CSV file, the timezone must be included as its own value. The following is an example of a CSV file containing the timezone field:

    Timezone display

  • Timezone schemas are not applied by default. If none is assigned, the dialer will call all contacts in the list as usual.

  • Timezone schemas apply to all dialer modes.

  • The dialer compares the value from the contact's timezone field against the name of each rule in the assigned schema. If the values match, the relevant timezone rule is applied, and the dialer will only place a call during the time span in the related rule.

  • If the timezone field of a contact does not match any of the timezone rules in the schema, or is not set, then the default timezone rule for that schema is used.

  • The dialer will skip any over any contacts that the schema prevents it from dialing.

  • After all the contacts in the list have been processed, the dialer will begin the process again to see if there are any skipped calls it can now make.

  • New contacts are added to the list without triggering a list review.

Edit a campaign

To edit a campaign that has already been created, follow these steps:

  1. In the CCAI Platform portal, go to Campaigns.

  2. Click the campaign you want to update and select the Edit icon.

  3. In the Edit campaign window, make any necessary changes to the current settings.

  4. Click Set.

Delete a campaign

To delete a campaign follow these steps:

  1. Select Campaigns in the CCAI Platform portal.

  2. Select the campaign you want to delete.

  3. Click Delete in the far right column.

The selected campaign is removed.