Skip to main content
This documentation supports Third-Party App Integration or Custom App Integration methods.
Third-Party App Integration and Custom App Integration only need to configure one method as needed.

1. Third-Party App Integration

As a WeCom service provider, Flashduty provides a long-term free version of the Flashduty app. This app requires WeCom API call authorization to use (passwordless login + message sending). This authorization currently supports up to 60 days free; beyond this usage period, Flashduty needs to purchase WeCom licenses for you before you can continue using it.
  1. Visit WeCom Admin Console, go to App Management → Apps page, click Add Third-Party App. 2025-09-18-11-36-22
  2. Enter Flashduty in the search bar, after finding the app, click Add. 2025-09-18-11-38-57
  3. Modify app Visibility, recommend selecting all employees or specific department nodes to avoid modifying when new enterprise members join. Then click Agree to the above authorization and add to complete installation. 2025-09-18-12-05-07
  4. Visit WeCom Admin Console, go to My Enterprise page, get Corp ID. 2025-09-18-11-44-54
  5. Return to Flashduty On-call integration configuration page, fill in the Corp ID obtained in the previous step, click Save to complete integration.

2. Custom App Integration

  1. Visit WeCom Admin Console, go to App Management → Apps page, click Create App. 2025-09-18-11-46-44
  2. Configure App Logo, App Name, and App Visibility. 2025-09-18-11-49-18
  3. Return to Flashduty On-call integration configuration page, select whether your WeCom is Non-private deployment version based on your actual situation. If your WeCom is a private deployment version, you need to fill in Endpoint in the configuration page. This address needs to be accessible by Flashduty services—you may consider setting up whitelist authorization for it.
  4. Visit WeCom Admin Console, go to My Enterprise page, get Corp ID, and fill it in the Flashduty On-call integration configuration page.
  5. Return to WeCom Admin Console, go to App Management page, click the app you created to enter details page. Get AgentId from the page and fill it in the Flashduty On-call integration configuration page.
  6. On the app details page, get Secret and fill it in the Flashduty On-call integration configuration page.
  7. On the app details page, go to Web Authorization & JS-SDK page, click Set Trusted Domain, and configure as required.
The trusted domain needs to point to Flashduty On-call’s backend address {api_host} (achievable via CNAME or proxy forwarding). For trusted domain requirements, see WeCom official documentation Enterprise Internal Development Domain Configuration Guide.
2025-10-15-10-30-56 Return to Flashduty On-call integration configuration page, fill in this domain and complete verification.
  1. On the app details page, go to Receive Messages page, and Set API Receive. Click Random Generate for Token and EncodingAESKey respectively, then copy and save the generated values. 2025-09-18-11-58-45 Return to Flashduty On-call integration configuration page, fill in the saved Token and EncodingAESKey, click Save to complete integration.
  2. Copy the Callback URL from Flashduty On-call integration details page, return to WeCom’s Receive Messages page. In API Receive settings, fill in this Callback URL and the Token and EncodingAESKey saved in the previous step, then click Save. 2025-09-18-11-56-43
  3. Configure Frontend Trusted Domain
The trusted domain needs to point to Flashduty On-call’s frontend address console.flashcat.cloud (achievable via CNAME or proxy forwarding). For trusted domain requirements, see WeCom official documentation Enterprise Internal Development Domain Configuration Guide.
After frontend trusted domain verification passes, configure the generated Homepage URL to the WeCom app’s Workspace App Homepage 2025-10-14-19-51-01
  1. Configure Trusted IP Address: 47.93.12.134
2025-10-14-20-26-45

3. Configure War Room

War Room functionality is only supported in Custom App Integration mode.
After completing 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.

4. FAQ

  • Please check if you’ve completed the app installation steps. For example, can you see the Flashduty On-call app in WeCom Workspace
  • Please check if you’ve correctly configured Corp ID
  1. Login to WeCom client (desktop or mobile), go to Workspace, find and open the Flashduty app
  2. First entry requires login. Select your member account, after successful login via password or SSO, Flashduty account and WeCom account will be linked
  3. Subsequent app access will be automatically passwordless
  1. Before sending notifications, account linking must be completed as described in the previous question
  2. Go to the specified channel, navigate to Escalation RulesPersonal Channel, select WeCom as notification method
  3. Flashduty On-call supports customizing WeCom notification content. Go to Template Management page to set custom templates
Custom area can display up to 8 lines; excess will be truncated by WeCom.
2025-09-18-12-02-26
  • Click card message to go directly to alert details page
  • Click Start Processing to directly set alert to Processing status
  • Click Close Directly to directly set alert to Closed status
  • Click Snooze 2 hours to snooze the alert for 2 hours. For longer snooze times, click ... in the card’s top-right corner for more snooze options
Due to WeCom limitations, after one card interaction, it can only be updated once within 72 hours. Each button operation counts as one interaction.When alert status changes, Flashduty On-call requests to update card content. When alert status changes frequently, cards may not update in real-time due to exceeding update limits. You can click the Refresh button to manually get one card status update opportunity.
Mac desktop defaults to opening links with WeCom’s built-in browser. Try using shortcut ctrl + command + shift + d to enable debug mode, then select DebugBrowser, WebView RelatedOpen Webpage with System Browser to change link opening method. Use the same shortcut to disable debug mode; settings will be preserved.
Please contact Flashduty customer service or your dedicated technical support to purchase and enable the license.
See the FAQ section in War Room documentation.
Please confirm whether the domain in the redirect_uri parameter of the App Homepage URL has completed WeCom’s required domain ownership verification. See WeCom official documentation Enterprise Internal Development Domain Configuration Guide.