The Axsy Mobile App's Flow Engine supports a custom Axsy Component for Deep Linking, allowing users to be redirected to another application on the device as a part of a Flow.

This is implemented via the x-callback-url library, see their documentation here for more information

NOTE: Not all applications on your device may support Deep Linking so make sure to check their documentation

Adding a Deep Link in Flow

Included in Axsy's Managed Package is a custom Deep Link Flow Component. It is accessible in the Salesforce Flow Builder, and can be added to any Screen Flow as seen in Figure 1, or as a Element within a Flow as shown in Figure 2. Both of these implementations will take in the same arguments.

Figure 1 - Deep Link in Screen Flow Designer

Figure 2 - Deep Link Element in Flow Builder

In addition to the API Name field, the Deep Link Component can also take in more parameters:

(* = Required Field)

Parameter	Description
Scheme *	The Target Application that will be opened after clicking the Deep Link
Action	The action taken by the Target Application. Not all Deep Links will require an action, please refer to the applications documentation for more information
Host	The host of the Deep Link. Leaving it blank will default to "x-callback-url". You can also define non-compliant schemes here
Icon Name	Icon Displayed along with Deep Link. This is taken from the ionic icon library
Label	Displayed Label for Actions
Parameters	Any additional information that should be passed into the Target Application. The parameters can usually be found in the Target Application's Documentation. If there is more than one parameter, they will be separated by the '&' character
Show Success Parameter	Output parameter whose value will be displayed on a successful Deep Link
Source	The application that the Deep Link is run from (this will default to "Axsy Mobile"

Table 1 - Deep Link Component Fields

Example of Deep Linking in Flows

The Figures below show an example of a working Deep Link in a Screen Flow. This has been created in accordance with the Google Maps Documentation. In this example, the user will be redirected to the Google Maps app to view a given location (in this case "Buckingham Palace")

Populated Parameters:
Not all fields will be populated, if they are not explicitly mentioned here assume they are blank/default.

Parameters	Value
Scheme	comgooglemaps-x-callback
Icon Name	pin-outline
Label	Launch Google Maps
Parameters	q="Buckingham Palace"&center="51.5014,0.1419"&mapmode="standard"

Table 2 - Deep Link Component Parameters Populated

Figure 3 - Deep Link in Flow in Axsy Mobile

Figure 4 - Redirect to Google Maps caused by Deep Link

2-Way Deep Linking

In addition to redirecting users to an external application, the Deep Link Component also supports two-way deep linking. This enables the linked application to return data back into the Axsy Mobile App (provided the linked app supports this behaviour).

Redirect Actions

There are 3 types of actions that can trigger a redirect back to the Axsy Mobile App. These may not all be supported by the external app, please refer to their documentation:

Error - the action has not completed successfully
Cancel - indicates that the action in the external app was cancelled by the user before completion
Success - the action completed successfully in the external app

Based on the action, a return parameter may be passed back to the Axsy Mobile App. The flow can be configured to save the value of these parameters as flow variables, so they can be used as a part of the flow.

Configuration Steps

Determine Return Parameters in the External App
- The external application defines which parameters are returned.
- Common examples include
  - errorCode, errorMessage, cancelled, successText
- Note: These variables names depend on the external app's own deep linking scheme and are not defined by Axsy
Create Matching Variables in the Flow
- Create Flow Variables whose names exactly match the names of the return parameters from the external app
- All variables should be set to Text type
Assign Output Resource Variables in the Deep Link Element
- Ensure "Manually Assign Variables (advanced) is ticket. (See Figure 5,6,7)
- Map the relevant flow variables that capture error and success details to the corresponding output fields in the Deep Link Element.
- Any additional return parameters included in the URL will automatically populate flow variables with matching names.