明道云集成篇---《企业邮箱》

张春泉（Team） 2022-04-22 10:17:51 集成邮箱集成API产品集成收藏

5 / 1034

往期的分享了很多期的集成案例，那企业为什么要做集成呢，最终的本质就是提高效率。那么沟通也是一种成本，也是需要提高效率的，虽然现在电话，在线语音都很便捷，但是都是相对的。如果出现了跨时区的这种就很不方便了，就回归于邮箱沟通了。本片示例就以网易企业邮箱为例（腾讯企业邮箱也可以），来实现明道中收发的效果。

适用于不能及时沟通的行业/企业：外贸，外资

需求拆分与应用设计

设计账号体系
组织同步至明道或员工入职时。通过工作流调用第三方 API 接口创建邮箱账号，实现账号互通，提高人效。
用户同步（可参考往期的系统信息集成之《组织架构同步》
API 接口参考：对应邮箱第三方平台的开发接口
参考对方 API 文档搭建应用
根据接口文档设计基础表单账号邮件以及工作自动化流程 Token 即时，邮件定时/即时获取获取，以及单独登录查看方案，。
网易接口文档获取需要联系网易客服集体让如下：kf@office.163.com 或致电：95-163-188 获取服务支持。
腾讯接口线上直接可查看

效果入下

步骤解析

邮箱账号创建及同步设计
工作表设计
自动创建邮箱账号：
定时任务表单及工作流设计
定时任务表单设计
自动刷新 Token
1.邮件定时获取及循环写入详情
2.邮件即时获取方案步骤如下：
- 2.1 对应第三方应用管理后台配置回调模式然后开启
- 2.2 根据收到的数据开始调用接口获取邮件信息
单点登录查看

此次需要时间戳所以这里获取单点登陆地址直接代码块调用

var url=input.url
var timestamp=new Date().getTime();
var data={"accountName":input.name,
"domain":"公司域名例如mingdao.com"};

var header={ 'Content-Type':'application/json',
"qiye-app-id":input.appId,
"qiye-sso-auth-token":input.SSOToken,
"qiye-org-open-id":input.orgOpenId,
"qiye-nonce":"123456789012",
"qiye-timestamp":timestamp.toString()
}
const res = await   fetch(url,{
method:"post",
headers:header,
body:JSON.stringify(data)
}).then(function(response){
if(response.ok){
return  response.json();
}else{
return   {"error":"无数据"};
}
}).catch(function(err){
return   {"error":"Fetch错误:"+err};
});
var result = await   res;
output={result:result,data:JSON.stringify(data),header:JSON.stringify(header)}

注：本篇示例请求大部分使用的时 webhook 提交（有客户反馈之前代码块有些看不懂，反馈已接受）