钉钉开发文档

应用上架验收规范

更新时间: 2019-1-9

简介


钉钉应用市场正在为成千上万的开发者和上亿用户提供服务。不管是开发新手,还是由经验丰富的开发者组成的团队,我们都欢迎您在钉钉上开发应用,并希望帮助您了解我们的准则,以便您的应用能够快速通过审核后上架。
钉钉应用的审核指导原则是:我们希望给用户提供安全可靠的应用。从这个原则出发,我们将准则划分为以下几个部分:产品、运营、设计。
我们希望这些准则能帮助您顺利通过应用审核流程。本文是一个动态文稿,因为如果新的应用中引发了新的问题,我们会随时订新的规则。
如果你开发的应用想要上架至钉钉应用市场,请认真阅读以下文稿并按照规范进行产品优化。

基本信息规范


创建应用时需要填写基本信息,应用上架后,基本信息会在应用简介中显示。以下是应用信息的规范:

信息 规范
应用名称 应用名称要简洁明确,需使用与应用功能相关的词汇,建议使用品牌名、服务、功能特点等,例如:天猫企业购、阿里商旅。不能使用通用性的描述词汇,例如:移动办公、智能办公。
应用名称不能与已有应用名称重复。
正规,无淫秽、侵权、暴力等非法字符。
非官方应用不能使用官方名称,不能出现阿里巴巴、钉钉等字样。
应用图标 应用图标要清晰,建议上传像素为200*200且小于3M的图标。请确认应用图标没有侵犯他人知识产权。
应用图标不允许出现禁限售、低俗等非法字符和图案。
应用图标不能使用他人已经使用的。
应用图标必须清晰,不得包含其他水印信息。
应用简介 应用简介描述必须介绍应用相关信息,能够准确反映应用的核心功能。不要添加无意义的字母、标点符号等。应用简介、名称、图标三者之间必须有所关联。

产品准入说明


1.1 待审核产品要求满足办公或者商业场景使用需求。非商业领域类(比如休闲游戏,娱乐视频等)等将拒绝审核。
1.2 涉及下列商业场景的产品不准入:获取组织架构及通讯录隐私的产品(获取组织架构、获取通讯录、获取身份验证等),涉及财务风险类的产品(财务融资、金融贷款等),此类产品提交将拒绝审核。
1.3 钉钉将布局企业办公场景中的通用需求,比如:人(入职、转正、调岗、离职)、财、物、事的通用解决方案,但此类领域同时也向isv开放,欢迎全行业共同参与完善企业的通用需求。如需上架应用市场,ISV开发此类场景时,需提前向开放平台报备,未报备开发将拒绝审核。
1.4 国家法律法规明令禁止的服务和产品将拒绝审核。
1.5 建议通过深度挖掘垂直行业和场景的产品机会(比如:餐饮、用车、CRM、员工健康等),从细分领域出发服务4300万企业。

应用的名称和图标


2.1微应用的产品名称及icon清晰可识别,不能与平台内其他微应用的产品及icon相似度过高,审核人员可主观判断。
2.2 微应用产品名称应该与品牌、服务场景、核心功能有关联,命名不超过5个汉字,开发者应取得改名称的注册商标。
2.3 微应用名称不能以通用名称等不具有识别性的词语来命名,比如:CRM、ERP、进销存、财务软件。名称建议是两个词以上的组合,当无法判断时,审核人员可主观判断是否可用。
2.4 微应用icon标准尺寸为:200*200,不规则icon的边缘需要以200*200尺寸描边。
2.5 微应用头像logo不得包含阿里巴巴、淘宝、支付宝、蚂蚁金服、钉钉、阿里云等官方品牌标识(阿里巴巴集团自开发应用除外)。
2.6 任何涉及违反国家法律法规的名称和icon都将被拒绝。

核心用户及使用场景的完成度


