钉钉开发文档

定制企业工作主页

更新时间: 2018-9-21

基于钉钉,你可以定制自己的企业工作主页,下图是各企业在钉钉工作tab的页面展示:

image.png

设置钉钉工作首页

钉钉官方提供了两个默认的工作首页的模板:官方简洁版和官方高级版,可以在页面中选择,并在手机端查看显示效果,本文重点介绍【链接企业现有首页】。

注意:为确保企业数据传输安全,企业自定义首页的地址必须使用HTTPS协议地址。

登录钉钉管理后台之后,点击 工作台 - 设置手机版工作台(如下图1)

image.png

请选中链接企业现有首页(如下图2),然后输入公司自建页面url地址,使用手机版钉钉即可查看效果

image.png

在自定义工作主页中添加微应用

在企业自建工作主页中添加钉钉原生微应用(如审批、日志等)或已上架的第三方微应用,只需将自建门户上【增加的微应用的图标】跳转为下面组装的URL:

dingtalk://dingtalkclient/action/switchtab?index=2&name=work&scene=1&corpid=<企业corpid>&agentid=<跳转到应用的agentid>

或者使用jsapi:dd.biz.microApp.openApp打开应用。

agentid获取方式有两种方式:

第一,通过钉钉管理后台,进入【工作台】,点击某个微应用 【设置】,后可以打开下图:

image.png

第二种:可以通过调用如下API,获取微应用信息

【列出微应用】API接口,仅限企业调用该接口,ISV无法调用,详细请参考接口

通过上面的两种方式中的一种,拿到agentid后就可以在自建工作主页中添加微应用了。