Linking to Sessions

Starting links and Journey Links

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 "" is the domain name of the application and {trigger} represents an automatically-generated, app-specific trigger:{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 "" is the domain name of the application and {custom_trigger} represents a customized, app-specific trigger:{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 "" is the domain name of the application and {id} represents a unique Session identifier:


Note that, for security purposes, the unique Session identifier that appears in the Journey Link is not the same as, 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.


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.

Are Journey Links still used if a Session does not begin with a Starting Link?

Session can start in many ways, and clicking on a Starting Link is only one of them. Sessions might also start, for instance, with an incoming text or phone call. Users will still be directed to a Journey Link, not a Starting Link, to continue their Session online.

As an example, consider call deflection, a common Airkit use case. A client calls in. They answer a few automated questions before receiving a text directing them to a web app that will help them achieve their goal. Their flow through the web application should be part of the same Session that they were on when answering those automated questions, so all relevant user information will be saved and accessible within a single Session. This prevents users from having to repeat themselves and results in a better user experience. Thus, the text directing users to the web app contains a Journey Link.

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.

Can Starting Links and Journey Links have different domains?

No, Starting Links and Journey Links must share the base domain defined under the Base Domain section in Settings. From there, Starting Links and Journey Links are configured separately in their own Settings sections. The web resource associated with Starting Links is configured under the Web URLs section, and the web resource associated with Journey Links is configured under the Journey Links section. Note that web resources must be created in the Domains section of the Console before they can be used in either Starting Links or Journey Links.