根据本文档开发的对接系统,可在钉钉中进行邮件到达提醒、查看邮件、预览附件、发送邮件、转发/回复邮件。
如对文档有任何疑问,欢迎致电95-163-188或发邮件kf@office.163.com进行咨询并作深入的了解。
1 钉钉对接方案
1.1 集成方案概述
网易企业邮箱支持与钉钉对接集成,邮箱管理员通过配置钉钉自建企业邮箱应用,向企业用户提供完整的邮箱——钉钉集成方案。用户在钉钉企业邮应用中绑定邮箱账号后,邮件到达的消息将会推送到钉钉中,用户可在钉钉中进行接收新邮件提醒、查看邮件、转发/回复邮件、发送邮件、移动邮件等操作,满足用户使用钉钉处理所有办公的需求。
同时,钉钉对接方案中对接中采用了RSA加密算法和服务请求IP地址过滤等强大的技术安全手段来保障用户数据安全。
1.2 术语解析
l 钉钉企业内部应用
企业内部应用是企业基于钉钉的开放能力,开发个性化的办公应用供企业内部使用,例如将网易企业邮箱系统接入钉钉。企业内部应用发布后,企业内部用户可以直接从钉钉工作台中打开、使用该应用。
l 微应用
钉钉里能自由定制多个应用并进行个性化配置,处理不同的业务。为了同时满足PC端和移动端的邮箱使用,网易企业邮箱使用微应用接入方式与钉钉集成。
l 对接系统
客户开发人员根据本方案开发的对接系统,可在钉钉中进行邮件到达提醒、查看邮件、发送邮件、转发/回复邮件。
1.3 集成流程
![](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/36f4a5bbebc144fea3d2bea78706d400.png)
1.4 新建、配置企业邮箱应用
Step 1: 使用钉钉管理员账号登录钉钉开放平台 https://developers.dingtalk.com/,点击页面上方**应用开发—>企业内部应用开发**。
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/4512bd75c8ec404e9efe014feb5a734f.jpg)
Step 2:点击页面右上角“创建应用”,弹出菜单后按照要求进行相关填写,注意选择应用类型为:“H5微应用”,开发方式为:“企业自助开发”
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/53427bdfd4d049e9a3574d63c9c47f13.jpg)
Step 3:创建成功后,在应用配置界面中,记录AgentId、AppKey和AppSecret,如下图所示:
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/2070db084d5d4d67abeeb2db4740b111.jpg)
同时钉钉开放平台首页,记录右上角所属组织的CorpId。
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/4b520ed3fd4c4766a6209fc43f9e7e33.jpg)
1.5在网易企业邮箱后台配置自建应用
前往网易企业邮箱管理后台,进入【企业设置/自建应用管理】页面。
![image-20220509140259620](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/53bdda5849ce4b8980b7a430084b4e98.png)
点击“新建应用”,选择“钉钉自建应用”填写相应字段后,点击确认,即可完成自建应用的初始化。
![](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/b6ccfeeb94c648808d4de3bb3666581b.png)
完成配置初始化后,您可以点击页面中的“复制回调地址”,复制自建应用配置的相关信息。
1.6 配置微应用及回调地址
Step 1: 基础配置。管理员进入钉钉管理后台的微应用配置页面,点击页面左侧开发管理、再点击页面右上方的修改按钮就可以对以上参数进行配置:
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/90424e039ecd46959e52c6ee6dea7382.jpg)
- 服务器出口IP: 59.111.178.93
- 应用首页地址和PC端首页地址相同,格式为:
https://mail.域名/static/dingding/?corpId=$CORPID$
Step 2: 添加免登授权码跳转地址。进入网易企业邮箱应用设置页面/权限管理,如下图所示:
![image-20221019173524644](https://cowork-storage-public-cdn.lx.netease.com/common/2022/10/19/be05498ec3ff4fcb930448b26bc4b6dd.jpg)
配置的回调域名为:https://open.qiye.163.com/miniapp/dingding/qr/redirect
Step 3:配置应用权限。为了保证您能正常使用网易企业邮箱自建应用,您还需要配置以下权限:
- 通讯录个人信息读权限
- 企业员工手机号信息
- 邮箱等个人信息
- 通讯录部门信息读权限
- 成员信息读权限
- 通讯录部门成员读权限
- 管理微应用的权限
- 查询企业的微应用列表权限
- 调用OpenApp专有API时需要具备的权限
配置入口:网易企业邮箱应用设置页面/权限管理,如下图所示:
![image-20221019173749139](https://cowork-storage-public-cdn.lx.netease.com/common/2022/10/19/132339cb0b7a4859931d78c496386fff.jpg)
1.7 发布应用
配置完毕后,点击保存。然后点击下方版本管理与发布,选择需要发布的用户范围后,保存即可。
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/9c17edb35afc45b5ac1483d2b5f68391.jpg)
至此,钉钉与网易企业邮箱集成对接已完成。
2 用户在钉钉中使用企业邮箱
2.1 钉钉移动端集成效果
企业邮箱用户在钉钉中,可以通过【工作台—-应用】进入配置好的自建应用。首次使用需要输入邮箱账号密码进行身份绑定。绑定成功后即可登录网易企业邮箱移动版,用户可以点击页面右上角写信按钮写信。
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/52bb736e8ea34e37bb372cb00dcc8595.png)
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/30b1607aa6ca4fd08a6cd155fba09ed8.jpg)
企业邮箱用户在钉钉—-工作通知中,可以查看新邮件提醒,单击新邮件提醒消息卡片可以直接查看邮件详情:
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/19c263c0793442b9ad14a61448af482a.jpg)
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/1e17f3f9d2c74736aea281f423751a5b.jpg)
2.2 钉钉电脑端集成效果
- 用户登录钉钉电脑端,过【工作台—-应用】进入配置好的自建应用如示例的公司邮箱。首次使用需要输入邮箱账号密码进行身份绑定。
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/9b8ce831094b41e0afa65a7ef45ff96c.jpg)
- 绑定成功后,用户再次进入应用时将自动无需要用户密码单点登录至网页版邮箱中。
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/f047db898f0c462fbaa4a8ae2a6b0b7e.jpg)
- 新邮件提醒将在工作通知服务号中提醒,点击邮件提醒摘要可打开邮件查看邮件内容并回复。
![img](https://cowork-storage-public-cdn.lx.netease.com/common/2022/05/09/ec38a20793c543f3a3d565be4e8baee6.jpg)