Dingtalk Integration

Integrate with Dingtalk custom application to receive and respond to alerts within Dingtalk.

(This guide uses the new version of Dingtalk Open Platform as an example)

I. Create Dingtalk Application

1. Create Custom Application

Visit Dingtalk Developer Console - Application Development - Internal Enterprise Development to create an application. (See Dingtalk development documentation - Create Internal Enterprise Application - H5 Microapp)

You can use the Flashduty official icon as the application icon.

2. Copy Enterprise CorpId

Click on the enterprise in the upper right corner of the page, copy the CorpId from the dropdown menu for later use.

3. Copy Application Credentials

Go to the Credentials and Basic Information page, copy AgentID, ClientID, and ClientSecret for later use.

4. Copy Event Subscription Information

Go to Development Configuration - Events and Callbacks page.

Generate Encryption aes_key and Signature Token for later use.

(Note: After generating aes_key and Token, please temporarily save the information elsewhere, as it will disappear after leaving the page)

II. Add Dingtalk Integration

Return to Flashduty Integration Center page, select Instant Messaging > Dingtalk, fill in the Integration Name and application information copied in the previous step, then click save to create.

After saving, you will see information such as Web Configuration address, Server Outbound IP address, and Event Subscription Request URL, which will be used in later steps.

III. Configure Dingtalk Application

1. Add Cool App, Web App, and Bot

Create Cool App: On the Cool Apps - Cool App List page, click Create Cool App button, select Extend to Group Chat

Enter the Edit Cool App page, complete the following steps:

2.1) First step, fill in basic information, you can use the Flashduty official icon as the icon.

2.2) Second step, configure functionality design, select Group Quick Access and Message Card on the left. For the group quick access icon, you can use the Flashduty official icon. Copy the Cool App Web URL from the integration details for both desktop and mobile access URLs.

2.3) Skip the third step of function development, proceed to the fourth step Preview and Release, click the Release button and confirm.

2. Configure Bot and Message Push

Enter the Application Capabilities - Bot page, enable bot configuration, fill in the name and upload an icon. You can use the Flashduty official icon, then save.

3. Configure Application URLs

Enter the Application Capabilities - Web Application page

Configure Application Homepage URL and PC Homepage URL with the content from the integration details' Application Homepage URL and PC Homepage URL.

Click Save in the upper right corner.

4. Configure Event Subscription

On the Development Configuration - Event Subscription page, configure the Request URL with the content from the integration details' Event Subscription Request URL, then Save.

Below the Save button, select three group chat events: Group Chat Name Change, Cool App Installation in Group, and Cool App Uninstallation in Group, then Save.

5. Apply for Application Permissions

Enter the Permission Management page, apply for qyapi_chat_manage and qyapi_robot_sendmsg permissions. These two permissions will allow the current application to obtain its own group chat information and send messages to groups or individuals.

IV. Application Release and Usage

After completing the above steps, go to Application Release - Version Management and Release, create a new version, then proceed with the release (make sure to adjust the visibility to all employees, otherwise others cannot use it)

After the application is released, you can access it via mobile/PC client. First-time access requires login and account association (Dingtalk 《-》 Flashduty), subsequent uses will be login-free.

Mobile: Access the web application through Dingtalk > Workspace > Search application name > Open application.

PC: Access the web application through Dingtalk > Workspace > Search application name > Open application.

V. Common Issues

Cannot deliver messages to individuals, operation record shows Application Not Associated?

Go to Dingtalk > Workspace > Search application name > Open application, complete one login and account association (Dingtalk 《-》 Flashduty), so the system can obtain user identity for message pushing

Message card buttons are ineffective or show errors?

Go to Dingtalk > Workspace > Search application name > Open application, complete one login and account association (Dingtalk 《-》 Flashduty). If already logged in, try clicking the menu in the upper right corner, switch accounts, and log in again to bind the account

Ensure you have purchased sufficient licenses. You can check license usage in Console > Billing Center

Escalation rule Dingtalk group chat list is empty?

Go to Dingtalk, select group chat and install the Cool App, otherwise the group chat list cannot be obtained

Return to the escalation rule configuration page, refresh and reselect the group chat list

If still unable to get the group chat list, try uninstalling the Cool App from the group and repeat the above steps. If it still doesn't work, please contact customer or dedicated technical support

Dingtalk Custom Application API Call Limits: Dingtalk Documentation

Dingtalk Version	Total Calls/Month	QPS	Refresh Time
Standard	10,000	20	1st of each month
Professional	500,000	40	1st of each month
Enterprise	5,500,000	60	1st of each month

Note: Messages cannot be pushed normally after exceeding limits, please use notification channels reasonably

Dingtalk Integration

I. Create Dingtalk Application#

1. Create Custom Application#

2. Copy Enterprise CorpId#

3. Copy Application Credentials#

4. Copy Event Subscription Information#

II. Add Dingtalk Integration#

III. Configure Dingtalk Application#

1. Add Cool App, Web App, and Bot#

2. Configure Bot and Message Push#

3. Configure Application URLs#

4. Configure Event Subscription#

5. Apply for Application Permissions#

IV. Application Release and Usage#

V. Common Issues#