Feishu/Lark

​

1. Create Feishu/Lark App

---

​

1. Create Custom App

Visit Feishu/Lark Developer Console to create an enterprise custom app. You can use the Flashduty official icon as the app icon. For details, see Feishu/Lark development documentation Create Enterprise Custom App.

​

2. Copy Credential Information

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

​

3. Copy Event Callback Token Information

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

​

2. Add Feishu/Lark Integration

---

Return to Flashduty On-call Integration Center page, select Instant Messaging → Feishu/Lark, fill in Name and the App ID, App Secret, Verification Token, and Encrypt Key copied in the previous step, then click Save to complete creation. After successful creation, you’ll see the added Feishu/Lark integration in the list. Click its name to enter the details page to view Web Configuration URL, Redirect URL, and Message Card Request URL, which will be used in subsequent steps.

​

3. Configure Feishu/Lark App

---

​

1. Enable and Configure App Capabilities

1. Return to Feishu/Lark Developer Console, enter the Feishu/Lark app you just created, go to Add App Capabilities → Add by Capability page, and enable both Web App and Bot capabilities.

2. Go to Web App page, configure Desktop Homepage and Mobile Homepage, both using the Web Configuration URL from integration details. See Feishu/Lark development documentation Configure App Homepage URL.

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

• im.chat.disbanded_v1
• im.message.receive_v1

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

• card.action.trigger
• card.action.trigger_v1

​

2. Add Redirect URL to Feishu/Lark App

Go to Security Settings page, configure Redirect URL, content is the Redirect URL from integration details. See Feishu/Lark development documentation Configure Redirect URL.

​

3. Request App Permissions

Go to Permission Management page, request the following permissions for the group app created in previous steps:

• im:chat: Get and update group information
• im:message: Get and send direct/group messages
• contact:user.id:readonly: Get user ID by phone number or email

​

4. Publish and Use App

After completing all the above configurations, please publish the app. It can be used after admin approval. See Feishu/Lark development documentation App Publishing and Usage. After publishing, you can access the app via Mobile or Desktop. First access requires login to link Feishu/Lark and Flashduty accounts; subsequent access will be passwordless.

​

5. Configure War Room

Ensure the app has been granted the additional permissions required for War Room functionality.

After completing the previous steps, in the Flashduty On-call integration configuration page’s Enhanced Features section, check Enable War Room to activate this feature—no additional configuration needed.

​

6. FAQ