3.1 应用需明确满足某一类核心用户群体的办公或者商务需求,因完成核心需求的最小闭环,一个产品有且仅有一个主流程,如培训管理产品,选课-安排学习-考试-统计是一个主流程
3.2 非首次进入应用的目标用户使用时需要在1-2步操作中就可未经指导的接触到核心流程。
3.3 核心场景的流程需要设计为闭环状态,核心流程的任何断点,均会被拒绝。

提供产品在同类中的竞争亮点


4.1 产品需要在同类形分类中具备竞争亮点,比如:满足了某一个其他同类没满足的需求、比同类产品设计感好、交互更优等。
4.2 如果产品在同类中产品本身明显不具备竞争亮点,且与ISV交流中也无法提供可验证亮点,审核会被拒绝。
除此之外,根据应用的类型,有不同的差异化标准。

基本功能交互可用性和完整性


5.1 应用提审时应是完成品,要求可以打开,可以运行,不可以是测试版。存在严重bug(如无法添加和打开、无法返回和退出、卡顿严重等),本身会崩溃,或应用会造成钉钉客户端崩溃的,将会被拒绝。
5.2 除新用户引导外,非首次访问用户应该通过首页直达或者2次点击后就可使用到该应用的核心服务功能。
5.3 突出主功能、主流程,将较少使用的次要功能、分支流程折叠到“更多”或类似“高级选项”列表中,包括表单中的非必填项、一个页面中的次要操作等。
5.4 如应用有PC端使用场景,应同时开发PC端。
5.5 不允许仅有OA管理后台的web版微应用管理后台,而没有PC端微应用管理后台。
5.6 PC端微应用所有页面在容器内打开,避免跳转至外部浏览器打开。
5.7 整体功能体验中,产品体验应该是稳定健康的,用户可感知流程步骤和页面跳转的目的性。
5.8 微应用需要考虑不同角色用户的页面展示主次及逻辑,如果涉及不同权限的产品审核,isv需要提前预置数据,准备不同角色的测试账号供审核人员验证。
5.9 非极端弱网环境下,内容加载、页面的切换等待之间最长不超过4秒。
5.10 如需要账号体系,应用应与钉钉打通免登能力,不允许应用存在需要用户输入手机号码等隐私数据注册登录的自有的账号体系。
5.11 应用需要使用应用内支付能力时,需通过开放平台提供的统一支付插件进行调用,平台不支持其他支付形式。
5.12 应用的功能的使用,无需以转发、分享、打开其他微应用等非用户自愿行为解锁。
5.13 在未经允许或未被钉钉开放平台授权的情况下,不得展示和推荐自有或者第三方应用。比如:不能做应用中心,应用导航、应用链接互推、排行榜等。

重视页面内容的细节体验


6.1 产品设计需有用户的视角,让丝毫不了解产品的用户能够理解。而不是站在开发者的视角。如CRM产品成功创建一个客户,不应该提示为“写入数据库成功”,而应该是“创建客户成功”
6.2 文案应避免与钉钉的功能产生混淆,如使用钉钉功能时,应与钉钉的文案保持一致,如DING功能为大写字母,不应写成Ding或ding。审批功能特指钉钉审批,日志功能特指钉钉日志等。
6.3 文案应通俗易懂,避免出现开发者使用的专业术语。提示语应简明扼要、指代清晰、避免歧义。
6.4 必填项、非必填项应有区分标示,可选项、不可选项应有视觉区分,可输入区域、不可输入区域应明确区分。6.5 输入纯数字时应自动拉起数字键盘,输入英文时应拉起英文键盘等。非特殊情况下,输入日期时应调用钉钉标准选日期组件。场景为选择未来的时间时,不应可选早于当前的时间。
6.6 用户可能对输入的内容要求不清晰时,应在输入框中用灰色文字透出引导输入的内容。较难理解的输入框,应有小字或问号等提示。
6.7 多个表单输入项可归为几个大项时,建议有明确的标题分割,但不要过度依赖标题的分割作用。不要过多使用分割线,保持页面统一和美观。
6.8 相同层级的表单项的间距、字号、颜色应保持一致,居左对齐,上下居中对齐,输入框的宽度应尽量一致,尽量避免在同一行出现两个输入框。
6.9 表单应尽量使用白色背景,表单项名称使用黑色或饱和度较高的灰色,尽量避免使用红色提示语。
6.10 微应用不允许接入广告平台模式,比如信息流广告、漂浮悬浮类广告,含有广告展示类的微应用将会被拒绝。
6.11 微应用代替用户发表、发送、转交任何内容前,必须征得用户明确同意和授权。
6.12 钉钉提倡平等透明的工作方式,避免用“您”、“贵公司”等字眼。
6.13 微应用的服务提供者必须提供过滤不当内容的措施。示例:设置对发布色情、赌博等涉嫌违法违规的词汇进行过滤提示的措施。

