This article introduces how to integrate DataWind with the WeCom application.

By creating a custom application on the WeCom side, you can integrate the DataWind mobile client with WeCom to complete the integration.
After completing the adaptation, users can search for the application in WeCom, open the DataWind mobile client, conveniently view reports, and achieve seamless access to data.
Common application scenarios:

• Mobile client integration
• Message push to WeCom

1. Create a WeCom application in your own WeCom tenant.
   
2. Fill in the application information.
   Set the logo as shown below; set the visibility range (can be set to visible to all members);
   
   Click Create Application.
   
3. Other configurations.
   When integrating WeCom in the office platform integration section, you need to provide:
   • AgentId: Application ID
   • Secret: Secret key
   • Company ID: Company ID
     For details, see Office Platform Integration.
     The WeCom administrator needs to obtain the following information from the location shown in the figure below:
     
     

After completing all the steps in "Pre-configuration instructions", continue with the following operations on the user management page of the Smart Data Insight product.

Account binding configuration #

In user management, bind the user's WeCom account to the DataWind account.

Custom menu configuration #

Click Custom Menu to configure the Home, Favorites, and Directory pages.


URLs:

• Home: https://【domain】/bi-h5?【region】
• Directory: https://【domain】/bi-h5/dashboardLIst?【region】
• Favorites: https://【domain】/bi-h5/favor?【region】

Example: If 【domain】 is console.volcengine.com and 【region】 is Shanghai, then the home page URL is: [https:// console.volcengine.com/bi-h5?region=cn-shanghai](https:// console.volcengine.com/bi-h5?region=cn-shanghai).

After this, you can use it from the mobile version of WeCom. Currently, manual login is required; stay tuned for the upcoming single sign-on feature.

Dashboard sharing configuration (for private deployment users only) #

1. Open WeCom admin console authorization and JS-SDK.
   On this page, open the DataWind application and click the area circled in the figure below.
   
2. Download the verification file.
   Click "Apply for domain verification".
   
   Click "Download file". Provide the downloaded verification file "WW_verify_xxxxx.txt" to the mobile deployment team. After completing the deployment configuration, proceed to the next step.
   
3. Configure trusted domains.
   Enter the domain name in the highlighted field: For example, in "https://work.weixin.qq.com/wework_admin/frame", "work.weixin.qq.com" is the domain name.
   
4. Configure the enterprise trusted IP.
   Under the developer interface, select Enterprise Trusted IP and click "Configure".
   
   Then, in the pop-up window, enter the enterprise IP address used externally by DataWind. Caution: Only IP addresses can be entered; domain names are not allowed.
   
   If any exceptions occur during configuration, refer to the third instruction in the Enterprise Trusted IP Configuration Guide for handling.
   

Permission configuration for information retrieval #

After the DataWind mobile client is integrated with the WeCom application, you need to enable permissions for retrieving relevant information in "Application Management" - "Authorization Information" on the WeCom Open Platform. The following information can then be obtained:

• Partial address book information: member information, department information (excluding phone numbers and email addresses)
• Basic enterprise information

For details on the information that can be obtained, see: WeCom Help Center

Push scenarios #

• Dashboard screenshot subscription sent to WeCom
• Push chart monitoring messages to WeCom
• Push dataset synchronization results to WeCom

Account binding configuration #

After completing all operations in the Pre-configuration Instructions, proceed with the following steps on the user management page of the Intelligent Data Insight product:
In user management, bind users' WeCom accounts to their product accounts. For details, see System Management Overview – Private Deployment Version.