Launch a Voice Campaign

Prerequisites:

• Complete the KYC process. For more information on the KYC process, see the Complete the KYC page.
• Ensure you have a sufficient balance left (prepaid user) or enough monthly usage available (postpaid user) to launch your Voice campaign.
• An Active number subscription.
• Optionally a published flow in Flow Builder (in case you wish to connect a flow).

To launch a Voice campaign perform the following steps:

1. Sign in to your Kaleyra.io account (https://kaleyra.io/).
2. Go to Campaigns and then click Voice.

The Voice Campaigns list appears. The list shows the campaign names, the type of campaign, the date of campaign creation, and the campaign status for all the past campaigns.

3. In the Search for Campaigns field, enter the complete or partial campaign name for which you wish to search, and the respective campaigns list appears.

4. Click Filter. The Filter pop-up appears.

5. You can filter campaigns based on the created date and status.
6. Select the Start Date and the End Date from the Calendar icon and click Done.

7. Click the arrow next to Select Status to view the list.

The following are the supported status options:

• Completed - Indicates that the Voice calls associated with the Campaign have been completed.
• Scheduled - Indicates that the Voice Campaign has been scheduled for a later date or time.
• Failed - Indicates that the Voice Campaign failed to be submitted to the channel.
• In Progress - Indicates that the Voice calls associated with the Campaign are currently being made.

📘

Note:

Only one option can be selected from the Select Status field.

8. Click Apply. The Campaigns list as per the selected filters appears.

9. Click Clear all filters to delete all the applied filters.
10. On the Campaigns page, click Launch Campaign. The Launch Campaigns page appears.

The Launch page has the following three sections to capture all the necessary details before you launch a campaign.

• Create Campaign
• Compose Message
• Review and Publish

Create Campaign

The Create Campaign section of the Voice Launch page helps you to create a campaign and upload the desired number of contacts.

The Create Campaign section has the following fields:

Campaign Name - Enter your Campaign name (unique).

📘

Note:

Only alphabet, numbers, space, hyphens, and underscore are allowed.

Import Contacts

The Import Contacts section has the following options:

• Upload .csv or Excel file (Recommended)
• Import from Directory
• Copy & Paste Numbers

Upload Contacts using the .csv or Excel file option

To use the .csv or Excel file option perform the following steps:

1. Click Upload .csv or Excel file. The Upload .csv or Excel file page appears.

2. You can drag and drop .CSV or Excel files or click to upload a file.
3. Click Download sample file to download the sample .CSV file. You can use this file as a reference to upload your contacts. A message "File Uploaded Successfully" appears.

All the columns in the uploaded file will be listed in the Relevant Column from the uploaded file list.

4. In the Relevant Column from uploaded file list, select the column name where mobile numbers are listed in your file. If the uploaded file does not contain country codes prefixed, select the Doesn’t Include Country Code checkbox and select the applicable Country Code from the drop-down.

📘

Notes:

• If the uploaded file does not contain Country Code prefixed mobile numbers, then select the Doesn’t Include Country Code? checkbox and search for the appropriate Country Name or Country Code from the list.
• In the search bar, you are not required to prefix the Country Code with a + symbol.
• Additional columns can be added to pass relevant information. These column headers can be used as variables while composing the message for personalization.
• The maximum limit to Import contacts is 100,000.
• You need to upload at least one contact to proceed.

5. Click Import. You can view the contacts that have been imported.

6. Click Remove all Contacts to clear anything that has been uploaded or added.
7. Click Cancel to cancel and return to the Campaigns listing page.

Import Contacts using the Directory option

To use the Directory option, perform the following steps:

1. Click Import from Directory. The Import from Directory page appears.

2. Select the required contacts, and click Import. For more information regarding Directory, refer to https://developers.kaleyra.io/docs/directory-overview.
3. Click Select All to select all the contacts in the list.
4. Click Unselect All to remove the contacts from the list.

📘

Note:

Contact information other than numbers is not imported from directories. Personalization using dynamic variables is therefore not possible.

View the Search and Filter option

To view the Search and Filter options, perform the following steps:

1. Click Import from Directory. The Import from Directory page appears.

2. In the Search for Contacts field, enter the number or partial mobile number for which you wish to search and click Filter. The available filter options appear.

3. Contacts added in the Directory can be imported to the campaign by filtering based on Name, City, Country, or Tag.

Import Contacts using the Copy & Paste Numbers option

To use the Copy & Paste Numbers option, perform the following steps:

1. Click Copy & Paste Numbers. The Copy and Paste Contacts page appears.

2. Contact numbers can be directly added to the campaign by manually entering them or copying and pasting the list of phone numbers separated by a newline.

📘

Notes:

• This method is not recommended for large campaigns (if you have more than 100 contacts, use a CSV or Excel file to import your contacts).
• If you have not entered the Country Code, select the Doesn’t Include Country Code? checkbox and search for the appropriate Country Name or Country Code from the list.
• In the search bar, you are not required to prefix the Country Code with a + symbol.

3. Click Import. You can view the contacts imported under the Create Campaign section.

4. Click Next, after adding contact numbers to send the Voice message. The Compose Message section is enabled.

Compose Message

The Compose Message section of the Voice Launch page helps you to create the Voice message body.

There are four ways in which a voice message can be added to the campaign:

• Text-to-speech
• Select Audio
• Upload File
• IVR Flow

Text-to-speech

The text that is entered in the textbox will be converted to speech using Text-to-speech functionalities.

The Text-to-speech section has the following fields:

• Speech rate - Select the speech rate from the list at which the message should be played.
• Language - Select the preferred language from the list. The languages supported are English (US), English (IN), Italian, Spanish, Hindi, Kannada, Telugu, Tamil, Malayalam, Gujarati, Punjabi, and Bengali.

📘

Note:

• Indian regional languages ​​are available by default in the IN region. However, they can be used by customers belonging to other regions by reaching out to our support team.
• The numerical entered will be translated to the selected language automatically.

• Message - Enter the text that should get played as speech. Click on the required header to use them as a variable in the message.

📘

Note:

You can add dynamic variables using @, { }, and {{ }} symbols to get the values of column headers or variables from the uploaded. CSV or Excel sheet.

• {*} Set Default Variables
  a. Click {*} or Set Default Variables. The Set Default Variables section appears.

b. Enter the default value in the text box. Default values can be set for each variable configured in the message. These values will be replaced when there is no data available for the respective variable/column in the sheet.

c. You can enter the desired values (the values entered here will be used if there are no values associated with the record in the .CSV or Excel file).

d. Click Save.

• Preview - You can view the preview message that has been added under the Message section. Click the audio icon to hear the message.

• Number of Retries - This is a mandatory field and represents the number of retries for each single call done inside the campaign to any given number. The retry is applicable for Failure scenarios.

• Send this campaign - You have the option to send the campaign now or at a later time.
  • Now
    • Select Now to send the campaign immediately.
  • Later
    • Select Later to schedule the campaign at a later time by selecting the Day and Month from the Calendar icon (for 90 days).
    • Select the time from the list and click Apply.

Select Audio

The previously uploaded audio files are displayed when the Select Audio option is chosen. Click on the preferred file to be used for the campaign and proceed further.

📘

Note:

• The maximum file size is 10 MB, and the supported formats are mp3 and .wav.
• Audio files can be uploaded under the Voice channel in the Sound Manager section.

• Number of Retries - For more information related to the Number of Retries field, see the Text-to-Speech section.
• Send this campaign - For more information related to Send this campaign field, see the Text-to-Speech section.

Upload File

The Audio files can be directly uploaded to the campaign. Upload a new sound file from the system you wish to use in the campaign. The uploaded sound file will be saved under Sound Manager for easy access.

The Upload File has the following fields:

• Title - Enter the title in the text box. You can drag and drop the mp3 or WAV file or click to upload a file.

📘

Note:

• Only alphabet, numbers, space, hyphen, and underscore are allowed for the Title.
• The maximum file size is 10 MB, and the supported formats are mp3 and .wav.

• Number of Retries - For more information related to the Number of Retries field, see the Text-to-Speech section.
• Send this campaign - For more information related to Send this campaign field, see the Text-to-Speech section.

IVR Flow

A flow published in the Flow Builder can be linked to the campaign using IVR Flow. This linking enables you to leverage the capabilities of Flow Builder within Voice campaigns. The flow is executed when the call is answered by the end customer.

All the column headers part of the uploaded sheet can be used as variables within the Flow. The format is {{payload. variable}} and is supported by the following widgets: Play, IVR Menu, Keypress, Repeat, SMS, Email, and Choice.

The IVR Flow has the following fields:

• Select Flow - Click the arrow next to the Select Flow field to view the list. All the published flows are displayed in the list and they are searchable.
• Number of Retries - For more information related to the Number of Retries field, see the Text-to-Speech section.
• Send this campaign - For more information related to Send this campaign field, see the Text-to-Speech section.

Click Next. You can view the Review and Publish section.

📘

Note:

The documentation for the Flow Builder is available here.

Review and Publish

You can view the summary of the campaign.

The Review and Publish section has the following fields:

• Campaign Summary - The summary of the campaign (Total Contacts, Total Units, Scheduled on, and Estimated Cost) is displayed here for review.

• Estimated cost - The estimated cost is calculated based on the tentative duration of each call and the pricing set for the account. If you are a prepaid customer, the equivalent amount of money will be deducted when the campaign is published and if it is not completely used up, the unused amount will be refunded after the campaign ends.

📘

Note:

• Campaigns cannot be deleted once published.
• The credits will be adjusted based on the actual cost after campaign completion.

Click Publish. You can track the status of your published campaigns on the Campaigns listing page.

Schedule a Voice Campaign

You can choose to launch a campaign as soon as you create it (now) or send it later. While scheduling the campaign launch, you can also choose to split the campaign into different batches of 1000 contacts (minimum) and launch them at a time interval of 15 minutes and up to 75 minutes.

To launch the Voice Campaign Immediately, perform the following steps:

1. On the Compose Message section, select the Now option in the Send this campaign field.

2. Click Next. The Voice campaign is launched.

To schedule a Voice campaign for a later date and time, perform the following steps:

1. On the Compose Message section, select the Later option in the Send this campaign field.

2. Select the date and time from the Calendar at which the campaign should be scheduled. By default, the current date is displayed.
3. Select the Split Campaign Schedule check box if you want the campaign to be split into batches. (available only when there are 1000 (or more) contacts.
4. Enter the number of contacts to select in each batch. For using the split option, you must have 1000 (or more) contacts.
5. Select the time interval between the batches to be published. Available time intervals are 15, 30, 45, 60, and 75 minutes.

Click Next. The Review and Publish page appears. For more information see, the Review and Publish section.

Edit scheduled batches of Voice campaign

You can use the Edit option to change the batch time to be published (the new time should be more than 15 minutes from the current time).

To edit a schedule batch of Voice campaigns, perform the following steps:

1. On the Campaign Listing page, click the down arrow button to view the list of scheduled batches.

2. Click on the three dots next to the Scheduled status column.

3. Click Edit. You can change the Scheduled time based on your preference.

Delete scheduled batches of Voice campaign

To delete a scheduled batch of voice campaigns, perform the following steps:

1. Click on the three dots next to the Scheduled status column.

2. Click Delete. A confirmation pop-up appears.

3. Click Yes, delete batch. The selected batch will be deleted with the status Deleted.

📘

Note:

You cannot delete or reschedule campaigns when they are in process.