为hsoa main 站点配置公网可访问的域名
如要启用企业微信端,首先要保证 hsoa main 站点有一个公网可访问的域名
本文档示例服务器使用的域名为:testoa.jzkg.cn 具体的配置方法参考 http://doc.jzkg.cn/doc/389/ 配置IIS站点章节。 配置好之后,可通过域名直接访问站点:http://testoa.jzkg.cn 如下图所示:
申请企业微信
如要启用企业微信端,首先要向腾讯申请企业微信,具体参考腾讯官方相关介绍,此处不予赘述。https://work.weixin.qq.com/
企业微信配置步骤
创建应用
- 在“应用管理”页,点击“创建应用”创建一个新的应用。
配置应用
- 用记事本打开App_Data/DB/wechat/wechatmenu.txt,将其中的oa.yixinjie.com替换成testoa.jzkg.cn,将其中的wx140c0ab9dfcd2cad替换成你自己的CorpId,即appid就是CorpId。注意不要包含任何空格、特殊符号。CorpId的获取在下面第4步会讲到,如果暂时不知道CorpId可以先跳过这一步,待下面第4步做完之后,再做这一步。
- 在企业微信管理平台,应用管理页,“网页授权及JS-SDK”处设置“可作为应用OAuth2.0网页授权功能的回调域名”为:testoa.jzkg.cn
- 点击“申请域名校验”并按提示完成域名校验。
以下步骤所述的“参数设置”均指 hsoa main 的“设置” - “更多设置” - “参数设置”。
- 设置“参数设置”中的CorpId、AgentId和AppSecret。
CorpId的获取见下图,CorpId即企业Id:
AgentId和AppSecret的获取见下图:
需要说明的是,必须下载企业微信App,才能获取到AppSecret。
- 在“接收消息”点击“设置API接收”,在URL处填写:http://testoa.jzkg.cn/wechat/init.aspx?p=jzjt 其中的jzjt为当前租户的企业标识,请替换成你自己的。Token和EncodingAESKey 均点击“随机获取”自动生成。生成之后,先不要点击“保存”,先将这两个参数保存到“参数设置”中对应的token和EncodingAESKey,然后再回到本页面,点击保存。如果设置正确,保存时,会提示“保存成功”。否则可能会提示“openapi回调地址请求不通过”,此时应该查看你的参数设置是否正确。
请务必注意上面各参数的设置顺序!。
OA中“参数设置”页面相关参数
- 用浏览器打开页面 http://testoa.jzkg.cn/wechat/CreateWechatMenu.aspx?p=jzjt 其中的jzjt为当前租户的企业标识,请替换成你自己的,将看到输入密码页面。密码存放在服务器端wechat/CreateWechatMenu.aspx页面中,用记事本打开该页面找到密码,如下图所示。
系统提示:“命令已调用,请到日志中查看执行结果!”,此时请到服务器端的App_Data/log文件夹中查看日志,如果日志输出:
{“errcode”:0,”errmsg”:”ok”} 则代表执行成功,用企业微信APP进入后,将能看到该应用底部的菜单。
执行完毕后,务必用记事本将初始密码改掉,否则任何一位能访问你的系统的,都可以修改你的信息。
- 至此,企业微信端就已经配置完毕。 需要注意的是,要为每位员工设置一个唯一的企业微信Id,员工才能正式使用。在创建新员工的步骤,按照系统提示一步步操作即可。如果想启用系统内置的admin账号的企业微信端,可在hsoa main “设置” - “企业微信绑定” ,找到admin,点击红色的“未创建”,按照提示为admin创建一个微信端即可。