Notifications Builder
Last updated
Was this helpful?
18.0
Last updated
Was this helpful?
The Notifications Builder provides the tools to send outgoing Email or SMS messages that do not require a response through the same channel. These outgoing messages are referred to as Notifications.
Notifications cannot parse replies or incoming messages, but they can still be used to prompt responses from the recipient. For example, Notifications might contain web links or cues to prepare for a previously-scheduled meeting. Most commonly, Notifications are used to send reminders or follow-up messages spurring users to continue a half-finished Journey.
The Notifications Builder is structured with the Tree to the immediate right of the Builder Bar with the Stage to the immediate right of that:
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: Email or SMS.
🚧 When creating SMS experiences, bear in mind that Airkit won't allow for the same text message to be sent to the same phone number multiple times within a 30-minute period. 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 web page being linked to.
You can add a new text to an SMS Notification by clicking on the '+' icon to the right of the relevant Notification and selecting the desired type of text:
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 Tab - allows the selection a variable to insert into the text.
Custom Expression Tab - provides an expression editor capable of parsing custom Airscript expressions.
When Journey Links are sent in this way, it is not guaranteed that they will display a preview of the relevant Web Flow. 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.
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.
The Subject is the string that will appear in the subject line when the Email Notification is received. Defining the Subject is done in an expression editor that accepts Airscript. This means that while the Subject can be generic and hardcoded, it can also use previously-collected user input to generate customized Subjects.
To hardcode a string, simply type the desired Subject between quotation marks, like so:
The Body HTML section is where the email body is defined. The expression defining the email body will be parsed in HTML, though it can also access Airscript expressions.
Once a Notification is created, it can be sent as an Action at any point throughout a user's Journey. SMS Notifications are sent via the Action, and Email Notifications are sent via the Action.
Notifications can also be sent as a direct part of the Journey by incorporating them into the .
🚧 In order for Notifications that are sent from a Journey Step be TCPA-compliant, the actor.region and actor.time_zone must be set before initializing the Actor. This will automatically initialize a calendarRestriction property on the Actor, which will resolve to the correct TCPA calendar to use for the user. For more information, see .
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 this 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, while outgoing Email Notifications are sent from the email address associated with the application. These associations are defined in the .
For more on how to associate phone numbers with Airkit apps, see . For more on how to associate email addresses with Airkit Apps, see .
SMS Notifications are sent via text message. For a deeper dive into how to create and send SMS Notifications, see .
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, and selecting either the Variable or the Custom Expression Tab.
The Notifications Builder has access to all Global-, Profile-, and Theme-level variables. For more on Global-, Profile-, and Theme-level variables, see .
For more on Airscript, 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 .
An Email Notification consists of a subject and a body, both of which are defined in the Stage. For more about creating and sending Email Notifications, see
To insert an Airscript expression, place it inside of double curly braces. Note that the Notifications Builder has access to all Global-, Profile-, and Theme-level variables. For more on Global-, Profile-, and Theme-level variables, see . For more on writing Airscript expressions, see .
To insert an Airscript expression, place it inside of double curly braces. Note that the Notifications Builder has access to all Global-, Profile-, and Theme-level variables. For more on Global-, Profile-, and Theme-level variables, see . For more on writing Airscript expressions, see .
