SMS Notification Basics
Last updated
Was this helpful?
18.5
Last updated
Was this helpful?
SMS Notifications send outgoing text messages that do not require an SMS reply.
Unlike Chat Bots, SMS Notifications cannot parse replies or incoming messages, but they can still be used to prompt responses from the recipient. For example, SMS Notifications might contain web links to click on or cues to prepare for a previously-scheduled meeting. Most commonly, SMS Notifications are used to send reminders or follow-up messages spurring users to continue a half-finished Journey.
📘 Once an app is in production, is there a way to check on the status of the sent text messages?
The status of outgoing text messages sent from all Apps within an Organization can be found in the Console, in the SMS tab when examining an application under App Health. This provides insight into important information such as which and how many text messages were successfully delivered. For more information, see .
SMS Notifications are created in the .
New Notifications can be created by clicking on the '+' icon to the right of the Notifications section of the Tree, which provides the options to choose the type of Notification to create. Select SMS Notification:
A single SMS Notification might consist of multiple texts, each one of which might be one of three types: Text, Link, or Link to Journey. This allows links to be sent be sent as separate SMS messages which, unlike links included within a larger text message, will automatically and consistently preview the destination web page.
For instance, the following example shows how the simple SMS Notification "Hello, welcome to Airkit!" will appear in the Stage:
Text type texts can also be made more intricate with the edition of variables, custom Airscript expressions, and Journey Links.
Variable
The Variable tab allows the selection a variable to insert into the text. Incorporating the values of variables into texts allows for the creation of customized Notifications.
For instance, say the name of each user is saved as a global variable accessible under name. Referencing this variable within a text message makes it possible to send a personalized text message:
Custom Expression
The Custom Expression tab provides an expression editor capable of parsing custom Airscript expressions.
The above example shows an Airscript expression that consists only of an Airscript function and hardcoded input. In most practical applications, however, Airscript expressions will need to reference variables in order to generate custom text messages. To this end, the Notifications Builder has access to all Global-, Profile-, and Theme-level variables.
When Journey Links are sent in this way, it is not guaranteed that they will display a preview of the relevant web page. To ensure consistency previewing, a Journey Link needs to be sent via the Link to Journey type text.
Link type texts contain a single link to a web page. Unlike links that might be sent as part of a larger text message, links sent in this way will automatically and consistently preview the web page being linked to.
The link URL is defined in the Stage. It can be edited by clicking on the text directly, or by clicking on the arrow icon to the right of the URL:
The expression editor that opens upon clicking on the arrow icon is capable of parsing Airscript. Because the Notifications Builder has access to all Global-, Profile-, and Theme-level variables, Global-, Profile-, and Theme-level variables can be used to define query or even path parameters within a URL. Best practices dictate that the bulk of the URL be defined as a string directly while variables are designated by surrounding them by double curly braces.
For instance, say we want to link users to a wikipedia article on a subject of their choice, which was already saved under the global variable session.subject. The Link SMS Notification can be defined as follows:
Unlike Journey Links that are sent as part of a larger text message, Journey Links sent as a Link to Journey type text will automatically and consistently preview the web page being linked to.
Once a Notification is created, it can be sent:
🚧 When testing SMS experiences in production, bear in mind that Airkit won't allow for the sending of the same text message to the same phone number multiple times within a 30-minute period.
📘 Enforcing TCPA
Text type texts can take the form of any . This is what will be sent via SMS. The most simple texts are hardcoded strings, which are defined in the Stage.
Clicking on the Airscript icon () to the upper left of the text box will insert an Airscript expression into the text. Edit inserted Airscript expressions by clicking on them, which will prompt the following pop-up to appear:
The Notifications Builder has access to all Global-, Profile-, and Theme-level variables. For more on Global-, Profile-, and Theme-level variables, see .
For instance, the following example gives the input "Hello, Airkit" into the Airscript function . This Notification will consequently send the text "HELLO, AIRKIT", with all letters capitalized:
For more on Airscript, see . For more on Global-, Profile-, and Theme-level variables, see .
Clicking on the link icon on the upper right of the text box will insert a Journey Link directly into the Text. Journey Links direct users back to the web portion of their Journey. For a more detailed discussion of how this works, see .
Link to Journey type texts contain only a Journey Link. Journey Links direct users back to the web portion of their Journey. For a more detailed discussion of how this works, see .
via the Action, or
as a direct part of the Journey by incorporating them into the .
An Actor represents any individual who goes through an application flow. Actors are identified by their contact information, such as their phone number or email address. Once the relevant contact information is associated with an Actor, Notifications will be sent directly to the Actor via their established accounts. Tying contact information to an Actor is done via , which must be done before Notifications can be sent.
For a deeper dive into conceptualizing Actors, see . For a step-by-step walkthrough of how to initialize the Actor, see .
Outgoing SMS Notifications are sent from the phone number associated with the application, which is defined in the . For more on how to associate phone numbers with Airkit apps, see .
SMS Notifications can be sent via the Action, which can be included in any Action Chain after the Actor has been initialized with a valid phone number saved to actor.phone.
Determine the Actor's phone number and make sure it is formatted according to the Data Type. Use the Action to tie this value to actor.phone.
In the same Action Tree in which actor.phone was declared, follow its declaration with the Action to initialize the Actor.
Add the Action to any Action Chain fired downstream of Actor Initialization. Select the SMS Notification you want to send from the associated dropdown menu.
The Send SMS Action is often used in tandem with the Action in order to schedule texts rather than send them immediately. Nesting SMS Notifications under Timers is required to enforce TCPA restrictions; see for more details.
