> ## 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.

# Message Notification Overview

> Introduces the different types and use cases of message notifications, the message notification API capabilities, and how to integrate them.

This document introduces the different types and use cases of message notifications, the message notification API capabilities, and how to integrate them.

## Message Notification Types

DingTalk provides the following types of message notifications:

* **Send Work Notifications Using a Template:**

  Message templates are an upgrade to the way Third-party enterprise apps push messages through Work Notifications. They provide simpler and more standardized development and configuration capabilities for message templates, while also offering more secure, manageable, and controllable message notification capabilities on the customer side. For more information, see [Message Template Overview](/zh/open/development/message-template-overview).

  **Note**

  Message templates are supported only for Third-party enterprise apps, not for Internal apps.

* **Work Notification Messages**:

  These are notification messages pushed to employees in the name of a Micro app within your organization's Work Notifications chat, such as birthday greetings and onboarding reminders.

## Message Notification API Capabilities

### List of Open Message Notification APIs

Message notifications offer rich API capabilities. Through the APIs, developers can integrate message notifications with their organization's business systems.

**Work Notifications**

| API                                                     | Description                                                | New Specification (New Server API) | Legacy Specification (Server API)                                                                                                                         |
| ------------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Send Work Notifications                                 | Sends a Work Notification message.                         | -                                  | [Send Work Notifications](/zh/open/development/asynchronous-sending-of-enterprise-session-messages)                                                       |
| Update Work Notification Status Bar                     | Updates the status of an OA Work Notification message.     | -                                  | [Update Work Notification Status Bar](/zh/open/development/update-work-notification-status-bar)                                                           |
| Get the Sending Progress of a Work Notification Message | Gets the sending progress of a Work Notification message.  | -                                  | [Get the Sending Progress of a Work Notification Message](/zh/open/development/obtain-the-sending-progress-of-asynchronous-sending-of-enterprise-session) |
| Get the Sending Result of a Work Notification Message   | Queries the sending result of a Work Notification message. | -                                  | [Get the Sending Result of a Work Notification Message](/zh/open/development/gets-the-result-of-sending-messages-asynchronously-to-the-enterprise)        |
| Recall a Work Notification Message                      | Recalls a Work Notification message.                       | -                                  | [Recall a Work Notification Message](/zh/open/development/notification-of-work-withdrawal)                                                                |

## How to Integrate Message Notification API Capabilities

DingTalk provides sample integration flows for message notification APIs.

* Redirect to a DingTalk Mini Program from a Work Notification
* [Redirect to a DingTalk Micro App from a Work Notification](/zh/open/development/redirect-micro-applications-to-work-messages)

## Glossary

### task\_id

The `task_id` is the unique identifier field of a Work Notification message. It is returned when you call the [Send Work Notifications](/zh/open/development/asynchronous-sending-of-enterprise-session-messages) API.

Use the `task_id` to call the [Get the Sending Progress of a Work Notification Message](/zh/open/development/obtain-the-sending-progress-of-asynchronous-sending-of-enterprise-session) API and the [Get the Sending Result of a Work Notification Message](/zh/open/development/gets-the-result-of-sending-messages-asynchronously-to-the-enterprise) API to query the sending progress and result of a Work Notification message.
