Skip to main content

什么是事件订阅。

钉钉事件订阅功能,是钉钉开放平台推出的一项服务。这项服务允许开发者在自己开发的应用程序中,实时接收到钉钉平台产生的各类重要通知。通过设置事件订阅,你的应用能够监听到钉钉中发生的诸如部门架构调整、员工签到、打卡等事件,并据此在你的应用中进行及时响应和处理。利用这一功能,你的企业应用将能够更深度地与钉钉平台集成,实现信息共享和业务协同。

应用场景

通讯录事件场景

在新员工入职或者离职时,应用需要第一时间变更用户数据,此时就可以订阅通讯录相关事件,就不需要定时去拉取通讯录对比,而是实时地获取到变化的通讯录信息,进行同步。

群事件场景

如果需要及时响应群内用户的操作,可以订阅事件。例如:某用户加入某群聊时,应用可以订阅即时通讯IM-会话管理下的相关事件,在用户进入群聊的时候,向用户发送欢迎等信息。 更多事件参考事件订阅总览。

订阅方式

订阅规则

钉钉事件订阅可以按需订阅,具体规则如下:

语法

事件订阅的匹配规则采用Glob语法进行模式匹配。Glob是一种类似于正则表达式的匹配方式,但语法更为直观简单。在Glob规则中,可以使用包括*?{}[]等特殊字符进行模式定义。在钉钉事件的自定义过滤中,我们仅使用*{}两种字符来实现对事件的精确筛选。 说明 如果没有进行规则配置或者删除了所有已配置的规则,将会推送该类型的所有事件。
  • 一个星号*
匹配任意个数的字符,包括空。不包括路径边界/或 \。例如: /path/*/abc可以匹配/path/a/abc/path/b/abc等。
  • 两个星号** 和一个星号类似,区别是可以跨路径边界,一般用来匹配多级目录。例如:/path/**/abc可以用来匹配/eventkey/a/abc/eventkey/b/abc/eventkey/a/b/abc/eventkey/a/b/c/abc等。
  • 大括号{} 大括号用来指定一个子模式匹配集合,例如:{sun,moon,stars}可以匹配 sunmoon``starts{temp*, tmp*}可以匹配任何以 temptmp开头的字符串。
如果你需要按需订阅审批事件,参考如下 审批事件 示例: 相关参数信息,请参考审批事件。

订阅流程

image.png