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

集成 邮箱集成API产品集成  收藏
5 / 555

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

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

需求拆分与应用设计

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

效果入下

步骤解析

  • 邮箱账号创建及同步设计

  • 工作表设计

  • 自动创建邮箱账号:

  • 定时任务表单及工作流设计

  • 定时任务表单设计

  • 自动刷新 Token

  • 1.邮件定时获取及循环写入详情

  • 2.邮件即时获取方案步骤如下:

    • 2.1 对应第三方应用管理后台配置回调模式然后开启
      image.png
    • 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 提交(有客户反馈之前代码块有些看不懂,反馈已接受)

案例分享很多期了,动手组装自己的特色业务中台吧。


1.网易接口文档网易企业邮箱对外开放平台技术白皮书 V1.2.doc

2.腾讯企业邮箱地址 https://exmail.qq.com/qy_mng_logic/doc#10001
3.Token 定时机制 https://help.mingdao.com/API6.html