Winmail 6.2-6.3 企业微信绑定

功能简介


    申明:本功能利用腾讯公司提供的微信平台开发接口,腾讯公司有权随时修改接口,可能会导致部分或者全部相关功能无法使用,所以我们不能保证本功能一直可以正常使用。

     Winmail 6.2(0620) 以上才能支持与企业微信(认证或者未认证)绑定,在企业微信里自建邮件微应用,可以实现新邮件微信通知和企业微信APP通知;微应用里可以也定制邮件相关菜单项,微信邮件微应用中免登录直接收发邮件。

     按照目前企业微信开发接口的要求,Winmail 的 Webmail 必须使用 http 80 端口(或者 https 协议的 443 端口),要可以使用域名访问,域名也必须做过工信部备案,不支持使用 IP 的访问地址。[ 本文假设 Webmail 访问地址为: http://mail.abc.com (具体设置时请使用自己的域名代替)]

     试用版、标准版、白金版支持本功能,基础版不支持,本功能可以和短信提醒功能、阿里钉钉绑定功能同时使用。Winmail 必须升级到 Winmail 6.2(0620) 以上版本。
    (2018,8,21 更新)

1. 企业微信申请


     1. 需要一个企业微信帐号,已有企业微信可以直接使用,没有的话,请到 企业微信平台 申请, 主体类型有企业、政府、组织,需要提供组织信息,未办理组织机构代码证的可以注册企业,需要绑定一个个人微信号做为管理员。

     2. 注册成功后,最大支持200个成员加入,如果需要更多成员要按照腾讯要求付费认证,认证后成员可以达到2000以上。

2. 设置步骤


         1. 登录 企业微信平台 进入"应用与小程序",点击"自建"-"+创建应用":
                添加Logo: 平台建议上传图片尺寸为750x750,大小不超过1M。一般使用一个正方的图片就可以了,以后还可以变更
                应用名称: 例如:公司邮件系统
                应用可见范围: 自己设置,一般是整个组织,测试时可以先给自己所在的组
                提交保存。

         2. 再进入这个"公司邮件系统"应用进行下一步设置,记录下来 "AgentId 应用ID" 和 "Secret",后面在 Winmail 里需要使用。
                点击 "网页授权及JS-SDK"-"设置可信域名",设置成:mail.abc.com,不需要"申请校验域名"
                点击 "接收消息"-"设置API接收":
                        URL:先不用设置
                        Token: "随机获取",记录下来。
                        EncodingAESKey:"随机获取",记录下来。
                        本次操作是为了记录 Token, EncodingAESKey 数据,不用保存

        winmail 微信

         3. 进入"我的企业"-"企业信息",记录下来 "CorpID"。

         4. 登录 Winmail 管理端工具,进入"系统设置"-"新邮件提醒",在"短消息设置"里,
              选择"启用新邮件通知"-"微信"-"企业微信"-"设置",输入正确的:
                 CorpID: 上面的"CorpID"
                 CorpSecret: 上面的"Secret"
                 Token/回调 token: 上面的"Token"
                 EncodingAESKey/回调 AESKey: 上面的"EncodingAESKey"
                 Webmail URL: http://mail.abc.com (具体设置时请使用自己的域名代替)
                 应用ID/企业应用 ID: 上面的"AgentId"
                 "确定"-"应用" 保存设置(一定要保存,保存后可以点击其他功能:例如"防病毒设置",再回到"新邮件提醒"检查一下设置)

        winmail 微信

         5. 再登录 企业微信平台,进入"应用与小程序",点击上面的"公司邮件系统"应用,
                点击"接收消息-设置API接收":
                URL:http://mail.abc.com/qywx.php?mod=verify (具体设置时请使用自己的域名代替)
                Token: 上面的"Token"。
                EncodingAESKey:上面的"EncodingAESKey"。
            保存,提示错误(echostr校验失败,请您检查是否正确解密并输出明文echostr)的话,把上面的操作再核对检查一下,
            还有可以使用浏览器访问一下 http://mail.abc.com/qywx.php?mod=verify (具体设置时请使用自己的域名代替),页面上应该显示:
                ERR: echostr invalid
             如果还是提示错误同时 Webmail 使用IIS的,可能是 PHP 模块不全,建议改成 Winmail 自带的Apache。
             如果服务器系统是 Windows 2003,确认网络没有问题,还是出错,请更新 IE 到 IE8 以上版本,并且更新 Windows 系统补丁,确定安装了 KB968730 补丁。下载 百度云网盘共享下载

        winmail 微信

3. 邮箱用户绑定企业微信


    登录 Webmail,进入"新邮件提醒",使用个人的企业微信APP扫描页面上的二维码(注意:这个二维码是 Winmail 生成的,一次性有效,只用于绑定这个邮箱帐号)。

    如果企业微信APP里提示: ... 获取成员信息失败!(非企业成员)请联系管理员加入企业微信帐号 ..., 代表这个微信帐号没有加入企业微信里, 管理员必须将用户加到企业微信的通讯录(身份验证字段:手机)里,用户正常加入后,要重新扫描上面的二维码绑定邮箱。

    如果企业微信APP里提示: redirect_uri 参数错误; 代表上面可信域名设置不对,要正确设置,例如。"mail.abc.com" (具体设置时请使用自己的域名代替)

        winmail 微信设置

    如果登录 Webmail 看不到"新邮件提醒",请检查管理端以下设置:

        1. 在"用户和组"里检查这个用户的"权限设置"属性,确定"禁用新邮件通知"没有选中,可以选择多个用户批量修改这个权限。
        2. 进入"系统设置"-"新邮件提醒"-"短信息设置",确定"□启用新邮件通知"、"□微信-服务号"已经选中,"用户列表"里该用户有使用权限 。
        3. 进入"系统设置"-"高级设置"-"Webmail 设置"-"登录后设置",确定"□允许用户启用新邮件通知"已经选中。
        4. 修改上面的设置后,Webmail 需要重新登录。

    成功的话企业微信APP会收到一个绑定通知。 等一段时间后 Webmail 里会显示绑定的微信用户头像和昵称,可以发一封邮件到此邮箱,测试是否收到企业微信APP通知,收到的消息是否可以打开这封邮件。

        winmail 微信

4. 工作台应用设置


     登录 企业微信平台:
         进入"应用与小程序",点击上面的"公司邮件系统"应用,设置"工作台应用主页"-"设置应用主页": http://demo.abc.com/qywx.php?mod=msglist

5. 自定义通知消息底部菜单


     登录 企业微信平台:
         进入"应用与小程序",点击上面的"公司邮件系统"应用,设置"自定义菜单"-"设置",可以增加以下菜单项("菜单内容" 选择 "跳转到网页"):

                 收件箱 http://mail.abc.com/qywx.php?mod=msglist(具体设置时请使用自己的域名代替,下同)
                 写邮件 http://mail.abc.com/qywx.php?mod=compose
                 邮件夹 http://mail.abc.com/qywx.php?mod=folder
                

其他


     1. 可以登录 Winmail 管理端,进入"系统状态"-"短消息队列",可以看到待发的提醒。进入"系统日志"-"MSMS",可以看到 Winmail 发出的微信消息记录和出错信息。

        winmail 微信提醒日志


     2. 不要在两台 Winmail 里使用同一个企业微信下的同一邮件应用; 更换服务器,Token 和 EncodingAESKey 最好要到 企业微信平台 重新设置一下。

     3. 如果 Winmail MSMS 日志里出现 ... open weixin failed.get http request failed 错误提示,可能是服务器网络问题无法访问微信的接口网站, 可以用IE测试一下 https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN, 正常的话页面会显示"errcode 40014 errmsg "invalid access_token"",如果不能访问,请检查网络、防火墙等设置。

     4. 如果 Winmail MSMS 日志里出现 send qiyewx message to XXX.XXX failed, unknow error 错误提示,如果从微信企业号升级到企业微信的, 请升级到 Winmail 6.2(0620),然后再测试,有问题请对照本文一步一步检查设置。

     5. 如果是 Winmail 6.2-6.3 版本经常出现提示输入用户名和密码的界面,重新绑定邮箱又正常的情况,可以登录 Winmail 管理端:" 系统设置" /" 高级设置" /" Webmail 设置" /" 首页设置" , 把 "Webmail启用IP检查" 关闭。