如何在钉钉中配置网易企业邮箱的自建应用?(针对钉钉新版开放平台)

根据本文档开发的对接系统,可在钉钉中进行邮件到达提醒、查看邮件、预览附件、发送邮件、转发/回复邮件。

如对文档有任何疑问,欢迎发邮件kf@office.163.com进行咨询并作深入的了解。

1 钉钉对接方案

1.1 集成方案概述

网易企业邮箱支持与钉钉对接集成,邮箱管理员通过配置钉钉自建企业邮箱应用,向企业用户提供完整的邮箱------钉钉集成方案。用户在钉钉企业邮应用中绑定邮箱账号后,邮件到达的消息将会推送到钉钉中,用户可在钉钉中进行接收新邮件提醒、查看邮件、转发/回复邮件、发送邮件、移动邮件等操作,满足用户使用钉钉处理所有办公的需求。

同时,钉钉对接方案中对接中采用了RSA加密算法和服务请求IP地址过滤等强大的技术安全手段来保障用户数据安全。

1.2 术语解析

钉钉企业内部应用

企业内部应用是企业基于钉钉的开放能力,开发个性化的办公应用供企业内部使用,例如将网易企业邮箱系统接入钉钉。企业内部应用发布后,企业内部用户可以直接从钉钉工作台中打开、使用该应用。

微应用

钉钉里能自由定制多个应用并进行个性化配置,处理不同的业务。为了同时满足PC端和移动端的邮箱使用,网易企业邮箱使用微应用接入方式与钉钉集成。

对接系统

客户开发人员根据本方案开发的对接系统,可在钉钉中进行邮件到达提醒、查看邮件、发送邮件、转发/回复邮件。

1.3 集成流程

这是图片

1.4 新建、配置企业邮箱应用

Step 1: 使用钉钉管理员账号登录钉钉开放平台 https://open-dev.dingtalk.com/fe/app#/corp/app,选择钉钉应用

这是图片

Step 2:点击页面右上角“创建应用”,弹出菜单后按照要求进行相关填写。

这是图片

Step 3:应用创建成功后,在应用详情页中,找到“凭证与基础信息”菜单,记录AgentId、AppKeyAppSecret,如下图所示:

这是图片

同时钉钉开放平台首页,记录右上角所属组织的CorpId

这是图片

1.5在网易企业邮箱后台配置自建应用

前往网易企业邮箱管理后台,进入【企业设置/自建应用管理】页面。

这是图片

点击“新建应用”,选择“钉钉自建应用”填写相应字段后,点击确认,即可完成自建应用的初始化。

这是图片

完成配置初始化后,您可以点击页面中的“复制回调地址”,复制自建应用配置的相关信息。

1.6 配置微应用及回调地址

Step 1:管理员登录钉钉开放平台,找到对应应用,进入应用详情页。点击页面左侧“添加应用能力”,再找到页面中的网页应用点击“添加”

这是图片

Step 2:网页应用添加成功后,在页面左侧会出现“网页应用”菜单,点击“网页应用”,在页面中的应用首页地址PC端首页地址输入框中填写格式为:

https://mail.域名/static/dingding/?corpId=$CORPID$

这是图片

Step 3:页面左侧找到菜单“安全设置”,点击“安全设置”,在页面中服务器出口IP重定向URL输入框中填写,

服务器出口IP: 59.111.178.93,220.197.30.*,220.197.31.*,220.197.32.*

重定向URL:https://open.qiye.163.com/miniapp/dingding/qr/redirect

这是图片

Step 4:配置应用权限。为了保证您能正常使用网易企业邮箱自建应用,您还需要申请以下权限:

通讯录个人信息读权限

企业员工手机号信息

邮箱等个人信息

通讯录部门信息读权限

成员信息读权限

通讯录部门成员读权限

管理微应用的权限

权限申请入口:页面左侧找到菜单“权限管理”,在权限管理页面中搜索权限名称并进行申请

这是图片

Step 5:在钉钉应用事件与回调页面,选择HTTP推送,填写信息

加密aes_key:KlbBiqrRaOyhSCqcQE3jGUUPDgQrI6XZDqRb0Me6kQJ

签名 token:5ye3fAdWQL1nPaN

请求网址:http://{cname域名}/miniapp/callback/dingding?corpId={corpId}

Step 6:点击保存成功后勾选以下通讯录事件:

通讯录用户增加

通讯录用户更改

通讯录用户离职

加入企业后用户激活

通讯录企业部门创建

通讯录企业部门修改

通讯录企业部门删除

这是图片

1.7 发布应用

以上所有配置完毕后,点击保存。页面左侧找到菜单“版本管理与发布”,在页面右上角点击“创建新版本”,填写版本内容,以及选择需要发布的用户范围后,保存即可。

这是图片

至此,钉钉与网易企业邮箱集成对接已完成。

2 用户在钉钉中使用企业邮箱

2.1 钉钉移动端集成效果

企业邮箱用户在钉钉中,可以通过【工作台----应用】进入配置好的自建应用。首次使用需要输入邮箱账号密码进行身份绑定。绑定成功后即可登录网易企业邮箱移动版,用户可以点击页面右上角写信按钮写信。

这是图片

这是图片

企业邮箱用户在钉钉----工作通知中,可以查看新邮件提醒,单击新邮件提醒消息卡片可以直接查看邮件详情:

这是图片

这是图片

2.2 钉钉电脑端集成效果

用户登录钉钉电脑端,过【工作台----应用】进入配置好的自建应用如示例的公司邮箱。首次使用需要输入邮箱账号密码进行身份绑定。

这是图片

绑定成功后,用户再次进入应用时将自动无需要用户密码单点登录至网页版邮箱中。

这是图片

新邮件提醒将在工作通知服务号中提醒,点击邮件提醒摘要可打开邮件查看邮件内容并回复。

这是图片

返 回