从新老用户视角出发


7.1 钉钉企业级应用一般由管理员授权开通,也由管理员决定是否推进使用,第一次打开产品的,绝大多数情况下也是管理员。所以新用户的引导特别是对于管理员的引导尤为重要,必须让管理员快捷、无压力、低成本地体验产品的主要功能,感受到产品的核心价值。
7.2 微应用功能逻辑复杂时,需要针对新用户做独立的引导流程,审核人员可主观判断是否需要增加引导流程:
7.21 完整的新用户引导分两方面:基本操作提示、走完产品主流程。
7.22 基本操作提示如:点击新建可以快速建立一个客户档案
7.23 完成产品主流程:引导新用户完成产品的主要功能,并在必要的、需要用户大量输入的功能中预置案例,降低体验门槛。体验引导一般基于产品MVP设计,并且是一个线性流程,无分支操作。
7.3 建议引导形式:
7.31 建议使用蒙层引导、功能tips、完成任务等方式,让用户真实体验产品,不建议使用图片、demo的方式进行引导。
7.32 丰富的预置内容、案例、模板等,让用户能够快速理解
7.33 建议将引导流程和产品功能相结合,如一个智能客服产品,可以将引导作为知识库放在智能对话框中。一个任务管理产品,可以将引导任务作为预置的任务,要求用户完成。
7.34 产品升级后,新功能须让用户有所感知。
7.35 引导功能需提供跳过能力。

遵循UI规范


8.1 产品符合开放平台 UI 规范。
8.2 同一个应用的主色调、页面样式、设计元素、设计风格、字体大小、字体颜色应保持一致。
8.3 可点击、不可点击的按钮、文字应有明确的区分,避免为了强调某些文字而设置成蓝色,给用户造成可点击的错觉。
8.4 每一个页面都应有明确的产品意图,尽量避免一个页面只有左上角“返回”按钮一个操作,避免一个页面有多个同级分支操作。
8.5 所有的操作要有反馈,反馈尽量使用Toast的方式,可根据反馈内容自定义Toast提示时间,但最短不短于1秒。8.6 重要操作进行二次确认,危险操作明确说明风险点,并进行Checkbox确认。
8.7 所有提示弹框都应该有关闭按钮。
8.8 除了某些危险操作外,应在任何地方避免使用红色字体。
8.9 应用页面内的浮层和弹窗可关闭。
8.10 请注意处理数据/内容空态时的页面展示,当页面无任何数据时,应有友好提示背景图或引导创建数据的按钮,避免页面上大面积的白屏
8.11 应用的界面不得模仿系统通知或钉钉官方通知诱导用户点击。

用户隐私和数据安全


