SMS - Docs

The 2mee platform can send Hologram SMS messages and also standard SMS messages. This documentation will guide you on how to configure SMS messaging, create a Hologram or Text SMS and view your SMS reports.
Configuring SMS
2mee SMS allows you to create and send Hologram or text SMS easily to your users. To send SMS from 2mee, you will need:
1.
An account with Twilio (SMS platform)
2.
Twilio SID and Auth Token 
From Number 
Your 'from number' is your default number from within your Twilio account.
You can acquire 'From' phone numbers on Twilio or use your own phone numbers (but if using your own number you can only send SMS within your country).
To/Audience Numbers
Twilio and 2mee require all user phone numbers to be in the E.164 format. Please make sure your number follows this format or messages will not be delivered correctly.
If you are using a Trial account please make sure numbers are registered within Twilio before trying to send an SMS 
SMS Platform Configuration 
Choosing Your Platform
To create a project on the 2mee platform start by logging in to your account on the 2mee messaging platform. Once you are logged in you will need to click the ‘Create Project’ button to start creating a project.
You will then be asked to add a name and description to your project, please add both of these then choose SMS as the platform you want to configure. 
If you already have a project configured that you want to add SMS to, navigate to the settings section and choose the SMS channel from the list of platforms.
Twilio account Setup
Enter the Twilio Account SID and Auth Token to allow 2mee to send SMS.
The Twilio account SID and Twilio Auth Token can be gathered from your Twilio dashboard.
Add Default Phone Number
When adding a default phone number you must ensure this is a verified default phone number in your Twilio account. To find your Default phone numbers in Twilio navigate to the 'Phone Numbers' section then 'Active Numbers', here you will see all of your default phone numbers listed. 
When sending an SMS you can also choose a different 'From' phone number in the message details section if you prefer to not use the default From Number.
To send a message internationally you must ensure you have enabled all geo-locations for your default number in Twilio
Send test SMS
You will now be required to send a test SMS to a valid phone number. This allows 2mee to check that the configuration of your Twilio account with 2mee is correct.
Add a valid phone number then click the send test SMS button
You should then receive the test SMS from 2mee and your account will be configured.
Creating a Hologram SMS 
Create SMS
To create a Hologram SMS message, navigate to the SMS section of the 2mee platform
Once you are in the SMS section click on the 'Create SMS Message' button
Now select Hologram, please refer to this document for text SMS
Choose HoloCapsule
Once you have selected Hologram you will be shown all of your HoloCapsules from the 2mee platform. A HoloCapsule is added to a Hologram SMS message, the user will see the Hologram associated with the capsule once they open your Hologram SMS. You can change the Hologram associated with the capsule at any point, to do this see our Holocapsule documentation.
Once you have chosen your capsule you need to add users that the SMS will be sent to. There are two methods of adding users, below is some information on each of these
Add To/Audience numbers
Single User Input
You can add one or multiple to the audience for your SMS message by inputting the details shown on the screenshot below.
Here are some more details on each of these options:
Mobile No. - This is the users mobile phone number which will receive the SMS
Name - The name of the user
UserID - An identifier given to distinguish users
CampaignID - An identifier used to link users to campaigns 
Custom Field -  Custom data attached to a user
CSV
A CSV file with your users data can be uploaded to save time adding multiple single users. The CSV file has the same input fields as a Single user. 
Twilio and 2mee require all user phone numbers to be in the E.164 format.
Example SMS CSV.csv
122B
Text
Example SMS CSV
While using numbers/excel spreadsheets please ensure that the column stores 'text' and not a 'number' as the + will be lost when converting to CSV
SMS Details
In this section you will be asked to give your SMS a name, this is used for identifying the SMS on the 2mee platform. You will also need to add who the message is coming from, this will be shown on the end users SMS. You will then finally need to add your message, this will be the message that is sent via SMS to your end user.
SMS Name
This is a unique name used to identify your SMS on the 2mee platform
From
Here you are be able to change the default number to an alphanumeric senderID, please make sure this follows the correct format for an alphanumeric senderID or your SMS may not be sent. 
Message
Add the text for you SMS text here. A normal SMS character count is 160 characters for GSM-7 encoding and 70 characters for UCS-2 encoding.
Twilio charges for the number of SMS that a single message gets split into. If the character count is greater than the above-stated counts, then carriers will split the message into multiple segments. A single "message" will then be charged based on the number of segments.
There are three options when sending a Hologram SMS, these are:
Personalise - This will personalise the end users message so that it uses the details that were associated with the user when adding them to your audience. For example, If you select 'Name' this will send the unique name of each user in the text.
Add URL - A URL with the 2mee webSDK present is required when sending a Hologram. This URL will be used to display the hologram. Please make sure you have the WebSDK configured correctly by using this WebSDK documentation ​
Select Hologram Positioning - This allows you to select where on the link you would like the Hologram to be displayed. 
Scheduling 
Once you have added all of the details for your SMS you can send your SMS immediately to all your users or choose a specific time/date to start sending the message.
Creating a text SMS
Create SMS
To create a Text SMS message, navigate to the SMS section of the 2mee platform
Once you are in the SMS section click on the 'Create SMS Message' button
Now select Text, please refer to this document for Hologram SMS​
Add To/Audience numbers
Single User Input
You can add one or multiple to the audience for your SMS message by inputting the details shown on the screenshot below.
Here are some more details on each of these options:
Mobile No. - This is the users mobile phone number which will receive the SMS
Name - The name of the user
UserID - An identifier given to distinguish users
CampaignID - An identifier used to link users to campaigns 
Custom Field -  Custom data attached to a user
CSV
A CSV file with your users data can be uploaded to save time adding multiple single users. The CSV file has the same input fields as a Single user. 
Twilio and 2mee require all user phone numbers to be in the E.164 format.
Example SMS CSV.csv
124B
Text
Example SMS CSV
While using numbers/excel spreadsheets please ensure that the column stores 'text' and not a 'number' as the + will be lost when converting to CSV
SMS Details
In this section you will be asked to give your SMS a name, this is used for identifying the SMS on the 2mee platform. You will also need to add who the message is coming from, this will be shown on the end users SMS. You will then finally need to add your message, this will be the message that is sent via SMS to your end user.
SMS Name
This is a unique name used to identify your SMS on the 2mee platform
From
Here you are be able to change the default number to an alphanumeric senderID, please make sure this follows the correct format for an alphanumeric senderID or your SMS may not be sent. 
Message
Add the text for you SMS text here. A normal SMS character count is 160 characters for GSM-7 encoding and 70 characters for UCS-2 encoding.
Twilio charges for the number of SMS that a single message gets split into. If the character count is greater than the above-stated counts, then carriers will split the message into multiple segments. A single "message" will then be charged based on the number of segments.
There are three options when sending a Hologram SMS, these are:
Personalise - This will personalise the end users message so that it uses the details that were associated with the user when adding them to your audience. For example, If you select 'Name' this will send the unique name of each user in the text.
Add URL - This is a tracked URL which will 
Scheduling 
Once you have added all of the details for your SMS you can send your SMS immediately to all your users or choose a specific time/date to start sending the message.