Introduction to the Campaign Manager

Mitto’s SMS Campaign Manager makes it easy to create and manage all your SMS campaigns. Import your contacts quickly. Create campaigns and get real-time, detailed data about the SMS messages you send.

This guide provides details about all features of the Campaign Manager.

If you want to send SMS outside of the Campaign Manager, check out our SMS API documentation.

If you need to sign up for Campaign Manager credentials, you can go here: https://www.mitto.ch/contact/

Set Up and Log In

Log in to the customer portal to get started. After you log in, you will be able to:

  • Upload contacts and contact lists.
  • Create SMS campaigns for your customers.
  • Get data insights and statistics about your campaigns.
  • Track message history.

To get started, do the following:

  1. If you are brand new, contact Mitto through info@mitto.ch and request the Campaign Manager. You can also click here in the sentence Get started here at the bottom of the Campaign Manager Login Screen. Otherwise, go to https://dashboard.mitto.ch to get started logging in.
  2. Contact your Account Manager and request credentials for the Campaign Manager.
  3. Enter your email address and password in the corresponding fields.
  4. Click Log In. If your log in is successful, you are taken to the Dashboard screen.

NOTE: If you forgot your password, click Forgot Password, enter your email address in the field provided, and click Send.

NOTE 2: For security reasons, if you do not use the Campaign Manager for more than 30 minutes, the Campaign Manager automatically logs you out. Remember to regularly save your campaigns, or any draft action. If you see the loading symbol appears for more than few seconds you may need to log in again.

Toolbar

When you first log in to the Campaign Manager, you arrive at the  Dashboard screen. The top righthand corner of the screen offers some helpful tools that appear on every page. This is referred to as the toolbar.

Left to right you have:

  • Title of the section you are in. In this example it’s Dashboard.
  • Information balloon with an i – Tooltips
  • Bell with number of notifications listed – Notifications
  • Avatar portrait and email address – Account Settings

Tooltips

When you click the Tooltips icon, you get a dark gray information box that appears for the first field in the screen you are on. The information box provides a description of each field on the screen. To cycle through, click the purple Next button. To the right of the word Next on the button is a counter that shows you how many fields there are to cycle through for descriptions. For example you might see Next 1/8. That means there are eight descriptions on the page and you are viewing the first one. If you do not want to cycle through all the descriptions, click Exit to go back to your screen.

Notifications

When you click the Notifications icon, you get a panel containing the most recent three notifications sent to you. You can click Mark All as Read at the bottom right corner of the panel to get rid of the number over the Notifications icon. (The number represents how many new notifications you have.) You can also click Show All. If you do this, the Campaign Manager takes you to the Notifications screen.

The screen includes all the features detailed in the table.

Screen Feature Description
Search Bar The search bar lets you type a term that may be found in the Content section of the Notifications table. Click the Magnifying Glass icon to run a search.
Magnifying Glass icon, Filter By Click on the Magnifying Glass icon or Filter By to open a panel on the right side of the screen. This is the Filter panel. You can use the drop-downs to search by Status, Type, and Tag. For each of them you can check or uncheck the boxes to indicate which criteria you want to include in your search. If you choose not to run the search, click Cancel at the bottom of the panel. If you want to run the search, click Search at the bottom of the panel.

Drop-down Choices
Status You can search by the status of a notification.

  • Unread – You haven’t read the notification yet.
  • Read – You read the notification.
  • Archived – You archived the notification.
Type You can search by what type of notification you received.

  • Success – A task was successfully completed.
  • Error – Something went wrong.
  • Warning – Something might need your attention, review to learn more.
  • Info – An update to let you know the status of something, when there are no issues.
Tag You can search for notifications tagged as being about a specific kind of content. Choices include:

  • Distribution list – Search for notifications about lists of contacts you created.
  • Campaign – Retrieve notifications about campaigns you set up.
  • Email confirm – Look up notifications about email confirmations.
  • Budget – Find notifications about budget for your different campaigns.
Heading Checkbox and Row Checkbox The heading checkbox lets you select all items on the page. When this happens, a purple bar appears at the bottom of the screen. You can choose whether to mark all items as unread, read, or archive them. If you use a checkbox in one of the rows, you can make the same choices, but only for that row or rows that you click the checkbox for.
Type The type column displays an icon representing either Success, Error, Warning, or Info. You can hover your mouse over the icon that appears here to see which one it is.
Content The content of the notification appears here.
Tag The tag tells you generally what the notification is about. You will see either Campaign, Distribution list, Email confirm, or Budget.
Creation Date The date the Campaign Manager created the notification.
Items per page Drop-down You can set the items displayed per page using the drop-down. Available choices are 15, 25, 50, and 100.
Page Selector You can use the page selector in the bottom right corner to move back and forth between pages of notifications.

