Launch a feature in Engagement Messenger using URL parameters
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
-
Navigate to Engagement Messenger > Modules.
-
Select the module.
-
In the Configure Engagement Messenger Module, open the Implement tab.
-
Copy the code from the Embed code section.
-
In a text editor, open the HTML file of the web page on your website where you integrate Engagement Messenger.
-
Paste the code you copied before the closing body tag.
-
Save the file.
-
Modify the website URL to include the feature.
Texthttps://website/page.html?feature=<FEATURE_NAME>&<PARAM_NAME1>=<PARAM_VALUE1>&<PARAM_NAME2>=<PARAM_VALUE2>-
<FEATURE_NAME>
The feature name. For information, see Feature context parameters supported in Engagement Messenger.
-
<param_name1>=<param_value1>
Name and value of a parameter associated with the feature. To define multiple parameters, use the same format. For more information, see Feature context parameters supported in Engagement Messenger.
-
-
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.
https://mywebsite/page.html?feature=VIEW_ARTICLE &sys_kb_id=ec7617461b01f01080df6247b04bcbaf---
title: Launch a feature in Engagement Messenger using URL parameters
description: Use URL parameters in your website's URL to enable the deep linking and launch a feature in Engagement Messenger integrated with your website.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/customer-service-management/customer-self-service-and-omnichannel-engagement/contextual-launch-using-url-engagement-messenger.html
release: brazil
product: Customer Self-service and Omnichannel Engagement
classification: customer-self-service-and-omnichannel-engagement
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Deep linking feature, Set up Engagement Messenger, Set up self-service, Configure, Customer Service Management]
---
# Launch a feature in Engagement Messenger using URL parameters
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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/customer-service-management/customer-self-service-and-omnichannel-engagement/create-engagement-messenger-module.md).
[Embed Engagement Messenger in your web application](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/customer-service-management/customer-self-service-and-omnichannel-engagement/embed-engagement-messenger-code-in-your-web-application.md).
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.
```
https://website/page.html?feature=<FEATURE_NAME>&<PARAM_NAME1>=<PARAM_VALUE1>&<PARAM_NAME2>=<PARAM_VALUE2>
```
- **<FEATURE\_NAME>**
The feature name. For information, see [Feature context parameters supported in Engagement Messenger](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/customer-service-management/contextual-launch-supported-features.md).
- **<param\_name1>=<param\_value1>**
Name and value of a parameter associated with the feature. To define multiple parameters, use the same format. For more information, see [Feature context parameters supported in Engagement Messenger](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/customer-service-management/contextual-launch-supported-features.md).
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.
```
https://mywebsite/page.html?feature=VIEW_ARTICLE &sys_kb_id=ec7617461b01f01080df6247b04bcbaf
```
| title | Launch a feature in Engagement Messenger using URL parameters |
| description | Use URL parameters in your website's URL to enable the deep linking and launch a feature in Engagement Messenger integrated with your website. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/customer-service-management/customer-self-service-and-omnichannel-engagement/contextual-launch-using-url-engagement-messenger.html |
| release | brazil |
| product | Customer Self-service and Omnichannel Engagement |
| classification | customer-self-service-and-omnichannel-engagement |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Deep linking featureSet up Engagement MessengerSet up self-serviceConfigureCustomer Service Management |