Learning Hub / Tutorials / Voxtelesys / missio™: Campaign ManagementFAQs

Tutorials: missio™: Campaign Management

Learn how to use missio™ Campaign Management in the Voxtelesys Portal.

Log in to the Voxtelesys Portal

campaign managment location in the voxtelesys portal



Navigate to "Campaign Management" which is located under the "missio™" drop-down in the "Products" category.

create campaign button



Click "+Create Campaign"

campaign details



Campaign Details

Under Campaign Details, enter your Campaign Name and Campaign Description (Optional).

channel and template selection



Channel and Template Selection

Under "Channel and Template Selection" select the following:

  • Channel Type: Messaging, Voice, or Email.
  • Flow: Desired Flow to associate with the channel.
  • Number or Username: The desired phone number or email username to asscoiate with the Flow.
add another channel

Channel and Template Selection

To add another channel click on "Add Another Channel".

You can add up to 3 Channels, one for Messaging, one for Voice, and one for Email.

information icon
Important Note:
The “From Email Username” field refers to the username of the email address, not the entire email address. This is because the Domain is defined in the flow's Email Widget.

campaign with multiple channels



Channel and Template Selection

To the right is an example of a Campaign with multiple channels:

click next in campaign information



Once you have added the desired channels for your Campaign, click "Next".

Setting up Your List for Mapping

Before you upload your list, structure your CSV so the system knows who to send the Campaign to and which channel to use. Take a look at our sample .csv file for more details.


Required Variables

There are two variables/columns that your CSV must include:

  • Recipient ("to (recipient) (Required)"): This should be either a phone number (if you’ll send via messaging or voice), or an email address (if you’ll send via email).
  • Channel ("channel_type (Required)" ): This must specify which channel: "Voice," "Messaging," or "Email."

For example, if the channel for a row is email, then the recipient must be an email address. Similarly, if the channel is messaging or voice, the recipient must be a phone number.


csv file


Recipient and Channel are required fields that define where and how your Campaign sends messages. You’ll map these in the ‘List Mapping & Validation’ step rather than in your flow.

Your CSV column headers don’t have to be named exactly ‘to (recipient) (Required)’ or ‘channel_type (Required)’. You’ll assign them during the Mapping step. Just make sure the data in those columns is valid, such as phone numbers, email addresses, or channel names.


Preparing Your CSV to Deliver Messages to One Recipient via Multiple Channels

Messaging, Voice, and Email must each be on their own line. If a contact can be reached through all three channels, they will need to appear as three separate rows in the spreadsheet.

For example, if a contact is reachable through Voice, Messaging, and Email, a separate row must be created for each channel, each with the corresponding recipient information.


csv file

If you need to reference the recipient inside your flow, use: contact.channel.address This value is automatically used by the Outbound Call and Send & Wait widgets.


Accessing Other Variables

All other variables can be accessed in the flow using this format: {{ flow.parameters.<variableName> }}

For example, if you mapped a column to firstName, use: {{ flow.parameters.firstName }} in your flow.

Note: Flow parameters and variables from selected email templates are the only variables grabbed from the flow's selected in the first step. Flow parameters are formatted like so: {{ flow.parameters.<value>}}

list upload field


List Upload

Upload your CSV. Required fields include channel_type and recipient (to).

These are the guidelines for file upload:

  • We only support CSV files.
  • We have a maximum size limit of 5MB for CSV files. Your selected trunk group may be configured to have a smaller maximum file size.
  • All rows must use only ascii characters.

Once you have uploaded your list, click "Next"

list mapping and validation drop-down



Map and Validate Your Variables

Under list Mapping and Validation you are able to map and validate the variables you uploaded.

To exclude a column click on the green checkbox to deselect.

Under "Map to a Flow Variable" there is a drop-down to select variables.

variable drop-down

Map and Validate Your Variables

Recipient and channel are required variables that must be set during this step.

  • The "recipient" variable requires either a phone number or an email address.
  • The "channel" variable must be one of “Voice,” “Messaging,” or “Email”.

Only variables that are mapped during this step will be sent to the flow.

For more details on "channel" and "recipient" please refer back to Step 5. If you need further help, please open a Support Ticket in the Voxtelesys Portal.

validate button



Map and Validate Your Variables

Once you have mapped required and desired columns, and excluded the desired columns click "Validate".

list upload summary


List Upload Summary

After clicking "Validate" you will view a List Upload Summary:

  • Total Recipients Imported: The total number of recipients imported successfully.
  • Failed Imports: The total number of recipients that failed to be imported.
  • Errors: The total number of recipients that had errors during import.

You will have to go through the validation process again if you Re-Upload your list. For more details regarding Failed Imports and Errors you can download a full report under "Upload List Report".

Once completed, click "Next".

test box with no variables to set



Testing With No Variables to Set

Testing your Campaign is optional.

If you have only mapped “recipient” and “channel,” then you will have no variables that need to be set for testing.

You may send a test immediately.

information icon
Important Note:
Since these tests execute flows, you will be charged as they normally would for executing flows and using voice, messaging, and email services. There are no new charges related to missio. Behind the scenes, missio just executes flows with the provided parameters.

testing with variables to set



Testing With Variables to Set

You must set variables before you can test your flow.

defien variable box

Testing With Variables to Set

These variables are sent to the flow the user initiates and the defined email address or phone number is the address the flow is sent to.

This effectively replaces the “recipient” field in the variable mapping. There is no need to map the “channel” field as all channels are tested individually.

Enter the data that will be used by the test using the variables you have predefined and click "Confirm".

schedule your campaign



Schedule Your Campaign

Choose to send your Campaign immediately or schedule to send your Campaign later.

If you choose to "Send Later" then fill out the fields in the "Schedule Your Campaign" section.

information icon
Important Note:
Only users that have the manage/view campaigns permission may be selected to receive updates about the campaign progress.

set up notifications section



Set Up Notifications

If you would like to be notified about campaign progress enable "Set Up Notifications".

Click "Next".

review and submit step



Review Your Campaign

Review your Campaign and click "Submit".

campaign management table

Name: Name of the Campaign.

Status: Active, Draft, or Completed. "Active" status means that jobs are either in progress or scheduled. "Not Active" status means there are no completed jobs or drafts. "Completed" means that all jobs have been completed.

GUID: The Campaign's unique ID.

Actions: Stop Campaign, Edit Name & Description, Send a New Job, Duplicate Campaign, and Delete Campaign.

Campaign Details

Click the blue arrow to view Campaign Details in the Campaign Management Table.

Under Campaign Details you can view Job ID, Channels, Created Date, Scheduled Date & Times, Sent At, Status, and Actions.

Actions include: Edit, Stop Job, and Delete

Statuses under Campaign Details:

  • Draft: Campaigns that are in progress but not yet submitted.
  • In Progress: Campaigns that are currently being executed.
  • Completed: Campaigns that have been successfully executed.
  • Failed: Campaigns that encountered errors during execution.
  • Stopped: Campaigns that were stopped
  • Scheduled: Campaigns that are scheduled to be executed.

campaign details drop-down

Under Campaign Details you also have the option to Refresh Your Campaign, Go to missio™ Reports, and Send Another Job.


campaign options to refresh go to repors and to send another job

Learning Hub / Tutorials / Voxtelesys / missio™: Campaign ManagementFAQs