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

> Learn how to configure message notification steps on the YiDA platform, including how to add and configure notifications. This article also covers Work Notifications, group notifications, and answers to frequently asked questions.

Message notifications send DingTalk Work Notifications or group notifications to specified users through a configured notification type when a workflow reaches a specific step.

## Add a Message Notification

Configure a message notification step to notify users when a workflow ends, starts, or when approval progress needs to be synced.

1. Sign in to YiDA Workbench and click My Apps.
2. Select the app you need and open the App Settings page.
3. Click Integration & Automation, select an existing integration & automation flow, and click Edit.
4. Move the cursor to the connection line between workflow steps. A **+** button appears. Click **+** and select Message Step > Message Notification.

## Configure a Message Notification

1. Select the message notification step. In the step configuration panel on the right, select the Notification Type and Recipients.

| **Notification Type**   | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Work Notifications**  | Work Notifications are messages pushed to employees in the name of a specific app, such as birthday greetings or onboarding reminders.<br />• **Specified users**: Select employees from your organization's Contacts.<br />• **Specified roles**: Select a DingTalk role or a YiDA role. Once selected, every user in your organization with that role receives the notification.<br />• **Specified user fields**: Select user fields from the form or workflow-related users.<br />**Note**: Work Notifications support Markdown syntax. For the supported syntax types, see [DingTalk message notification types](/yida/platform-admin/fkfhud). |
| **Group notifications** | Group notifications are workflow messages sent to a group via a Group bot. Send them using either the **Xiaoding bot** or a **Custom bot**.<br />• Send via Xiaoding: The default Group bot Xiaoding pushes the messages. Message content does not support line breaks or Markdown.<br />• Send via Group bot: A Custom bot added in Group settings sends messages using the bot's webhook URL. Message content supports Markdown syntax.                                                                                                                                                                                                           |

<Steps>
  <Step title="Set the message notification content. Both Custom content and existing notification templates are supported." />

  <Step title="Configure the redirect destination of the button at the bottom of the Card. Redirect to the current form's detail page or to a custom link, and pass form fields as parameters in the custom link." />

  <Step title="After confirming the configuration, click Save." />
</Steps>

## FAQ

**Q: Why doesn't the configured message notification take effect?**

If you add, modify, or delete a message template in a workflow form, click the blue text \[Click here] on the page. A new workflow version is created automatically to apply the changes.

**Q: What is the format of a YiDA instance detail link?**

* Workflow instance detail link format

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://www.yidaapps.com/APP_xxx/processDetail?procInsId=7e03d424-xxxx-8080
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
YiDA domain/App AppType/Fixed parameter (processDetail)?procInsId=Instance ID of the data
```

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
`${location.origin}/${window.pageConfig.appType || window.g_config.appKey}/processDetail?procInsId=${procInsId}`
```

* Form instance detail link format

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://www.yidaapps.com/APP_xxx/formDetail/FORM-xxx?formInstId=FINST-xxx
```

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
YiDA domain/App AppType/Fixed parameter (formDetail)/formUuid of the table where the data is located?formInstId=Instance ID of the data
```

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
`${location.origin}/${window.pageConfig.appType || window.g_config.appKey}/formDetail/${formUuid}?formInstId=${formInstId}`
```