Message link reference - DingTalk Help Center

This topic describes how message links are opened.

Open a message link in the PC sidebar or an external browser

When a user clicks a URL in a message on the PC client, use the following format to control how the link opens:

dingtalk://dingtalkclient/page/link?url=http%3A%2F%2Fwww.dingtalk.io&pc_slide=true

Parameter	Description
url	The link to open. The value must be URL-encoded.
pc_slide	- true: Open the link in the sidebar of the PC client. - false: Open the link in a browser.

A mini program can send a message that, when clicked, redirects the user to the mini program. The supported scenarios are as follows:

App type	Work Notifications message	Organization group message	Plain message
Internal app	Supported	Not supported	Not supported
Third-party enterprise app	Supported	Not supported	Not supported
Third-party personal app	—	—	Supported

The link format used to redirect to a mini program is as follows:

 eapp://page?query

Example: eapp://pages/index/index?param1=aa&param2=bb

This link format is supported only when the message is sent by a mini program. It is not supported when the message is sent by a micro app.
To ensure the redirection works as expected, publish the target mini program to the production environment.
page indicates the page path of the mini program, such as pages/index/index. The path must be defined under pages in the app.json configuration file.

To ensure the redirection works as expected, publish the target mini program to the production environment.

query indicates the query parameters passed to the onLoad method of the page. For example, param1=aa&param2=bb. If a parameter value contains special characters, URL-encode the value.