How to Enable WeCom Integration (Platform Edition)

1. Log in to the WeCom Service Provider Console: https://open.work.weixin.qq.com (register and complete qualification verification if you don't have an account)

2. Go to the Service Provider Info page and configure the IP whitelist (all public IPs of servers where HAP microservices are deployed).

   

3. Go to App Management > Login Authorization.

   Add the Login Authorization Initiation Domain (HAP system access domain).

   

   Add the Authorization Completion Callback Domain (HAP system access domain). When adding the callback domain, domain ownership verification is required. Download the provided .txt verification file and coordinate with the HAP team to complete the configuration. Verify it is accessible at {HAP domain}/WW_verify_xxxxxx.txt.

   

4. Go to App Management > General Development Parameters.

   

   note

   System Event Receiving URL, Token, and EncodingAESKey are provided by HAP.

   After configuration, provide the CorpID and ProviderSecret to HAP.

5. Go to App Management > Custom Development > Create Custom Development App Template.

   

   1. Configure basic info: set the template logo, name, description, etc.

      

   2. Configure development info.

      note

      Custom Development Template Callback URL, Token, and EncodingAESKey are provided by HAP.

      After configuration, view the app template info and provide the Template Name, Template ID, and Template Secret to HAP.

      

6. Go to App Management > Custom Development App Launch > Submit for Launch. Submit the created custom development template for launch. Once approved, enterprise admins can scan the template authorization QR code to begin custom development.