hsoa main 如何配置企业微信端

## 为hsoa main 站点配置公网可访问的域名
如要启用企业微信端，首先要保证 hsoa main 站点有一个公网可访问的域名
本文档示例服务器使用的域名为：testoa.jzkg.cn 具体的配置方法参考 http://doc.jzkg.cn/doc/389/  配置IIS站点章节。 配置好之后，可通过域名直接访问站点：http://testoa.jzkg.cn 如下图所示：
![](/media/202202/域名访问_20220215201839487944.png)

## 申请企业微信
如要启用企业微信端，首先要向腾讯申请企业微信，具体参考腾讯官方相关介绍，此处不予赘述。https://work.weixin.qq.com/

## 企业微信配置步骤
### 创建应用
1. 在“应用管理”页，点击“创建应用”创建一个新的应用。
![](/media/202202/wx1_20220215202115378350.jpg)
![](/media/202202/wx2_20220215202124402237.jpg)
### 配置应用
1. 用记事本打开App_Data/DB/wechat/wechatmenu.txt,将其中的oa.yixinjie.com替换成testoa.jzkg.cn，将其中的wx140c0ab9dfcd2cad替换成你自己的CorpId，即appid就是CorpId。注意不要包含任何空格、特殊符号。CorpId的获取在下面第4步会讲到，如果暂时不知道CorpId可以先跳过这一步，待下面第4步做完之后，再做这一步。
2. 在企业微信管理平台，应用管理页，“网页授权及JS-SDK”处设置“可作为应用OAuth2.0网页授权功能的回调域名”为：testoa.jzkg.cn
3. 点击“申请域名校验”并按提示完成域名校验。

以下步骤所述的“参数设置”均指 hsoa main 的“设置” - “更多设置” - “参数设置”。

4. 设置“参数设置”中的CorpId、AgentId和AppSecret。
CorpId的获取见下图，CorpId即企业Id：

![](/media/202202/111_20220216101756854644.png)
AgentId和AppSecret的获取见下图：
![](/media/202202/无标题_20220215214223929861.png)
需要说明的是，必须下载企业微信App，才能获取到AppSecret。

4. 在“接收消息”点击“设置API接收”，在URL处填写：http://testoa.jzkg.cn/wechat/init.aspx?p=jzjt 其中的jzjt为当前租户的企业标识，请替换成你自己的。Token和EncodingAESKey 均点击“随机获取”自动生成。生成之后，先不要点击“保存”，先将这两个参数保存到“参数设置”中对应的token和EncodingAESKey，然后再回到本页面，点击保存。如果设置正确，保存时，会提示“保存成功”。否则可能会提示“openapi回调地址请求不通过”，此时应该查看你的参数设置是否正确。
请务必注意上面各参数的设置顺序！。
OA中“参数设置”页面相关参数

![](/media/202202/wx-d_20220215214101018083_20220216101958921382.png)

5. 用浏览器打开页面 http://testoa.jzkg.cn/wechat/CreateWechatMenu.aspx?p=jzjt 其中的jzjt为当前租户的企业标识，请替换成你自己的，将看到输入密码页面。密码存放在服务器端wechat/CreateWechatMenu.aspx页面中，用记事本打开该页面找到密码，如下图所示。

![](/media/202202/111_20220216100109360561.png)
系统提示：“命令已调用，请到日志中查看执行结果！”，此时请到服务器端的App_Data/log文件夹中查看日志，如果日志输出：
{"errcode":0,"errmsg":"ok"} 则代表执行成功，用企业微信APP进入后，将能看到该应用底部的菜单。

执行完毕后，务必用记事本将初始密码改掉，否则任何一位能访问你的系统的，都可以修改你的信息。

6. 至此，企业微信端就已经配置完毕。 需要注意的是，要为每位员工设置一个唯一的企业微信Id，员工才能正式使用。在创建新员工的步骤，按照系统提示一步步操作即可。如果想启用系统内置的admin账号的企业微信端，可在hsoa main “设置” - “企业微信绑定” ，找到admin，点击红色的“未创建”，按照提示为admin创建一个微信端即可。