Navigation

Creating an SMS Message

In this article, you will learn how to create an SMS, to manage its deliverability, to integrate content and to personnalize it to differents audiences. You will finish with testing your SMS.  


Prerequisites


Step 1: Create an SMS

Go into the SMS module and click on Create:

Then, give a name to the SMS and select a communication type. When you are done, click on Create:Communication types available are those you authorized for SMS messages when you activated the module.


Step 2: Insert Opt-out Instructions

Some countries require to insert opt-out instructions into an SMS. To be compliant, you can check the Show opt-out instructions option:


Step 3: Add a sender ID (optional)

If you want the recipient to see your business name instead of your phone number, you can enter a name in the From field:If you enter a sender ID, the recipient will not see your phone number and will not be able to answer to your SMS.

Sender ID restrictions

  • A sender ID does not work in North America. If you have added a sender ID, the fallback will be your sender's phone number. 
  • Special characters are not allowed. 
  • List of prohibited and blocked terms at the sending or the reception.

    1TimePin

    2FA

    Accept

    Access

    Account

    Active

    Admin

    Advise

    Alert

    Allow

    Allowance

    App

    Appointment

    Approve

    Approved

    Auth

    AuthMSG

    Authorise

    AuthSMS

    Aware

    Bank

    Banking

    Bill

    Billing

    Call

    Card

    Caution

    Certify

    Check

    CloudOTP

    Code

    Collect

    Collection

    Confirm

    Contact

    Control

    Courier

    Delay

    Deliver

    Delivery

    Discount

    Energy

    Fraud

    Help

    Info

    InfoSMS

    ISA

    Key

    Loan

    Login

    Logistics

    LogMeIn

    Logon

    Malware

    Message

    Mobile

    Mortgage

    MSG

    MsgAuth

    Network

    NoReply

    Notify

    OneTimePin

    Order

    OTP

    OTPSMS

    Package

    Parcel

    Pay

    Payment

    Pin

    PinCode

    Post

    Protocol

    Purchase

    Ratify

    Rebate

    Receipt

    Refund

    Reminder

    Repayment

    Reply

    Respond

    Save

    Saving

    Savings

    Scam

    Schedule

    Secure

    Security

    Service

    Shipping

    Sign

    Signin

    Signon

    SMS

    SMSAuth

    SMSCode

    SMSInfo

    SMSOTP

    SMSVerify

    Support

    System

    Text

    Trace

    Track

    Tracking

    Trust

    TXT

    Update

    Updates

    Validate

    Verify

    VerifySMS

    VerifyMe

    Virus

    Warn

    Warning

    Winner

    *These terms may be used if combined with other terms. By example, "Smith Bank” or “Border Control” are accepted, but "Control" or "Bank" used alone will be blocked. 

Step 4: Write the Content

Note: When writing your SMS, pay attention to the number of characters in your message, which is displayed in the right pane SMS analysis section. Ideally, your message should have a maximum of 140 characters as to count only one fragment.
Read the article on how to check the number of fragments in your message.

  1. To compose or edit the content of the message, you must go to the Library section.
  2. In the center pane of the editor, type in your message.
  3. Add desired elements from the available options under the Library section.
  4. Make sure to save your changes by clicking on Save. Actually, it is safer to save as you make changes.

Note: In some countries, legislation requires including unsubscribe instructions in SMS content. Our platform offers an option that allows you to add these instructions automatically based on the keywords "Arrêt" and "Stop". The unsubscribe instruction text will be visible in the "Test" and "Send" sections when previewing the SMS.

To activate this option, go to the "Properties" tab of the "Compliance Options" block. A toggle button allows you to select the display language between French or English. If you activate this option, the default unsubscribe mechanism will be enabled.

Step 5: Personalize the message by adding variables

You might want to customize the content of the message with variables. The most common variable used is for the introduction.

OpenExample: Hello [[=Contact.f_FirstName;]], will show in the message as: Hello Peter, or Hello Susan, 

You can insert customizable variables anywhere in the message by using fields from the contact's profile, whether it is an address, a phone number or a comment entered in the profile.

  1. Place the cursor in the message where you want to insert the customized text.
  2. In the Customization section, select the data source by clicking on  to display the list of possible sources. By default, the source is the contact's profile, but you can choose variables from the project, the company, or even from system data. Then, select the field corresponding to the value you want to insert.
  3. Click on Insert.

Personalize the message with dynamic content

If you want to customize the message by adding dynamic and conditional content, you must select the desired options under the Dynamic content. For example, you might want to show in the message the address of the company that is in the same location as the location of the recipient.

Example: If the region of the contact is Quebec, show the address of the office in Quebec; otherwise, show the address in Montreal.


Description of condition types

TypeDescription
Contact's profile
Lets you add content based on any field in the contact profile.
Project's info
Lets you insert specific content when a given project data is met, such as the project name, id number, key or creation or edit date.
Company's info
Lets you choose amongst the information on the company to insert a specific content. This information is found in the Account Management module.
System info
Lets you insert dynamic content based on a given system date.
DeviceLets you personalize the content depending on the type of device and platform used to view messages. See a description of all available choices under Device
  1. Place the cursor in the message where you want to insert the conditional text.
  2. If you need more space to type in your text, or simply wish to work in a bigger space, click on  to see the section in full-screen mode.
  3. In the Add this content section, type in the text to insert in the message if the condition is met.
    Example: The address of the office in Quebec
    You can also select the text right in the message and click on the  icon to copy your selection.
  4. Under the If... section, select the data source by clicking on  to display the list of possible sources. By default, the source is the contact's profile, but you can choose variables from the project, the company, or even from system data. Once the source is selected, select the field and the operator to use for the search.
  5. If you want to have an alternate text, for when the condition is not met, check the Else option and specify the replacement text.
    Example The address of the office in Montreal if the contact's region is not Quebec
  6. Click on Insert.

Step 6: Preview

Once the SMS is saved, you can immediately see what it looks like in the right panel.


Step 7: Test the Sending

To check if your SMS is correct and can be sent, it is recommended to perform a test by entering a valid cellular phone number and send the message as a test. See also Supported Number Formats for Sending SMS.

Check on the phone on which you sent the SMS to see if the SMS was received and if it is desired.


Next Step

Send the SMS. See Sending an SMS Message.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.