Skip to content
Home/
/
Deep Linking

Deep Linking

Using Intercom you can embed a deep link in your in-app messages or as the URI for your push messages.

You'll need to set up a deep link in your app's config.xml, which Cordova translates into the appropriate AndroidManifest.xml entries. Android supports both app://page and http://www.app.com/page type schemes.

Add the following inside the <platform name="android"> section of your config.xml:

<platform name="android">
    <config-file target="AndroidManifest.xml" parent="/manifest/application/activity[@android:name='MainActivity']">
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />

            <data android:scheme="http" android:host="Your app url(www.app.com)"/> <!-- Edit this line -->
            <data android:scheme="Your app scheme(app)"/> <!-- Edit this line -->
        </intent-filter>
    </config-file>
</platform>

Intercom supports both Universal Links and Custom URL Schemes as a deep link. Please follow the instructions for Universal Links on our main iOS page.

Custom URL Scheme

Add the following inside the <platform name="ios"> section of your config.xml:

<platform name="ios">
    <config-file target="*-Info.plist" parent="CFBundleURLTypes">
        <array>
            <dict>
                <key>CFBundleURLSchemes</key>
                <array>
                    <string>myapp</string>
                </array>
            </dict>
        </array>
    </config-file>
</platform>

Replace myapp with your own custom URL scheme.

When a deep link opens your Cordova app, you can handle it using the global handleOpenURL function:

function handleOpenURL(url) {
    // Parse the URL and navigate accordingly
    if (url.indexOf('myapp://settings') === 0) {
        window.location.hash = '#/settings';
    } else if (url.indexOf('myapp://profile') === 0) {
        window.location.hash = '#/profile';
    }
}

Linking to your app

Once you have set up your app to respond to your deep link, you can send a push message with that as the URI. Tapping the push message will open your app to the specified page.

You can also add a link to your in-app messages and replies as follows:

< {label}
{label} >