This document describes the preparatory operation process for connecting the Dora platform to a WeCom bot. Complete the steps in order. Otherwise, the system will be unable to access WeCom usernames/IDs.
(1) You must have the permission on the WeCom admin console.
(2) You have configured a domain name for the Dora service.
(3) You have obtained the egress IP address of the Dora service (used for WeCom trusted IP address configuration).
Log in to the WeCom Admin Console as the WeCom administrator, choose App Management > Apps > Self-built, and create an app.
Set the app logo, app name, and visibility range. The visibility range must include the users/departments using the bot within the enterprise. You are advised to select all members.
After creating the self-built app, you will automatically be redirected to the app configuration details page. Under Features > Receive messages, click Set to receive messages via API to enter the message reception server configuration page.
(1) Refer to the following rules to obtain the URL:
https://{Dora service domain name}/{FineBI service suffix}/external/api/im/config/wecom/callback
Examle: https://www.example.com/decision/external/api/im/config/wecom/callback
(2) Click Get randomly for the system to automatically generate the Token and EncodingAESKey.
Log in to the Dora management backend as the super administrator, choose User Management > IM User Mapping, click the Configure button next to App Connection, enter the Token and EncodingAESKey obtained in the previous step into the pop-up box, and click Next to complete the connection.
Return to the WeCom Admin Console and save the API reception configuration set in section "Configuring API Reception Information."
Return to the self-built app configuration details page, choose Developer API > Company's Trusted IP, click Settings, add the egress IP address of the Dora service in the pop-up box, and click OK to complete the whitelist configuration.
(1) In the Self-built area, click Dora to enter the configuration details page, and click View next to Secret to obtain the CorpSecret.
(2) Choose My Company > Company Information, scroll down the page, and obtain the company ID.
Log in to the Dora management backend as the super administrator, choose User Management > IM User Mapping, continue to the next step in the section "Configuring App Connection on the Dora Management Backend", enter the CorpSecret and CorpId just obtained in the pop-up box, and click Test Connection and Save. When the page displays "Configured", the configuration is successful.