Building Apps with Jigx
Additional functionality

Deep links

6min

Deep linking in mobile apps is a powerful tool that enhances user experience by creating seamless navigation between the app and external sources. Deep linking allows you to land directly on specific content or pages within an app, bypassing the need to navigate through a series of menus. This is particularly useful in marketing campaigns, social media links, or emails where you want to direct a person to a specific product, article, or feature within your app.

Contact support@jigx.com to get your branded app's deep link.

Format

Deep linking uses a uniform resource identifier (URI) to link to an app or a specific location within a mobile application. The deep link is built up in stages, and the depth depends on where in the app you want to land. The full URI format is shown below:

https://{app.domainname.com}/{appname}/app/solution/{solutionId}/jig/{jigname}?{inputname=inputvalue}

An example of a built-up deep link:

The URI is built up with the following values:

URI elements

Description

app.jigx.com

For all jigx apps, use the app domain app.jigx.com.

jigx

name of the app.

solutionId

The solutionId is found in management >solution> solution details, for example, 8e535f78-4e36-4716-8c01-3465bea60bj9.

jigname

jigId/jig-name, for example, support-form.

inputname

The name used in the input expression, i.e. =@ctx.jig.input.{inputname}.

inputvalue

The value to be used as the input.

Link to an app

To open a or branded app, use the following deep link:

https://{app.jigx.com}/{jigx}/app/

  • If you are logged out of the app and click the link, you will be directed to the login screen.
  • If you are currently logged into the app, the link will open the app and display the .

Link to a jig screen (basic deep link)

A deep link to a screen directs you to a specific location within the app if it has already been installed.

https://{app.jigx.com}/{jigx}/app/solution/{solutionId}/jig/{jigname}

Link to a jig with inputs (contextual deep link)

A contextual deep link includes additional information, such as user data, input value, or a parameter, providing a personalized experience. For example, a link that opens a form and prepopulates a field with an email address.

Input:

https://{app.domainname.com}/{appname}/app/solution/{solutionId}/jig/{jigname}?{inputname=inputvalue}

An example of the built-up deep link:

In the solution, the YAML code to accept the deep link input is:

YAML
input-query-parameter


Link to an external app from a jig

Add a deep link in a that directs you to a different mobile application, even to a specific location within that application. This link allows you to navigate seamlessly from one app directly to a particular page or piece of content in another app, without having to navigate through the app's homepage or menu. For example, tapping on an address link in a contacts could directly open Google Maps showing the location.

Considerations

  • Deep linking to an external app can only be configured in actions and swipeable actions using the action.open-url.
  • An app's deep links often differ depending on the mobile OS (iOS or Android). This will require you to configure a deep link for each OS in the . See the example below that deep links into the iOS and Android Google Maps app:
iOS-open-url
Android-open-url