钉钉开发文档

企业内部开发工作台

更新时间: 2019-2-19

开发流程

以下将完整描述创建工作台应用的流程。

1. 工作台设置入口

登录钉钉管理后台,点击【工作台】 - 【设置手机版工作台】。

image.png

(图1 钉钉管理后台工作台设置入口)

选择链接企业现有首页,并点击按钮 【前往设置工作台】,进行工作台相关的设置。

image.png

(图2 自定义工作台入口)

2. 工作台设置

进入企业工作台管理页面后,如果未设置过工作台,会提示配置工作台。
选择开发方式:
(1)企业内部自主开发(企业内部有开发团队,自行开发应用)。
(2)授权给钉钉认证服务商开发(企业内部没有开发团队,需要企业外部的服务商进行开发)。

2.1 自建工作台(企业内部自主开发)

image.png

(图3 选择工作台开放方式-企业内部自主开发)

工作台名称:展示在手机版钉钉底部的,可以由中文、数字、英文及下划线组成,最长4个字符。
工作台地址:点击手机版钉钉底部的工作tab,进入的页面地址,请输入http或https开头的网址链接。
服务器出口IP:调用钉钉服务端API时的合法IP列表,多个IP请以“,”隔开,支持带一个*号通配符的IP格式。工作台名称、地址、服务器出口IP等信息在工作台创建后,可以再次修改。

image.png

(图4-I 配置开发信息)

注意:工作台名称默认为【工作】。仅认证企业可修改工作台名称,如下图所示。

image.png

(图4-II 认证企业可自定义工作台名称)
(图4-III 认证企业手机预览效果)

点击上图中的【创建】按钮,自建工作台应用即创建完成,页面自动跳转到下图5所示的【工作台详情】。
注意:请妥善保管页面展示的 appKey 和 appSecret ,并注意保密,它们将用于调用钉钉开放平台提供的接口。
工作台信息如需修改,可以点击【修改工作台地址】,重新配置开发信息。

image.png

(图5 自建工作台详情页)

点击上图5中的【申请发布】,申请发布工作台,系统会自动审核通过。审核通过后,页面将提示【审核成功】,并可以点击【设置为工作台】。

image.png

(图6 自建工作台审核成功)

点击上图6中的【设为工作台】,即会将工作台名称和工作台地址设置到手机端,设置成功后,页面如下图7所示。

image.png

(图7 设为工作台)

以上步骤创建自建工作台应用完成。

在工作台中添加微应用

在企业自建工作主页中添加钉钉原生微应用(如审批、日志等)或已上架的第三方微应用,可使用JSAPIbiz.microApp.openApp打开应用。其中,agentid获取方式有两种方式:
第一,通过钉钉管理后台,进入【工作台】,点击某个微应用 【设置】,后可以打开下图:

image.png

第二种:可以通过调用如下API,获取微应用信息
调用“获取应用列表”API接口,请参考接口

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

以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!