The previous article discussed what Sessions are and how they allow a user's progress to be tracked and saved. Here, we take a deeper dive into how to apply the concept of Sessions by examining them in the context of starting, continuing, and identifying Sessions through Journey Links.

Starting Links and Journey Links

Interacting with a web app requires navigating to a particular URL. There are two categories of URL that can lead to an Airkit web app: Starting Links and Journey Links.

A Starting Link, referred to as a "Web URL" in Settings, triggers the start of a Session. It can be used any number of times to begin any number of Sessions.

A Journey Link leads to the most recently-accessed Web Page within an existing Session. It is capable of doing so because it contains a unique Session identifier in the URL path.

The Structure of Starting Links

The following is an example of a Starting Link, where "app.airkit.com" is the domain name of the application and {trigger} represents an automatically-generated, app-specific trigger:

https://app.airkit.com/l/{trigger}

An app-specific trigger is required because Airkit allows multiple applications to be as associated with a domain. However, while applications will use an automatically-generated trigger by default, it is also possible to create custom triggers. The following is an example of a Starting Link, where "app.airkit.com" is the domain name of the application and {custom_trigger} represents a customized, app-specific trigger:

https://app.airkit.com/{custom_trigger}

Setting custom triggers allows for the creation Starting Links that provide some intuitive understanding of what sort of application is being linked to. The automatically-generated trigger "5w" tells a potential user nothing about the app it links to, whereas the custom trigger "order_status" indicates that it links to an app that allows the user to check the status of their order.

For a nut-and-bolts walkthrough of how to create custom trigger (as well as how to set up a White Label domain), see Connecting Your Domain to Airkit.

The Structure of Journey Links

The following is an example of a Journey Link, where "app.airkit.com" is the domain name of the application and {id} represents a unique Session identifier:

Example: https://app.airkit.com/u/{id}

Note that, for security purposes, the unique Session identifier that appears in the Journey Link is not the same as session.id, the session-level variable used to identify Session internally. The {id} that appears in Journey Links is a useful identifier only in the context of URLs.

Applications

Starting Links are intended for general use; anyone can click on one and begin new Journey. It is the Starting Link you want to link to when providing a link to your application in any sort of public space, and, upon publishing an application, only Starting Links will be provided in the pop-up window.

Journey Links are specific. They provide a means for app users to navigate away from their active Session and then return to continue where they left off. It is the Journey Link you want to send to users in follow-up texts when you want to remind them to return to a half-finished Session and finish what they started. The Journey Link will bring them directly to the Web Page their Session most recently navigated to, with all previously-saved progress, including the binding of variables, still intact.

Upon navigating to a Starting Link and beginning a Session, the change from Starting Link to Journey Link will be reflected in the address bar of the web browser, as an identifier becomes part of the path parameters. Should you endeavor to provide someone a link to an Airkit app, be mindful of which URL you are sending. You cannot send someone a Starting Link by copy/pasting the URL from your address bar, as the URL displayed will have already changed from a Starting Link to a Journey Link.