Message Notification Step

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.

Step 1

Step 2

Select the workflow form. Click the down arrow next to Edit workflow form, then click Workflow design.

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

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. • Specify users: Select employees from your organization’s contacts. • Specify roles: Select a DingTalk role or a YiDA role. All users in your organization assigned the selected role receive the notification. • Specify user fields: Select user fields on the form or workflow-related users. Note: Work Notifications support Markdown syntax. For details, see DingTalk message notification types.
Group notifications	Workflow messages sent to a group through a group bot. Both Xiaoding bot and Custom bots are supported. • Send via Xiaoding: Push messages through the default group bot, Xiaoding. The message content does not support line breaks or Markdown. • 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.

Set the notification content. Either customize the content or use an existing notification template.

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.

After confirming the configuration, click Save.

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

https://www.yidaapps.com/APP_xxx/processDetail?procInsId=7e03d424-xxxx-8080

YiDA domain/App AppType/Fixed parameter (processDetail)?procInsId=Instance ID of the data

`${location.origin}/${window.pageConfig.appType || window.g_config.appKey}/processDetail?procInsId=${procInsId}`

Form instance detail URL format

https://www.yidaapps.com/APP_xxx/formDetail/FORM-xxx?formInstId=FINST-xxx

YiDA domain/App AppType/Fixed parameter (formDetail)/formUuid of the table where the data resides?formInstId=Instance ID of the data

`${location.origin}/${window.pageConfig.appType || window.g_config.appKey}/formDetail/${formUuid}?formInstId=${formInstId}`

Getting Started

Quick Start

Form Management

Workflow Design

Report Design

Aggregate Table Design

Portal Design

Custom Pages

Integration & Automation

Cool App

App Management

Platform Management

Internationalization

YiDA Dedicated

Developer Features

Add a Message Notification

Configure the Message Notification

FAQ

​Add a Message Notification

​Configure the Message Notification

​FAQ

Add a Message Notification

Configure the Message Notification

FAQ