DMS integrates with DingTalk, DingTalk Enterprise, and Feishu to serve as notification channels. You can view notifications on mobile devices and clients. Approvers can also approve tickets on their mobile devices.
Prerequisites
You have created an organization in DingTalk or Feishu.
This organization is an internal enterprise organization. It is not a public Alibaba Cloud organization, such as Alibaba Cloud Service Support.
Precautions
Ticket approval is supported only on mobile devices.
If you are an Alibaba Group internal user, contact DMS technical support (DingTalk group number: 87370028482).
The US site does not support message notifications.
Preparations
Configure an application to receive messages.
DingTalk/DingTalk Enterprise
Create an application.
Log on to and join a DingTalk organization.
Log on to the DingTalk Open Platform.
Select your enterprise's organization. For example, "XXX Test Organization".
Go to the DingTalk console to create a DingTalk application.
In the top-right corner of the page, click My Console.
Click the Application Development tab. In the left navigation pane, choose .
Click Create Application.
Enter an Application Name and Application Description, and click Save.
Configure a DingTalk robot to receive messages.
Click the name of the application that you created to go to the application editing page.
In the navigation pane on the left, choose , and then add a robot.
Configure the Robot Introduction, Robot Description, and Message Reception Mode, and then click Publish.
NoteSet Message Reception Mode to HTTP mode.
Configure web application information.
After you add the web application, in the Application Capabilities menu, click Web Application.
Set the homepage URL for the application and click Save.
The homepage URL depends on the current DMS data processing region. For example, if the data processing region is Singapore, the application homepage URL is
https://dms-ap-southeast-1.alibabacloud.com.NoteTo view the data processing region, see Switch DMS deployment regions.

China (Hangzhou):
https://dms-cn-hangzhou.alibabacloud.com.Japan (Tokyo):
https://dms-ap-northeast-1.alibabacloud.com.Singapore:
https://dms-ap-southeast-1.alibabacloud.com.Malaysia (Kuala Lumpur):
https://dms-ap-southeast-3.alibabacloud.com.Indonesia (Jakarta):
https://dms-ap-southeast-5.alibabacloud.com.SAU (Riyadh - Partner Region):
https://dms-me-central-1.alibabacloud.com.China (Hong Kong):
<a href="https://dms-cn-hongkong.alibabacloud.com" id="0c5ce72573cfn" uuid="ba897e6a-66d7-4d24-b1cd-c1cc256337fc">https://dms-cn-hongkong.alibabacloud.com</a>.South Korea (Seoul):
<a href="https://dms-ap-northeast-2.alibabacloud.com" id="95873e62e290c" uuid="3ed56fc3-194d-4618-b7eb-70ae2871deeb">https://dms-ap-northeast-2.alibabacloud.com</a>.
Configure permissions.
In the left navigation pane, choose , and then request the following permissions:
Basic permissions required to call Simple Notification Service (SNS) APIs
Read permission for member information
Permission to retrieve basic member information based on mobile phone numbers
Basic permission to call enterprise APIs
Basic permission to retrieve user access credentials for DingTalk open interfaces
Permission to manage basic information of DingTalk groups
Permission for internal enterprise robots to send messages
Write permission for interactive card instances
Create and publish a new version.
You must publish a version of the custom enterprise application before other users in the enterprise can use it.
In the navigation pane on the left, choose Version Management and Publishing. Click Create New Version, enter the configuration information, and click Save.
Create a card.
Create a template.
Go to the Card Platform and click Create Template.
Enter a Template Name, select a Card Type and Card Template Scenario, and then click Create.
For Card Template Scenario, select Normal Card. For Associated Application, select the application that you created.
Import a card template.
Choose . Import and save the message notification card template. For a sample template, see DingTalkTemplate.json.
Publish the message notification card template.
Feishu/Lark (International)
Log on to the Feishu Open Platform or Lark Open Platform and go to the developer console.
Go to the Feishu Open Platform or Lark Open Platform.
You can click Log On.
The logon account must belong to the target enterprise organization. For example, the organization name is "XXX Test Organization".
Log on and go to the Developer Console.
Click Create Custom Enterprise Application. Configure parameters such as Name and Application Description, and then click Create. For more information, see Development process for custom enterprise applications.
Add a Feishu robot.
(Optional) Click the application name to go to the application editing page.
NoteIf you just created the application, you can skip this step.
In the left navigation pane, choose .
On the Add By Feature tab, in the Robot card, click Add.
On the Robot page, you can enter a robot name and click Save.
Add a web application.
In the left navigation pane, choose .
On the Add By Feature tab, in the Web App card, click Add.
On the Web App page, enter the URL for the Mobile Homepage and click Save.
The homepage URL depends on the current DMS data processing region. For example, if the data processing region is Singapore, the application homepage URL is
https://dms-ap-southeast-1.alibabacloud.com.NoteTo view the data processing region, see Switch DMS deployment regions.

