概述

介绍了消息通知的不同类型、使用场景，消息通知接口能力，以及如何接入消息通知接口能力。

​

消息通知类型

​

工作通知消息

企业工作通知会话中某个微应用的名义推送到员工的通知消息，例如生日祝福、入职提醒等。

​

使用模板发送工作通知

​

说明

• 消息模板只支持第三方企业应用，不支持企业内部应用。
• 只有审核通过的消息模板，可用来推送工作通知消息。

• Markdown模板 Markdown模板使用Markdown语法配置和发送消息，适用于非操作的纯通知消息类型。通过Markdown模板，可以方便地支持文本、图片、链接等展现方式。
• ActionCard模板 ActionCard模板是以ActionCard消息类型来发送消息的，支持消息内容和行动点操作组合类消息，适用于在消息中需要通过单个或多个行动点快速处理的场景。 ActionCard模板在Markdown模板的基础上，支持整体跳转和独立跳转的样式。
• Form模板 Form模板基于OA消息类型来发送消息。适用于订单等消息展示，支持跳转查看消息详情。

​

使用流程

如下图所示，使用消息模板发送工作通知需要完成以下操作：

1. 创建并配置消息模板，详情请参考管理消息模板。
2. 模板审核。
3. 调用使用模板发送工作通知接口，详情请参考使用模板发送工作通知消息。

​

开放概览

消息通知提供了丰富的接口开放能力，开发者通过API接口可以实现消息通知和企业业务系统打通。

​

如何接入消息通知接口能力

钉钉提供了消息通知接口接入流程示例。

• 点击工作通知跳转到钉钉小程序
• 点击工作通知跳转到网页应用
• 发送、查询、撤回工作通知

​

名词解释

​

task_id

task_id是工作通知消息的唯一标识字段，调用发送工作通知接口返回该字段。 可通过task_id调用获取工作通知消息的发送进度接口和获取工作通知消息的发送结果接口，查询工作通知消息的发送进度和发送结果。