> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 消息通知概述

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

## 消息通知类型

钉钉的消息通知类型如下：

* **使用模板发送工作通知：**

  消息模板是第三方企业应用通过工作通知推送消息的升级，在提供更加简化和规范体验的消息模板开发配置能力的同时，也能对客户侧提供更加安全和可管可控的消息通知能力，请参考[消息模板概述](/zh/open/development/message-template-overview)。

  **说明**

  消息模板只支持第三方企业应用，不支持企业内部应用。

![模版类型](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/6441106361/p347761.png)

* **工作通知消息**：

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

  ![工作通知 ](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1419906361/p348265.png)

## 消息通知接口能力

### 消息通知开放的接口列表

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

**工作通知**

| API           | 说明             | 新版规范（新版服务端API） | 旧版规范（服务端API）                                                                                                    |
| ------------- | -------------- | -------------- | --------------------------------------------------------------------------------------------------------------- |
| 发送工作通知        | 发送工作通知消息。      | -              | [发送工作通知](/zh/open/development/asynchronous-sending-of-enterprise-session-messages)                              |
| 更新工作通知状态栏     | 更新OA工作通知消息的状态。 | -              | [更新工作通知状态栏](/zh/open/development/update-work-notification-status-bar)                                           |
| 获取工作通知消息的发送进度 | 获取工作通知消息的发送进度。 | -              | [获取工作通知消息的发送进度](/zh/open/development/obtain-the-sending-progress-of-asynchronous-sending-of-enterprise-session) |
| 获取工作通知消息的发送结果 | 查询工作通知消息的发送结果。 | -              | [获取工作通知消息的发送结果](/zh/open/development/gets-the-result-of-sending-messages-asynchronously-to-the-enterprise)      |
| 撤回工作通知消息      | 撤回工作消息通知。      | -              | [撤回工作通知消息](/zh/open/development/notification-of-work-withdrawal)                                                |

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

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

* 点击工作通知跳转到钉钉小程序
* [点击工作通知跳转到钉钉微应用](/zh/open/development/redirect-micro-applications-to-work-messages)

## 名词解释

### task\_id

task\_id是工作通知消息的唯一标识字段，调用[发送工作通知](/zh/open/development/asynchronous-sending-of-enterprise-session-messages)接口返回该字段。

可通过task\_id调用[获取工作通知消息的发送进度](/zh/open/development/obtain-the-sending-progress-of-asynchronous-sending-of-enterprise-session)接口和[获取工作通知消息的发送结果](/zh/open/development/gets-the-result-of-sending-messages-asynchronously-to-the-enterprise)接口，查询工作通知消息的发送进度和发送结果。