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

> Learn how to configure a message notification step in the YiDA workbench, including how to add and configure message notifications. This article also explains the differences between Work Notifications and group notifications, how to customize notification content, and answers common questions.

Message notifications send DingTalk Work Notifications or group notifications to designated users through a preconfigured notification type when a workflow reaches a specific step. Refer to this article to learn how to configure a message notification step.

## Add a Message Notification

Configure a message notification step to signal the start or completion of a workflow, or to sync approval progress.

<Steps>
  <Step title="Step 1">
    Sign in to the [YiDA workbench](https://www.yidaapps.com/workPlatform). Select the target app to open its **Page Management** page.
  </Step>

  <Step title="Step 2">
    Select the workflow form. Click the down arrow next to **Edit workflow form**, then click **Workflow design**.
  </Step>
</Steps>

3. Move the cursor to the connection line between two workflow steps. A **+** button appears. Click **+**, then select **Message step** > **Message notification**.

## Configure the Message Notification

1. Select the message notification step. In the step configuration panel on the right, choose the notification type and recipients.

| **Notification type**   | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Work Notifications**  | Messages pushed to employees in the name of an app, such as birthday greetings or onboarding reminders.<br />• **Specify users**: Select employees from your organization's contacts.<br />• **Specify roles**: Select a DingTalk role or a YiDA role. All users in your organization assigned the selected role receive the notification.<br />• **Specify user fields**: Select user fields on the form or workflow-related users.<br />**Note**: Work Notifications support Markdown syntax. For details, see [DingTalk message notification types](/yida/platform-admin/fkfhud). |
| **Group notifications** | Workflow messages sent to a group through a group bot. Both **Xiaoding bot** and **Custom bots** are supported.<br />• Send via Xiaoding: Push messages through the default group bot, Xiaoding. The message content does not support line breaks or Markdown.<br />• Send via a group bot: Send messages through a custom bot added in the group settings. Messages are pushed using the bot's webhook URL and support Markdown syntax.                                                                                                                                             |

<Steps>
  <Step title="Set the notification content. Either customize the content or use an existing notification template." />

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

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

## FAQ

**Q: Why doesn't my message notification take effect after configuration?**

When you add, modify, or delete a message template on a workflow form, click the blue **click here** text on the page. A new workflow version is created automatically to apply the changes.

**Q: What are the URL formats for YiDA instance details?**

* Workflow instance detail URL 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 URL 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 resides?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}`
```