China (Hangzhou):
https://dms-cn-hangzhou.alibabacloud.com.Japan (Tokyo):
https://dms-ap-northeast-1.alibabacloud.com.Singapore:
https://dms-ap-southeast-1.alibabacloud.com.Malaysia (Kuala Lumpur):
https://dms-ap-southeast-3.alibabacloud.com.Indonesia (Jakarta):
https://dms-ap-southeast-5.alibabacloud.com.SAU (Riyadh - Partner Region):
https://dms-me-central-1.alibabacloud.com.
Add a redirection URL and a trusted H5 domain name.
In the left navigation pane, choose .
On the Redirect URLs tab, you can configure the Redirect URL and Trusted H5 Domain Name.
The redirection URL and trusted H5 domain name depend on the DMS data processing region. For example, if the DMS data processing region is Singapore, the redirection URL is
https://dms-ap-southeast-1.alibabacloud.com/console/mobile/index/and the trusted H5 domain name ishttps://dms-ap-southeast-1.alibabacloud.com.Click Add for each entry.
Configure application permissions.
In the navigation pane on the left, choose .
On the Permission Management tab, click Enable Permissions.
On the App Identity Permission (tenant_access_token) tab, request the following permissions. For more information about requesting permissions and their descriptions, see Request Permissions and Permission Description.
Retrieve user ID
Retrieve user ID by mobile number or email
Upload images and attachments to cloud documents
NoteLark does not support this permission.
Retrieve and send private and group messages
Send messages as the application
Send messages to multiple users in batches
Retrieve and upload image or file resources
Publish an application version.
You must publish a version of the custom enterprise application before other users in the enterprise can use it.
In the left navigation pane, choose .
Click Create Version.
Enter the App Version, select the Default Mobile Capability, configure other settings, and click Save.
Set the Availability to All Members.
Retrieve key information from DingTalk, DingTalk Enterprise, or Feishu. This information is used to configure notification channels in DMS.
DingTalk
Retrieve the AppId, AgentId, AppKey, and AppSecret
You can obtain the AppId, AgentId, AppKey, and AppSecret for the application from the Credentials and Basic Information page on the DingTalk Open Platform.
Retrieve the RobotCode
On the DingTalk developer platform, you can obtain the RobotCode from the page.
Retrieve the card template ID
You can obtain the ID from the page of the Card Platform.
Retrieve the CorpId (Optional)
Go to the DingTalk developer console and click your profile picture to retrieve the CorpId.
NoteAfter you configure the CorpId parameter in the DMS notification channel, you can receive messages and approve tickets without switching your DingTalk organization to the one where the custom enterprise application is located.
DingTalk Enterprise
Retrieve the AppKey and AppSecret
Obtain the application's AppKey and AppSecret from the Basic Information page of the DingTalk Open Platform.
Retrieve the RobotCode
On the Robot page of the DingTalk Open Platform, you can obtain the RobotCode from the credential information.
Retrieve the card template ID
You can obtain the ID on the page of the Card Platform.
Retrieve the CorpId (Optional)
Go to the DingTalk developer console and click your profile picture to retrieve the CorpId.
NoteAfter you configure the CorpId parameter in the DMS notification channel, you can receive messages and approve tickets without switching your DingTalk organization to the one where the custom enterprise application is located.
Feishu/Lark
You can obtain the AppId and AppSecret on the page of the Feishu Open Platform or Lark Open Platform.
Step 1: Enable and configure notification channels in DMS
The channel management feature in DMS lets you enable or disable tenant-level notification channels and maintain configuration information for applications such as Feishu and DingTalk Enterprise.
After you enable a target channel, the notification settings that you configure in DMS take effect. DMS then sends you notifications through that channel.
Only administrators or DBAs can configure notification channels.
- Log on to the DMS console V5.0.
Click the
icon in the upper-left corner of the console and choose .NoteIf you are using the console in normal mode, choose from the top menu bar.
In the upper-left corner of the page, click Channel Management.
Select the target notification channel.
Configure the required information for Feishu, Lark, DingTalk, or DingTalk Enterprise.
The following example shows how to configure channel information for Feishu. The procedure for other channels is similar.
In the Feishu channel section, click Edit.
Enter the AppId and AppSecret, and then click Save.
Step 2: Set users to receive message notifications
The following example shows how to configure notifications for data export tickets that are pending approval:
The administrator adds the users who will receive messages to DMS. For more information, see User Management.
The administrator or DBA navigates to the DMS Notification Management page.
On the Notification Management page, select the DMS feature module for which you want to update message notifications.
In the Module/Business Type filter box, select .
Find the ticket with the Pending Approval business status and click Modify in the column on the right.
In the Additional Notification Users section, select the desired users and click OK.
Enable message notifications.
Notifications for subsequent data export tickets that are pending approval will be sent directly to the specified users through DingTalk, DingTalk Enterprise, or Feishu.
References
DMS lets you quickly process tickets on mobile devices to greatly improve development efficiency. For more information, see Approve tickets on a mobile device.
FAQ
Q: I configured channel information for Feishu, DingTalk, DingTalk Enterprise, or Lark in my personal notification settings. Why am I not receiving DMS message notifications through Feishu, DingTalk, or other channels?
A: Check whether you have enabled the Feishu, DingTalk, DingTalk Enterprise, or Lark notification channel. The information that you configure takes effect only after you enable the corresponding channel. DMS can then send you message notifications through that channel. For more information about how to enable a channel, see Step 1: Enable and configure notification channels in DMS.
Q: Why do I not receive DingTalk or Feishu messages even after I configured the notification channel information and specified the users to receive messages?
A: Follow these steps to resolve the issue:
You can verify whether the administrator or DBA has enabled the corresponding channel in DMS by choosing . For more information, see Step 1: Enable and configure notification channels in DMS.
Click your DMS profile picture and make sure that the corresponding notification channel is enabled in the notification methods.
Q: I did not change my notification settings, but I suddenly stopped receiving DingTalk or Feishu messages. What could be the reason?
A: The number of API calls for your custom enterprise application may have exceeded the limit, which prevents you from receiving messages. You can view the API call volume in the developer console of DingTalk or Feishu. For more information about how to adjust the number of API calls, see the documentation for DingTalk and Feishu.