Winmail 阿里钉钉绑定

功能简介


     Winmail 6.5(0305) 以后版本支持与阿里钉钉企业账号(认证或者未认证)绑定,可以实现邮箱绑定钉钉,及时获取新邮件通知;在钉钉里自建邮件企业应用, 无需登录邮箱,随时随地用钉钉收发邮件。因为2019年1月起钉钉提供的开发接口变化了,以前版本 Winmail 已经无法和钉钉绑定,请升级 Winmail 到 6.5(0305)以上版本。 Winmail Pro 4.7 以上支持 与阿里钉钉企业账号(认证或者未认证)绑定。Winmail 7.0 以上和Winmail Pro 5.0 以上可使用钉钉 APP 扫描登录电脑端 Webmail。  (2025,3,18 更新)

     Winmail 的 Webmail 可以使用 80 端口或非 80 端口,可以使用域名访问也可以使用 IP 的访问地址。[ 本文假设 Webmail 访问地址为: http://mail.abc.com:6080 (具体设置时请使用自己的域名代替)] 也可以使用 https 端口,不过需要服务器有正式的证书。

     本功能可以和短信提醒功能、微信绑定功能同时使用。

     本功能利用阿里钉钉提供的公开开发接口,因为阿里公司有权随时修改接口,可能会导致部分或者全部相关功能无法使用,所以我们不能保证本功能一直可以正常使用。

1. 阿里钉钉企业注册


     已有钉钉企业账号可以直接加邮件的企业应用使用,没有的话,请到 阿里钉钉平台 免费注册,免费认证。

2. 设置步骤


         1. 阿里钉钉平台 使用"企业登录"登入,进入"工作台"-应用管理,点击右上角的"创建应用",会进入"钉钉开发者平台":
              第一次进入平台要注册成钉钉开发者,按照提示自行注册。
                进入"应用开发"-"创建应用"
                1,填写基本信息
                  应用名称: 例如:公司邮件系统 注意字符长度不能超过10个字母或者汉字
                  应用Logo: 一般使用一个正方的图片就可以了,以后还可以修改
                  保存
                2,应用参数 进入本应用,"凭证与基础信息"记录以下参数
                  原企业内部应用: AgentId
                  Client ID (原 AppKey 和 SuiteKey)
                  Client Secret (原 AppSecret 和 SuiteSecret)

        winmail 钉钉

         2. 进入"钉钉开放平台"-"首页",记录下来 CorpId

        winmail 钉钉

进入本应用,"权限管理"

"权限范围"-> "全部员工"

"通讯录管理" 要取得以下权限

        企业员工手机号信息
        邮箱等个人信息
        通讯录部门信息读权限
        成员信息读权限
        根据手机号姓名获取成员信息的接口访问权限
        通讯录部门成员读权限
        winmail 钉钉



进入本应用,"应用发布"-“版本管理与发布”
        "创建新版本",设置"应用可用范围"         保存-直接发布

3. 登录 Winmail 管理端,进入"系统设置"-"新邮件提醒",在"短消息设置"里,
              选择"启用新邮件通知"-"钉钉"-"设置",输入正确的:
                 CorpID: 上面的"CorpId"
                 AppKey: 上面的"AppKey"
                 AppSecret: 上面的"AppSecret"
                 Webmail URL: http://mail.abc.com:6080 (具体设置时请使用自己的域名代替)
                 AgentID: 上面的"AgentID"
                 确定-应用

        winmail 钉钉

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

3. 邮箱用户绑定钉钉


    邮箱用户首先要自己注册钉钉个人账号(手机下载钉钉APP),并且成功加入到公司或者单位的企业组织里(管理员自行研究钉钉说明解决),然后才能绑定邮箱。 登录 Webmail,进入"新邮件提醒",使用个人的钉钉APP扫描页面上的二维码(注意:这个二维码是 Winmail 生成的,一次性有效,只用于绑定这个邮箱账号,和钉钉企业号的二维码不一样), 如果钉钉里提示: ... uid is not employee for orgid ...,代表这个钉钉账号没有加入企业账号里。

        winmail 钉钉设置

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

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

    成功的话钉钉会收到一个绑定通知。 Webmail 里会显示绑定的钉钉用户名,可以发一封邮件到此邮箱,测试是否收到钉钉通知,收到的消息是否可以打开这封邮件。

其他


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

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

钉钉用户和组同步


Winmail 7.1 [企业版] Winmail Pro 5.1 [旗舰版]以后版本支持自动同步钉钉用户和组到 Winmail,需要配置这个功能,要先关闭 Winmail "系统设置"-"新邮件提醒"-"短信息设置"-"钉钉"

1. 在域名属性里设置,把相关的设置参数设置到域名属性里, 请查看下图



认证方式选择"固定密码",建议设置复杂密码,因为同步新建的邮箱用户密码都是一样的,这样不安全,将在域名属性"默认密码策略"选中"用户下次登录必须修改密码"。



2. 如果选择了"同步组",同步过来的"组名"默认是一串数字,可以在 Winmail 自己修改为英文字母名称,下次同步不影响修改。