功能简介

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

     Winmail 6.1-6.5(0125) 支持与已认证微信公众服务号绑定，可以实现微信里定制邮件相关菜单项，微信中免登录直接收发邮件。

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

重要更新：2017,10 起腾讯在微信服务号平台上去除了"新邮件通知"消息模版，这样就无法实现新邮件微信通知了，按照下面步骤只能定制邮件相关菜单项，直接微信中登录收发邮件。 建议改用企业微信，功能更全面，详细设置请参考 Winmail 企业微信绑定

1. 公众服务号申请和认证

     1. 需要一个微信公众服务号，一个主体可以申请多个公众号（50个），一般建议为邮件系统单独申请一个，没有的话，请到 微信公众平台 申请，类型选择"服务号"， 个人无法申请公众服务号，主体类型有政府、媒体、企业、其他组织，需要提供组织信息和运营者身份信息，需要绑定一个个人微信号做为管理员，注意服务号名称以后无法修改，请确定一个名称，这个名字以后会出现在微信里，可以使用：
        XXX公司邮件系统服务
        XXX公司信息部服务

     2. 因为本功能需要调用相关的 API 接口，按照腾讯公司要求要付费认证这个公众服务号，登录 微信公众平台，点击右上角的"未认证"，按照腾讯的提示认证，目前认证需要审核服务费用 300元/次/年，腾讯可提供正式发票，政府以及部分其他组织类型的公众账号，免收审核服务费用，认证有效期是一年，认证一般几个工作日内就可以完成。

2. 服务号设置

     登录 微信公众平台:
         1. 进入"设置"-"公众号设置"-"功能设置"， 将 mail.abc.com （具体设置时请使用自己的域名代替）加到 "业务域名" 、 "JS接口安全域名" 和 "网页授权域名"里。
            在"开发"-"基本配置"里，IP白名单: 请输入邮件服务器的外网出口IP，有多个都需要输入

         2. 记录并保存好以下信息：
             微信号：在"设置"-"公众号设置"-"账号详情"里。
             开发者ID(AppID)：在"开发"-"基本配置"里。
             开发者密码(AppSecret)：在"开发"-"基本配置"里，点击"重置"，按照提示取得。



         3. 申请"自定义菜单"：进入"功能"-"+添加功能插件"申请"自定义菜单"功能。

         4. 申请"模版消息"：进入"功能"-"+添加功能插件"申请"模版消息"功能，主营行业或者副营行业之一选择 "IT科技/IT软件与服务"，需要2-3天审核通过，审核没有通过以前，新邮件提醒功能不能使用。 如果已经有了"模版消息"功能，进入"功能"-"模版消息"-"模板库"，点击"修改行业"，主营行业或者副营行业之一选择为"IT科技/IT软件与服务"，一个月只能修改一次。

         5. 进入"设置"-"公众号设置"-"账号详情"，点击"二维码"-"下载更多尺寸"，建议下载"8cm"的二维码图片，保存成 weixin.jpg，拷贝 weixin.jpg 到 ~/server/webmail/www/customer，覆盖原始文件。

3. Winmail 设置

     1. 登录 Winmail 管理端，进入"系统设置"-"新邮件提醒"，在"短消息设置"里，选择"启用新邮件通知"、"微信"、"服务号"-"设置"，输入正确的："微信号"、"AppID"、"AppSecret"、"Webmail URL"http://mail.abc.com （具体设置时请使用自己的域名代替），"自定义 Token URL" 是为有多个第三方应用准备的，不用输入；保存-应用。



     2. 确定服务器可以使用IE浏览器正常访问微信接口网站，使用IE测试访问一下 https://api.weixin.qq.com/cgi-bin/message/template/send， 正常的话会提示下载一个 api.weixin.qq.com 的 send.json 文件，如果不能访问，请检查网络、防火墙等设置，使用其他浏览器正常会显示 errcode 41001 errmsg "access_token missing hint: ***"。 如果服务器系统是 Windows 2003，确认网络和防火墙没有问题，还是出错，请更新 IE 到 IE8 以上版本，并且更新 Windows 系统补丁，确定安装了 KB968730 补丁。 百度云网盘共享下载

