什么是事件订阅。
钉钉事件订阅功能,是钉钉开放平台推出的一项服务。这项服务允许开发者在自己开发的应用程序中,实时接收到钉钉平台产生的各类重要通知。通过设置事件订阅,你的应用能够监听到钉钉中发生的诸如部门架构调整、员工签到、打卡等事件,并据此在你的应用中进行及时响应和处理。利用这一功能,你的企业应用将能够更深度地与钉钉平台集成,实现信息共享和业务协同。应用场景
通讯录事件场景
在新员工入职或者离职时,应用需要第一时间变更用户数据,此时就可以订阅通讯录相关事件,就不需要定时去拉取通讯录对比,而是实时地获取到变化的通讯录信息,进行同步。群事件场景
如果需要及时响应群内用户的操作,可以订阅事件。例如:某用户加入某群聊时,应用可以订阅即时通讯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}可以匹配sun、moon``starts,{temp*, tmp*}可以匹配任何以temp和tmp开头的字符串。
相关参数信息,请参考审批事件。
订阅流程