Users

The Users screen is available to Administrator accounts, the User manager, and any custom account where you offered this privilege.          

 

Screen Feature Description
Search Bar Enter the name of a user or part of a name to search for them in the list of accounts.
Invite user Use this panel to invite a new user to the Campaign Manager. In the Name field you put their name as it will appear in the tool. For Email, put their email address. For Permissions, you can choose a role or choose custom permissions. Roles include:

  • Campaign manager – Access to DistributionLists, Campaign, QuickSend. This role can create and manage SMS campaigns.
  • Administrator – Access to all features.
  • Reporting manager – Access to Statistics, MessageHistory. You can review what messages were sent, and where and when SMSes were delivered.
  • User manager – Access to Users, TrafficAccounts. You can add and remove users from specific traffic accounts.

Traffic accounts give users privileges within the Campaign Manager. To send campaigns, you must add a user to an active Traffic account of type Campaign. To use the analysis and delivery information tools, you can add a user to any account type, active or inactive. You can add a user to more than one account type if you like. When you are done, click Save.

Name The name of the user.
Email In the picture, the email is hidden, but normally you will see the user’s email in this column.
Presets This column tells you the user’s role. If they have a preset account, you will know the privileges that way.
Status Status choices include Active, Pending, and Inactive. Active means the user accepted the account and set it up for themselves. Pending means you are waiting for the user to join the Campaign Manager. Inactive is for users that haven’t been in the system in awhile, or where you want to temporarily pause their privileges.
Action You can use the pencil icon to edit the configuration for the user’s privileges and account access. Click the pause icon to make a user inactive, or active again. You can delete a user altogether by clicking on the trash can, then clicking OK on the pop-up.

Account Settings

The Settings screen lets you update information like your contact information and password.

The screen features are described in the table.

Screen Feature Description
Email The email you use to log in to your account.
Name Your name. This will be used in correspondence with you.
Phone (E.G. +15417963010) A phone number that can be used for correspondence with you.
Update Click this button to update any of the fields in the General section of the screen.
Current Password If you want to change your password, you enter your current password here.
New Password Enter the new password you want to use here. Your password must have at least 8 characters, include an upper case letter, a lower case letter, a number, and a special character.
Confirm Password Type your new password a second time to confirm it.
Update Click Update to update your new password.

Dashboard

The Dashboard screen is what you see when you first log in. It provides at-a-glance information about your SMS traffic, cost, and delivery.

The Dashboard screen’s data is described in the table.

Screen Feature Description
SMS Traffic Drop-down Use the drop-down in the right corner under the toolbar to choose how many days of SMS traffic you want to show. Choices include:

  • Today
  • Yesterday
  • Last 7 days
  • Last 30 days
  • This month
  • Last month

Adjusting this will adjust the graph showing how many messages were sent over time.

SMS Traffic graph The graph shows number of messages sent along the y-axis, and the time period along the x-axis. The time period can be changed using the SMS Traffic Drop-down.
SMS Traffic Quantity The amount of SMS messages sent in the time period you chose in the drop-down.
SMS Traffic Cost The cost of all the SMS messages for the time period you selected.
SMS Traffic Delivery Rate The percentage of successful SMS messages delivered in the time period you selected.
Delivery status breakdown A chart showing you the percentage of undelivered SMS in purple and the delivered SMS in gray.
Country breakdown The breakdown by country of messages you sent.
Shortcuts This tile provides a shortcut to:

  • Add Distribution List where you can import contacts for additional SMS campaigns.
  • Create Campaign where you can create new campaigns.

Distribution Lists

A distribution list is a list of recipients you want to target with a campaign. In the case of the Campaign Manager, it’s a list of phone numbers you want to receive an SMS.

The Distribution Lists screen’s features are described in the table.

Screen Feature Description
Search Bar Click in the field beside the magnifying glass to type a search term. The search bar is for searching through exact matches in the Name column, and is not case sensitive.
Add Distribution List If you click the Add Distribution List button, the Add Distribution List panel opens on the right side of the screen. Here you can put the name of a new distribution list in the List Name field. You can search for existing lists to upload by clicking the Browse button. To see a sample of the format you use to upload a new list, click the Download sample button. The format is also provided in this table.

PhoneNumber Placeholder1 Placeholder2 Placeholder3
491796548754 Beau Harrison 303 South Harvey Drive
491796548754 Russell Hayden 473 W. Thomas St.
491796548754 Renee Cameron 7827 Circle Court
Name The name of the distribution list.
Status The status of your campaign. Statuses include:

  • Ready – The campaign is ready to be delivered.
  • In Progress – The campaign is currently being delivered.
  • Faulted – There were multiple errors with the campaign and it was not delivered.
Campaign The number of successful campaigns associated with the distribution list. A faulted campaign will not be included in the total.
Entries The total number of contacts on the distribution list.
Creation Date The date the distribution list was created. If you see an info icon you can click it to see additional details about the distribution list.
Action This displays actions you can take on the distribution list. You can click the eye icon to preview the distribution list. This will let you look through the entries in the list. You can click the trash can to delete the distribution list. A pop up warns you that the deletion is permanent. If you are fine with that, click the Ok button. Otherwise, choose Cancel.
Items per page Drop-down You can set the number of items that appear per page. Choose from 10, 25, or 50.
Page Navigator You can click back and forth through pages of distribution lists, using the page numbers or the left and right arrows.

SMS

The SMS option in the menu on the left side of the screen opens to reveal three different screens:

  • Campaigns – Review all of your campaigns at a glance.
  • Create Campaign – Create a new campaign.
  • Quick Send – If you want to send a campaign to a group that you will manually type in number by number rather than using a distribution list, go here.

Campaigns

The Campaigns screen shows you all your campaigns at a glance. Phone numbers have been covered except for the first digit for privacy.

The features of the screen are discussed in the table.

Screen Feature Description
Search Bar Click in the field beside the magnifying glass to type a search term. The search bar is for searching through exact matches in the Name column, and is not case sensitive.
Create Campaign Click Create Campaign to open the Create Campaign screen. This screen is discussed in the Create Campaign section.
Name The name of the campaign.
Sender The name or phone number for the sender of the campaign.
Created Date The date the campaign was created.
Schedule Date The date you scheduled for the campaign to run. If you did not schedule a date, this is blank.
Sent/Total Status The number of messages successfully sent, divided by the total number of messages sent, and multiplied by 100.
Actions You can choose between two actions here. You can click the eye icon to view campaign details. You can click the stack of papers icon to clone the campaign. A pop up will appear asking you for a name to save a cloned copy of the campaign. Enter the name and click Save. If you don’t want to clone the campaign, you can click Cancel to exit the pop-up.

Campaign

The Campaign screen shows you details about a specific campaign you clicked on from the Campaigns screen.

The table provides details about the screen features.

Screen Feature Description
Campaign Title The campaign title is in the upper left corner of the white
Campaign Status The campaign status displays what phase the campaign is in. The status may be one of:

  • Inactive – The campaign is not currently underway.
  • Scheduled – The campaign is scheduled to run.
  • Processing – The system is preparing to run the campaign.
  • Active – The campaign is active, with customers receiving their SMS messages.
  • Paused – The campaign is on pause. Any SMSes that were not yet sent will not be sent. A percentage will show you how much of the campaign ran before it was paused.
  • Canceled – The campaign was canceled.
Distribution Lists This section contains two rows. The first row displays the name of the distribution list (in the example QL2) and how many rows are in the list (03). The second row tells you how many recipients are in the list (03).
Sent The number of SMS messages that were sent at this point in the campaign. If the status is something besides Completed you may see this number continue to change until completion.
Total The total number of SMSes sent after the campaign completes.
Sender The name or phone number for the sender of the SMS campaign.
Message The message sent for the SMS campaign.
SMS Count How many SMS are sent to ensure the full message reaches each recipient.
Characters The total number of characters in the SMS.
Clone campaign If you want to make a copy of this campaign to use for another campaign, click the Clone campaign button.
Message preview See how the message will appear on a cellphone.
Character count – SMS count The number of characters in the message. The number of SMS messages it will take to send the complete message. This is usually a single message.
Campaign Name The campaign title is repeated at the bottom of the preview for reference.

Create Campaign

Use the Create Campaign screen to build a new SMS campaign.

The Create Campaign screen is described in the table.

Screen Feature Description
Sender & Recipients This is a tab that lets you fill out details about your campaign. It is the only tab you can use when you first fill in information for your campaign.
Campaign Name Enter the name of your new campaign. If you hover over the balloon icon to the right of the field, you can see that your title may be from 3 to 50 characters long.
Sender Enter an alphanumeric name for the sender up to 11 characters long or a number up to 16 characters long. If you hover over the balloon icon, this information is repeated.
Recipients Click the Select Distribution List button to choose the distribution list you will use for the campaign. The Select Distribution List panel opens. Enter a search term in the search bar, or use the page navigator to browse through the pages for the list you want. You can see how many recipients will be included at the bottom of the panel. When you choose a list, click Save to use the list and return to the main screen. You can also click Cancel if you want to exit the panel without making a selection.

If you check the Personalize checkbox, you can open the Placeholders panel. Enter a placeholder in the Define Placeholders field and click Add. You can now map this to a column name from your chosen distribution list using the Personalize drop-down. You may add up to two placeholders. These can be inserted into your message, and they will be automatically populated with the value from the column in the table. In this way you can personally address people in your messages. Click Save when you are done mapping on this screen, or Cancel if you don’t want to map anything.

 

Next Step Click the Next Step button to go to the next tab and craft your message.
Message & Preview The Message & Preview tab lets you add a message and see how it will appear on a cellphone.
Campaign Name The name of the campaign appears here, and the field is editable.
Message Enter the content of the SMS you want send. If you used placeholders, the Placeholders button will be active. Click Placeholders when you want to insert a placeholder into your message.
Recipients The number of customers who will receive your SMS.
Messages The number of SMSes each recipient will receive. It’s usually 1, but if you write a long message, it may be more.
Characters The number of characters in the message you want to send.
Message preview The preview screen shows your message. If you use placeholders, it provides an example of the placeholder correctly used for the first recipient in the distribution list. You can use the arrows at the bottom of the preview to move through the recipient list to see how each message will be customized.
Schedule If you click the Schedule button, you will bring up a Schedule Time field. You can add when you want the campaign to kick off using DD/MM/YYYY HH:mm format.
Save You can save your work by clicking Save.
Launch You can launch your campaign immediately if you are ready. If you added a scheduled day and time, the campaign will launch at that day and time. Pushing this button immediately readies the campaign to launch.

Quick Send

The Quick Screen is for when you want to send an SMS campaign without setting up a distribution list. It’s best for smaller campaigns since you must manually provide all the recipient information.

The table describes the Quick Send screen.

Screen Feature Description
Sender Enter the sender name or phone number you want to send the campaign from.
Recipients (E.G. +15417543010) Enter the phone number for each recipient. Press return or enter on your keyboard. It will create an icon for the number. You can delete it by clicking the X next to the number, or by pressing delete twice. You cannot enter more information about the recipient than the number.
Message Enter the content for the SMS you want to send.
Messages The number of messages sent. This updates after you press the Send button.
Characters The number of characters in the SMS you want to send.
Recipients The number of recipients you will send your message to.
Message preview You can see how your message will appear on a phone. You cannot personalize it.
Reset form Click this button to reset the form and start over.
Send Click this button to send your campaign to the recipients. The campaign begins processing immediately. You cannot schedule it for a later time here. If you want to do that, use the Create Campaign screen.

 

Traffic Accounts

The Traffic Accounts screen shows you details about the different kinds of traffic accounts you have. Depending on what kind of account you have for your users to connect to, different privileges are available in the SMS Campaign Manager.

 

Screen Feature Description
Account Name The name of the traffic account.
Display Name The name you want users associated with the traffic account to see.
Account Type There are three account types:

  • HTTP – This account type is for reviewing and tracking SMS delivery through the Campaign Manager. Messages are sent outside of the tool.
  • SMPP – This account type is also for reviewing and tracking SMS delivery through Campaign Manager. Messages are sent outside of the tool.
  • Campaign – This account type allows you to create and manage campaigns alongside analysis and tracking of SMS delivery.
Status Status can be Active or Inactive. Active means the account is available for use. Inactive means it is not available for use, so you will not be able to create campaigns or review details about SMS messages.
Action You can click the pencil icon and edit the display name for the account name.
Page Navigation At the bottom of the page you can click the arrows to either side of the numbers if there is more than one page, or click the numbers to move between pages of accounts. You can use the drop down to set the items displayed to be 10, 25, or 50.

Statistics

The Statistics screen displays details about groups of messages that were sent. Messages are grouped into batches based on criteria you select. The columns will change based on the criteria you choose and show you how many were sent, delivered, undelivered, and transmitted.

 

Screen Feature Description
Filter By Date If you click in the field under Filter By Date, a menu and calendar pops up. You can use this to filter for the time period you want the message history for. The menu lets you choose from:

  • Last 10 minutes
  • Last hour
  • Today
  • Yesterday
  • Last 7 Days
  • Last 30 Days
  • This Month
  • Last Month
  • Custom range

If you click in the calendars, the first calendar is for the start of the time period you want messages for, and the second calendar is for the end of the time period you want messages for.
When you have made your choices, click Apply to filter.

Filter By Click the Filter By button and the Filter By panel appears on the right side of the screen. You can search by:

  • Account – the account name.
  • Country – the name of the country.
  • Network – the network carrier.
  • Network Code – the network code.

