Launch a feature in Engagement Messenger using URL parameters

task australia Updated Sep 10, 2026 1 min read contextual-launch-using-url-engagement-messenger.md
Raw file servicenow.com

Use URL parameters in your website's URL to enable the deep linking and launch a feature in Engagement Messenger integrated with your website.

Before you begin

Configure Engagement Messenger.

Embed Engagement Messenger in your web application.

Role required: ec_admin and website administrator

About this task

You can use URL parameters to display specific feature in Engagement Messenger. When the URL is accessed, it opens your website and automatically loads the specified feature in Engagement Messenger. For example, you can embed the URL in an email to share a knowledge article from Engagement Messenger.

Note:

If you're using existing code, update the script to show the latest version. For example:

[Omitted image "em-version-no-update.png"] Alt text: Engagement Messenger with the version number highlighted in the Embed code.

Procedure

  1. Navigate to Engagement Messenger > Modules.

  2. Select the module.

  3. In the Configure Engagement Messenger Module, open the Implement tab.

  4. Copy the code from the Embed code section.

  5. In a text editor, open the HTML file of the web page on your website where you integrate Engagement Messenger.

  6. Paste the code you copied before the closing body tag.

  7. Save the file.

  8. Modify the website URL to include the feature.

    Text
    https://website/page.html?feature=<FEATURE_NAME>&<PARAM_NAME1>=<PARAM_VALUE1>&<PARAM_NAME2>=<PARAM_VALUE2>
  9. Verify that the URL launches the designated feature automatically.

Result

The feature you included in the URL is set as the default launch screen in Engagement Messenger.

Example

The following sample URL includes a system identifier (sys_id) for a knowledge article that will automatically display when the website is launched.

Text
https://mywebsite/page.html?feature=VIEW_ARTICLE &sys_kb_id=ec7617461b01f01080df6247b04bcbaf
Search documentation
Search document titles and file paths on the australia branch