Send notification

How to show signed-in users a message from an automation, which settings there are and when the step fails.

Use this action to show a message window to the users signed in on the device, for example to announce maintenance. It only delivers the message and does not wait for a reply. To ask a question and act on the answer, use Ask user instead. The device must be online.

Prerequisites

A Windows or macOS device with a user signed in.

Configuration fields

Field	Type	Required	Default	Description
Title	text	Yes	—	Heading of the message window. Supports variables `${{ … }}` through Insert variable.
Message	formatted text (Markdown)	Yes	—	Body of the message window. Use the toolbar to format it, for example with bold text, lists or links with full `https://` or `http://` addresses. HTML and images are not supported. Supports variables `${{ … }}` through Insert variable.

You cannot save the automation while Title or Message is empty. For more on formatting, see Send a notification and request a response.

Platform support

Platform	Supported
Windows	Yes
Linux	No
macOS	Yes

On Linux, the step always fails with No user is signed in on the device.

Outputs

This action produces no outputs.

Result behaviour

Case	Result
At least one user is signed in	Succeeded. The window appears in every connected session.
Nobody is signed in	Failed: No user is signed in on the device.
Title or Message is empty after variables are filled in	Failed.
The device is offline	Device offline. Depending on If device is offline, the run ends with this status or the step is skipped.
The agent does not respond in time	Timed out. Whether the message arrived is then unknown.

A successful step only confirms delivery, not that someone read the message. The window stays open until the user acknowledges it. Each delivery is also recorded in the device log with title and message.

By default, On failure is set to Stop the workflow, so the automation stops when nobody is signed in. To carry on with maintenance anyway, set On failure on this step to Continue to next step.

Was this helpful?

Still need help? Ask the team