Feishu (Lark) Integration Guide

Integrate with Feishu(Lark) custom application to receive and respond to alerts within Feishu/Lark.

I. Create Feishu/Lark Application

1. Create Custom Application

Visit Feishu/Lark Developer Console to create an internal custom application. (For details, see Feishu/Lark development documentation - Create Enterprise Custom Application)

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

2. Copy Credentials

Go to the Credentials & Basic Info page, copy the App ID and App Secret for later use.

3. Copy Event Callback Token Information

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

II. Add Feishu/Lark Integration

Return to Flashduty Integration Center page, select Instant Messaging => Feishu/Lark, fill in the Name and the previously copied App ID, App Secret, Verification Token, and Encrypt Key, then click save to create.

After creation, you'll see the newly added Feishu/Lark integration in the list. Click on the name to enter details, where you'll find the Web Configuration URL, Redirect URL, and Message Card Request URL information, which will be used in later steps.

III. Configure Feishu/Lark Application

1. Enable and Configure Application Capabilities

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

2). Go to Web Application page, configure both Desktop Homepage and Mobile Homepage with the Web Configuration URL from the integration details.

(See Feishu/Lark development documentation - Configure Application Homepage URL)

3). Go to Event Callbacks - Callback Configuration page, configure the Message Card Request URL (using the Message Card Request URL from integration details) and add the callback.

2. Add Redirect URL to Feishu/Lark Application

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

(See Feishu/Lark development documentation - Configure Redirect URL)

3. Request Application Permissions

Go to Permission Management page, request im:chat and im:message permissions. These permissions will allow the application to access its group chat information and send messages to groups or individuals.

IV. Application Publication and Usage

After completing the above steps, proceed with application publication and usage. The application can be used after administrator approval.
Note: Available Range needs special configuration, recommended for All Employees.

See Feishu/Lark development documentation - Application Publication and Usage.

Once published, you can access the application via mobile/PC client. First-time access requires login and account association (Feishu/Lark 《-》 Flashduty), subsequent uses will be login-free.

Mobile: Access the web application through Feishu/Lark > Workspace > Search application name > Open application.

PC: Access the web application through Feishu/Lark > Workspace > Search application name > Open application.

V. Common Issues

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

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

Message card buttons not working or showing errors?

Ensure account association is completed. Go to Feishu/Lark > Workspace > Search application name > Open application, complete one login and account association (Feishu/Lark 《-》 Flashduty). If already logged in, try clicking the top-right menu to switch accounts and re-login to bind the account

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

Empty Feishu/Lark group chat list in escalation rule?

Go to Feishu/Lark, select group chat conversation, add the created Flashduty bot as shown below:

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

Feishu/Lark Custom Application API Limits: Feishu/Lark Documentation

Call Volume Limits:

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

Frequency Control Limits:

Scenario	Limit
All APIs	Maximum 50 calls/second per application
Message Sending API	Maximum 1000 calls/minute per application
Group Bot Webhook	Maximum 100 calls/minute
Sending messages to the same user or group	Maximum 5 calls/second

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

Feishu (Lark) Integration Guide

I. Create Feishu/Lark Application#

1. Create Custom Application#

2. Copy Credentials#

3. Copy Event Callback Token Information#

II. Add Feishu/Lark Integration#

III. Configure Feishu/Lark Application#

1. Enable and Configure Application Capabilities#

2. Add Redirect URL to Feishu/Lark Application#

3. Request Application Permissions#

IV. Application Publication and Usage#

V. Common Issues#