Each one allows you to search using a set of conditions:

  • Equal – an exact match for the term you type.
  • Not equal – a match for anything that does not match the term you type.
  • Starts with – anything that starts with the term you type.
  • Ends with – anything that ends with the term you type.
  • Contains – anything that contains the term you type.
  • Does not contain – anything that does not contain the term you type.
Group By The Group By button brings up the Group By panel on the right side of the screen. This allows you to decide how to group statistics information in the columns. Check a box to group by that criteria, or uncheck a box to ungroup by that criteria. Choices include:

  • Year – the year messages were sent.
  • Month – the month messages were sent.
  • Day – the day messages were sent.
  • Account – the account that sent the messages.
  • Country – the country messages were sent to.
  • Network – the network the messages were sent through.
  • Network Code – the network code for the network that sent the messages.
  • Price – the cost of each message.
Table Columns These change based on how you choose to group batches of messages. However you group them, you will always be able to find out:

  • Sent – how many messages were sent.
  • Delivered – how many messages were delivered.
  • Undelivered – how many messages were not delivered.
  • Transmitted – how many messages were transmitted and did not arrive.
Items per page drop-down Choose how many items to display per page. You can set it to 15, 25, 50 or 100.
Page navigator Click on the page numbers or arrows to navigate through the filtered messages.
Export as Excel Click the Export as Excel button to download all messages in the table to an Excel file.

Message History

The Message History screen provides details about every single message that was sent for your campaigns. (The numbers are blocked out past the first digit for privacy.)

The table provides details about the features of the Message History screen.

Filter By Date

If you click in the field under Filter By Date, a menu and calendar pops up. You can use this to filter for the time period you want the message history for. The menu lets you choose from:

  • Last 10 minutes
  • Last hour
  • Today
  • Yesterday
  • Last 7 Days
  • Last 30 Days
  • This Month
  • Last Month
  • Custom range

If you click in the calendars, the first calendar is for the start of the time period you want messages for, and the second calendar is for the end of the time period you want messages for.
When you have made your choices, click Apply to filter.

Screen Feature Description
Filter By Use the purple Filter By button to search by the contents of any field except the sent date, which is handled by the Filter By Date field. The choices include:

  • Receiver – The phone number for the recipient of the message, or a part of a phone number.
  • Sender – The name or phone number for the sender of the message or a part of the name or phone number.
  • Message ID – The unique identifier for a sent message.
  • Country – The country the message(s) were sent to.
  • Network – What network the message was sent through.
  • MCCMNC – Mobile Country Code or Mobile Network Code
  • Delivery Status – The delivery status for the message(s). It can be Delivered, Submitted, or Undelivered.
  • Error Code – If you know what error code occurred for messages you can use that to search.

When you are done, click Search to filter for messages or Cancel to cancel the search.

Column Options Choose columns you want to display on the Message History screen. Check a box to display, or uncheck to stop displaying a column. The choices include:

  • Sent Date – the date the message was sent.
  • Receiver – the phone number of the message recipient.
  • Sender – the phone number or name of the message sender.
  • Country – the country the message was sent to.
  • Network – what network the message was sent through.
  • MCCMNC – the mobile country code or mobile network code.
  • Error Code – the error code that explains why a message was not delivered.
  • Delivery Status – whether the message was delivered or not.
  • Delivery Date – the date the message was delivered.
  • DLR Time – how long it took to deliver the message.
  • Price [EUR c] – how much the message cost, in euros.
  • Unicode – whether the message was sent in unicode.
  • Message ID – the unique identifier for the message.
  • Account – the account associated with the message sender.
Checkbox If you click the checkbox by the table header row, it will select every message on the current screen. Otherwise, you can select messages individually by clicking the checkbox next to the message or messages you want.
Column Headings These headings are described in the write up for the Column Options button. You can pick and choose what columns to display using that feature.
Page navigator If there is more than one page of messages for your search, you can click available page numbers or use the left and right arrows to browse.

What’s New

 

Date Feature Description
Nov 23 2020 Settings
The Settings page is now divided into three tabs offering:

  • General settings – User info, Profile image, Language
  • SMS settings – Unicode feature, Default sender ID
  • Password reset
Nov 23 2020 Additional options in the Toolbar The More button opens a drop-down menu with useful information.
Nov 23 2020 Verified SMS by Google Mitto, as a Google Partner, offers Verified SMS (https://mittoc/products/verified-sms). To register an agent on the Google platform, please use this form to submit your data.
Nov 23 2020 White-label mode The white-label mode offers the option to change the look & feel of the tool, enabling a branded user interface.