4. 邮箱用户绑定微信

    登录 Webmail，进入"新邮件提醒"，使用个人的微信扫描页面上的二维码(注意：这个二维码是 Winmail 生成的，一次性有效，只用于绑定这个邮箱账号，和服务号的二维码不一样)。



    微信里会提示相关结果信息，如果没有关注此服务号，要按照提示关注，成功的话，微信会收到一个绑定通知。 等一段时间后 Webmail 里会显示绑定的微信用户头像和昵称，可以发一封邮件到此邮箱，测试是否收到微信通知，收到的消息是否可以打开这封邮件。

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

        1. 在"用户和组"里检查这个用户的"权限设置"属性，确定"禁用新邮件通知"没有选中，可以选择多个用户批量修改这个权限。
        2. 进入"系统设置"-"新邮件提醒"-"短信息设置"，确定"□启用新邮件通知"、"□微信-服务号"已经选中，"用户列表"里该用户有使用权限 。
        3. 进入"系统设置"-"高级设置"-"Webmail 设置"-"登录后设置"，确定"□允许用户启用新邮件通知"已经选中。
        4. 如果原6.0版本已经正常绑定微信的，请进入"系统设置"-"新邮件提醒"，先关闭"启用新邮件通知"，再启用，重新保存一下。
        5. 修改上面的设置后，Webmail 需要重新登录。

5. 微信菜单设置

     登录 微信公众平台:
         1. 进入"开发"-"基本配置"，确定"服务器配置" 是 "(未启用)"

         2. 进入"功能"-"自定义菜单"，可以增加以下菜单项（"菜单内容" 选择 "跳转网页"）：

                 登录 http://mail.abc.com/weixin.php?mod=login （具体设置时请使用自己的域名代替，下同）
                 邮件夹 http://mail.abc.com/weixin.php?mod=folder
                 写邮件 http://mail.abc.com/weixin.php?mod=compose
                 收件箱 http://mail.abc.com/weixin.php?mod=msglist

         下面的菜单项可选

                 解除绑定 http://mail.abc.com/weixin.php?mod=unbind
                 测试消息 http://mail.abc.com/weixin.php?mod=test

         菜单结构和名字自行决定，菜单修改发布成功后要24小时内生效，可以取消关注再重新关注以显示最新的菜单。

其他

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




     2. 不要在两台 Winmail 里使用同一个公众服务号。尽量不要同时使用其他的第三方微信应用或者自己开发的应用，确实需要的话请联系我们技术支持; 更换服务器，AppSecret(应用密钥) 最好要到 微信公众平台 重置一下。

     3. 如果 Winmail MSMS 日志里出现 [QUEUE] open weixin failed.get http request failed 错误提示，可能是服务器网络问题无法访问微信的接口网站， 可以用IE测试一下 https://api.weixin.qq.com/cgi-bin/message/template/send， 正常的话会提示下载一个 api.weixin.qq.com 的 send.json 文件。

     4. 微信公众平台 "功能"-"模版消息"-"我的模板"里，至少会有两个已经绑定的模版消息ID（新邮件通知、绑定通知）, Winmail 微信设置里点击"微信 token"会显示当前使用的消息ID。 如果平台上没有"模版消息"，进入"功能"-"+添加功能插件"申请"模版消息"功能，主营行业或者副营行业之一选择 "IT科技/IT软件与服务"，需要2-3天审核通过， 审核没有通过以前，新邮件提醒功能不能使用。 多次设置微信相关参数，公众平台里可能有多个模版ID，请删除失效的，因为最多只能有25个。 误删了有效的模版ID，将无法发送微信提醒信息，MSMS 日志里会出现，send message *** failed, invalid template_id hint ... 要到 Winmail 微信设置里点击"微信 token"，手工清空2个模版消息 ID，"确定"后让系统自动重建模版ID，参考下图。



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