9.1 不得在应用任何页面请求或诱导用户输入钉钉用户名或密码、真实联系方式。
9.2 涉及到向用户推送工作通知的功能时,应尽量使用“用户反馈式”推送。产品中应避免设计主动推送式功能,特殊情况应在产品验收时向钉钉团队说明。
9.3 需要向已授权开通企业管理员主动推送信息,可使用钉钉开发者平台的推送工具,申请后由钉钉团队审核内容并推送。
9.4 企业客户及用户在应用中产生的数据,所有权益归企业所有。
9.5 不得将通过应用收集到的用户数据私下进行出售、转交、交易、越权披露或泄露。
9.6 在收集和使用用户任何数据时,必须明确告知用户该数据的用途,确保经过用户明确同意和授权,并应在用户同意和授权的范围内进行合理使用。
9.7 用户授权开通服务后,除非解除授权时选择删除数据,否则不允许删除用户数据。
9.8 在企业退订服务或者注销帐号后应帮助企业在其指定服务器备份数据后,主动删除非企业指定服务里的相关数据。

运营及服务机制


10.1 应用需要提供帮助中心,预置和沉淀在服务客户时整理的FAQ。
10.2 需在应用中提供客服入口,包括:客服电话、客服钉钉二维码、智能问答(H5)、意见反馈表单等。不允许出现钉钉之外的IM咨询,或跳转至包含其他IM咨询入口的外部页面。

技术实现的规范性


11.1 需要提供应用稳定性和安全性文档和说明。
11.2 违规加载或更新代码,将会被拒绝。

安全


应用服务安全标准:

  1. 应用必须部署在阿里巴巴钉钉云(适用范围:上架钉钉应用市场的应用;线下部署的应用不做此限制)
  2. 开启云盾全部防御功能,开启云监控,实时监控线上服务状况保障7*24小时防控
    代码安全标准:
  3. 符合《钉钉开放平台编码规范》
  4. 通过钉钉官方安全扫描

稳定性


稳定性标准请阅读此文档《稳定性认证标准》

功能规范


  1. 应用的核心功能,必须在应用首页得到体现,首页需要说明应用的价值,主要作用。
  2. 应用需向用户提供基本的功能指引,包括描述或截图等形式。针对首次进入应用的用户,应提供新用户的引导,包括新手引导,弹窗等。
  3. 应用的功能不能过于简单,至少需要完成某一个功能的完整闭环。提供的功能不能与其他应用严重同质化。
  4. 未经钉钉团队授权的情况下,应用的添加,必须是免费的,不得设置付费添加。
  5. 未经钉钉团队授权的情况下,不得提供与钉钉客户端产品功能相同或者相似的应用。
  6. 未经钉钉团队授权的情况下,应用功能的使用,不得依赖于其他应用,即不得以使用其他应用为条件,也不得依赖于其他应用程序,即不得以使用其他应用程序为条件;未经钉钉团队授权的情况下,也不得展示或者推荐其他应用。
  7. 应用内应设置客服机制,用户在遇到问题、无法使用的情况下,可以联系到开发者。

体验规范


  1. 统一的交互体验和视觉元素,包含但不限于:页面结构、元素样式、字体、图标、颜色等。
  2. 合理清晰的用户引导,用户引导应说明应用价值和基础功能,但不能占用太多页面空间,避免对用户造成干扰。
  3. 谨慎提醒,减少错误,慎重使用红色等强效果,通过优化产品交互来减少不必要的用户操作失败,不要让用户在使用产品的时候产生挫败感,因为这会大大提升用户的跳失率。
  4. 重点突出。利用交互和视觉的优化,来突出页面主要功能和重点操作。不要试图把所有操作都放在同等重要的位置上,因为这会增加用户的使用成本和思考时间。
  5. 及时、准确、轻量的反馈,及时返回操作结果,在没有结果的时候要告知用户当前状态,不要让用户一直处于未知的等待中。轻量级的成功提示有助于增加用户继续使用的信心。明确流程终结的情况下,需要使用操作结果页来反馈用户。
  6. 逻辑清晰的产品路径,产品交互及页面结构要有规律,让用户能轻易地找到所需信息及操作入口,提高工作效率。不要让用户在复杂的路径中迷失。
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!