一种适配飞书平台的智能定时任务消息调度方法与流程

摘要: 本发明涉及消息调度与智能推送,尤其涉及一种适配飞书平台的智能定时任务消息调度方法。背景技术:1、飞书作为国内主流的企业级协同办公平台,其开放的api接口与机器人...
一种适配飞书平台的智能定时任务消息调度方法与流程

本发明涉及消息调度与智能推送,尤其涉及一种适配飞书平台的智能定时任务消息调度方法。

背景技术:

1、飞书作为国内主流的企业级协同办公平台,其开放的api接口与机器人能力已成为大中型企业数字化办公、自动化消息触达的核心载体。相关技术中,通过apscheduler定时调度框架、传统cron表达式与飞书机器人api的协同作业,构建了基础的定时消息推送体系。具体地,该体系涵盖了从任务参数配置、消息内容编辑到api调用的全过程,包括定时调度、文本推送、状态记录等关键环节。

2、然而,现有的定时消息推送方法中,直接采用原生apscheduler框架与简易文本推送,并没有针对飞书平台api规范、企业富文本图文场景及批量人员通知做一体化适配。由此可能会导致cron星期规则冲突引发任务执行错乱,html富文本推送后样式丢失,本地图片需人工上传,批量推送仅支持逐条录入openid,以及瞬时异常无自动重试机制,从而影响消息送达率与运维效率,难以满足大规模、高稳定的全自动化推送需求。

技术实现思路

1、本发明旨在至少在一定程度上解决相关技术中的技术问题之一。

2、本发明的主要目的在于提供一种适配飞书平台的智能定时任务消息调度方法。

3、为达上述目的,本发明实施例提出了一种适配飞书平台的智能定时任务消息调度方法,包括:

4、s1,接收定时任务配置信息,所述配置信息包括传统cron表达式、html富文本消息内容、本地图片资源以及批量推送手机号列表;

5、s2,对所述传统cron表达式中的星期字段按照预设转换规则进行自动修正,生成适配apscheduler调度框架的标准化调度表达式;

6、s3,对所述html富文本消息内容进行递归解析,按照飞书交互式卡片规范进行样式映射,同时自动上传所述本地图片资源并回填图片标识,生成标准化消息卡片;

7、s4,对所述批量推送手机号列表进行清洗和无效号码过滤,批量查询并映射为飞书用户标识,将所述标准化消息卡片推送至目标用户,若推送失败则生成延迟重试子任务执行单次重试,并记录全链路执行日志。

8、可选的,所述接收定时任务配置信息,包括:

9、通过api交互层接收前端发起的任务新增请求,对所述传统cron表达式、html富文本消息内容、本地图片资源以及批量推送手机号列表进行入参合法性校验,校验通过后将所述配置信息转发至业务服务层。

10、可选的,所述对所述传统cron表达式中的星期字段按照预设转换规则进行自动修正,包括:

11、精准截取所述传统cron表达式中的星期字段,调用核心转换公式对单星期数值或逗号分隔的多星期数值进行批量数值适配,生成适配apscheduler框架的星期参数,重组生成完整标准化cron调度表达式;所述核心转换公式为:

12、apscheduler_weekday=(traditional_weekday+6)%7

13、其中,traditional_weekday为传统运维cron表达式中以0代表周日、6代表周六的星期数值,apscheduler_weekday为apscheduler框架中以0代表周一、6代表周日的星期数值。

14、可选的,所述对所述html富文本消息内容进行递归解析,按照飞书交互式卡片规范进行样式映射,包括:

15、通过递归解析算法完整识别html的h1至h5标题、段落、粗体、斜体、删除线、有序列表及无序列表嵌套标签,严格按照飞书交互式卡片规范将各标签样式映射为对应的消息元素,保留原始排版样式;

16、其中,识别过程中,逐层遍历html标签树,对每一层级的标签类型进行判定,提取标签内的文本内容及样式属性,并按照标签层级关系递归处理子标签。

17、可选的,所述自动上传所述本地图片资源并回填图片标识,包括:

18、自动识别任务配置中的本地图片资源,主动调用飞书素材上传api完成图片上传,获取唯一image_key并自动回填至消息卡片对应位置。

19、可选的,所述对所述批量推送手机号列表进行清洗和无效号码过滤,包括:

20、自动识别逗号、分号、空格分隔符,对批量导入的手机号进行智能清洗,自动过滤空号、位数错误及非法字符的无效号码。

21、可选的,所述批量查询并映射为飞书用户标识,包括:

22、调用飞书批量用户查询api,将清洗后的有效手机号批量转换为飞书用户openid,自动将所述飞书用户openid嵌入消息推送字段。

23、可选的,所述若推送失败则生成延迟重试子任务执行单次重试,包括:

24、当业务服务层调用飞书api获取的响应结果为异常失败时,识别网络波动或api限流的瞬时可重试异常,创建120秒延迟的单次重试子任务,延迟到期后自动执行二次推送,并标记任务重试状态。

25、可选的,所述自动识别逗号、分号、空格分隔符,包括:

26、对所述批量推送手机号列表进行字符串分割,识别并记录各手机号之间的分隔符类型,基于所述分隔符类型将列表拆分为独立的手机号字符串。

27、可选的,所述创建120秒延迟的单次重试子任务,包括:

28、在数据持久层的执行历史模型中生成一条重试记录,记录原始任务标识、重试触发时间、延迟时长及重试状态,将所述重试子任务加载至apscheduler调度框架,在延迟到期后触发执行。

29、本发明实施例的具有以下有益效果:

30、1.针对cron 规则冲突问题:通过公式化自动转换算法,实现定时参数全自动适配,将定时任 务配置错误率降至0,彻底杜绝任务执行错乱、漏执行问题,无需人工适配框架规则,大幅降 低运维批量配置任务的工作量与出错概率。

31、2.针对富文本、图片处理难题:实现html图文内容无损转换、本地图片全自动上传与嵌入, 完全替代人工排版、手动传图操作,各类图文类办公通知、报表推送实现全自动化落地,适配 企业规范化推送需求。

32、3.针对批量人员推送低效问题:支持多格式手机号批量导入、智能清洗、批量id映射,精准 实现定向@用户推送,无需人工查询录入openld,企业批量通知效率提升90%以上。

33、4.针对推送容错能力差的问题:120秒可控单次延迟重试机制,精准解决网络波动、 api 限流 等瞬时异常故障,消息整体送达率提升至99.8%以上,彻底规避消息漏推送风险。

34、5. 针对故障溯源困难问题:构建全链路日志持久化体系,完整留存接口报文、异常堆栈、执 行时间、重试记录等全量数据,运维故障排查效率提升60%,显著降低运维排查成本。

35、6. 针对消息辨识度低的问题:多主题差异化卡片、关键词高亮渲染,实现告警、报表、会议 提醒等场景消息差异化展示,帮助员工快速抓取核心信息,大幅提升消息触达效果。

1.一种适配飞书平台的智能定时任务消息调度方法,其特征在于,包括以下步骤:

2.如权利要求1所述的方法,其特征在于,所述接收定时任务配置信息,包括:

3.如权利要求1所述的方法,其特征在于,所述对所述传统cron表达式中的星期字段按照预设转换规则进行自动修正,包括:

4.如权利要求1所述的方法,其特征在于,所述对所述html富文本消息内容进行递归解析,按照飞书交互式卡片规范进行样式映射,包括:

5.如权利要求1所述的方法,其特征在于,所述自动上传所述本地图片资源并回填图片标识,包括:

6.如权利要求1所述的方法,其特征在于,所述对所述批量推送手机号列表进行清洗和无效号码过滤,包括:

7.如权利要求1所述的方法,其特征在于,所述批量查询并映射为飞书用户标识,包括:

8.如权利要求1所述的方法,其特征在于,所述若推送失败则生成延迟重试子任务执行单次重试,包括:

9.如权利要求6所述的方法,其特征在于,所述自动识别逗号、分号、空格分隔符,包括:

10.如权利要求8所述的方法,其特征在于,所述创建120秒延迟的单次重试子任务,包括: