Link Handler

A pattern which is matched against any incoming universal links, with an action to trigger when the pattern is matched.

Link handling is typically used alongside External.

When the action is performed, the payload will contain all the data usually submitted with an action. Additionally, the data will be merged with an object containing the following structure:

{
    "url": "https://wise.com/some-url"
}

Where "https://wise.com/some-url" is the full URL that was matched against the pattern.

Given the step below, the client will listen for any deep or universal links that are used to open the app.

Step.build {
    layout { }
    linkHandlers {
        LinkHandler {
            regexPattern = """https:\/\/wise.com\/success-callback."""
            behavior = ActionBehavior.build {
                action {
                     url = "/handle-success-callback"
                     data = encodeToJsonElement(mapOf("some-additional-data" to true))
                }
            }
        }
        LinkHandler {
            regexPattern = """https:\/\/wise\.com\/failure-callback.*"""
            behavior = ActionBehavior.build {
                 action {
                     url = "/handle-failure-callback"
                 }
              }
         }
    }
}

If the user is on this step and then opens a universal or deep link, it'll be matched against the patterns in the array, and any matching action will be executed.

For example, if the user opens the app with the universal link "https://wise.com/success-callback?token=1234", this will be matched against the first pattern in the array. The corresponding action will be executed, and the payload will also contain the url that was matched - for example in this case the following data would be submitted to "/handle-success-callback":

{
    "some-additional-data": true,
    "url": "https://wise.com/success-callback?token=1234"
}

If a link is opened which doesn't match any of the patterns then no action is taken.