Feishu (Lark) Integration Guide

By integrating a custom Feishu/Lark application, you can receive and respond to alerts within Feishu/Lark.

1. Create Feishu/Lark application

1. Create a custom application

Visit Feishu/Lark Developer Console and create an internal custom application. You can use the official Flashduty icon for the application icon.

For details, see the Feishu/Lark development documentation Create an internal custom application.

2. Copy credential information

Go to the Credentials and Basic Information page and copy the App ID and App Secret for later use.

3. Copy the event callback Token information

Go to Development Configuration → Events & Callbacks → Encryption Strategy page, generate and copy the Encrypt Key (recommended for better security) and Verification Token for later use.

2. Add Feishu/Lark integration

Return to the Flashduty Integration Center page, select IM → Feishu/Lark, fill in the Name and the App ID, App Secret, Verification Token, and Encrypt Key copied in the previous step, then click Save to complete the creation.

After successful creation, you will see the added Feishu/Lark integration in the list. Click its name to enter the details page, where you can view the Web Configuration address, Redirect URL, and Message Card Request URL, which will be used in subsequent steps.

3. Configure Feishu/Lark application

1. Enable and configure application capabilities

Return to the Feishu/Lark Developer Console, enter the created Feishu/Lark application, go to Add Application Capabilities → Add by Capability page, and enable both Web Application and Bot capabilities.

Go to the Web app page and configure the Desktop Homepage and Mobile Homepage, both using the Web configuration address from the integration details.

For details, see the Feishu/Lark development documentation Configure application homepage address.

Go to Event Callbacks → Event Configuration page, configure the Request URL (using the Message Card Request URL from the integration details). Then, add the following two events:

im.chat.disbanded_v1

im.message.receive_v1

Go to Event Callbacks → Callback Configuration page, configure the Request URL (using the Message Card Request URL from the integration details). Then, subscribe to the following two callbacks:

card.action.trigger

card.action.trigger_v1

2. Add redirect URL to Feishu/Lark application

Go to the Security Settings page and configure the Redirect URL using the Redirect URL from the integration details.

For details, see the Feishu/Lark development documentation Configure redirect URL.

3. Apply for application permissions

Go to the Permission Management page and apply for the following permissions for the group application created in the previous steps:

im:chat: Get and update group information

im:message: Get and send single chat and group messages

contact:user.id:readonly: Get user ID by phone number or email

4. Application release

After completing all the above configurations, please release the application. It can be used after administrator approval.

For details, see the Feishu/Lark development documentation Application release and usage.

To ensure that everyone can use the application, adjust the application visibility to all employees before releasing the application.

After the application is released, you can access it via mobile or PC. The first access requires login to link your Feishu/Lark and Flashduty accounts. Subsequent access will be login-free.

Mobile: Access via Feishu/Lark → Workplace → Search for application name → Open Application to use the web application.

PC: Access via Feishu/Lark → Workplace → Search for application name → Open Application to use the web application.

5. Configure war room

Ensure the application has been authorized with the additional permissions required for the war room feature.

After completing the previous steps, in the Enhanced Features module of the Flashduty integration configuration page, check Enable War Room to enable this feature without additional configuration.

6. FAQ

Messages cannot be delivered to individuals, and the operation log shows app not linked?

Go to Feishu/Lark → Workplace → Search for application name → Open Application, complete login once to link your Feishu/Lark and Flashduty accounts, so the system can obtain user identity for message push.

Message card buttons are unresponsive or show errors?

Ensure the account has been linked. You can go to Feishu/Lark → Workplace → Search for application name → Open Application to complete login once. If you have 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 the license usage in Console → Billing Center.

The Feishu/Lark group chat list in escalation rules is empty?

Go to Feishu/Lark and add the created Flashduty bot to the specified group chat.

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

Feishu/Lark custom application API limits?

Call volume limits:

Feishu/Lark Version	Total Calls/Month	Refresh Time
Basic Free	10,000	1st of each month
Other Versions	Unlimited	-

Rate limits:

Scenario	Limit
All APIs	Max 50 calls/second per app
Send message APIs	Max 1000 calls/minute per app
Group bot webhook	Max 100 calls/minute
Send to same user or group	Max 5 calls/second

After exceeding API call limits, the Feishu/Lark application will not be able to push messages normally. It is recommended to use notification channels reasonably. See Feishu/Lark official documentation for details.

Why is the war room feature not working as expected?

Please check again whether you have configured the required permissions for the war room feature.

Please refer to the FAQ section of the Flashduty War Room Introduction.

Feishu (Lark) Integration Guide

1. Create Feishu/Lark application#

1. Create a custom application#

2. Copy credential information#

3. Copy the event callback Token information#

2. Add Feishu/Lark integration#

3. Configure Feishu/Lark application#

1. Enable and configure application capabilities#

2. Add redirect URL to Feishu/Lark application#

3. Apply for application permissions#

4. Application release#

5. Configure war room#

6. FAQ#