Intro

Notifications are important and we need them all the time. The same applies to information coming from your NAS or better yet DSM. Personally, I have been using Pushover for all my needs when it comes to pushing notifications.

Be it DSM 6 or 7 you can use Pushover as your "push provider", but with DSM 7, Synology has implemented support for webhooks. If you are a user of Discord, Mattermost, Rocket Chat, or Synology's own Chat, then you probably know that you can push notifications into those chat platforms using incoming webhooks.

For this example, I will use Rocket Chat as a platform of choice, as I use it daily, and getting notifications on my phone/watch will be also backed up by notifications using webhooks.

So the idea is to get DSM notifications for any major event that would be logged in the Log Center to be pushed to my chat platform.

Configuration of incoming webhook inside Rocket Chat

The first thing you need is of course a running Rocket Chat instance (use the link above to get it going), in order to be able to configure the incoming webhook from another system.

Once you are up and running, head over to Rocket Chat Administration > Integrations and click the +New (blue) button to make a new integration.

Part of the Integration window

You will be creating the new incoming integration so be sure to have the first tab selected.

Enter the name of the webhook (any descriptive name you want), the channel you have in your Rocket Chat ( #notifications  or something along that line), and a user account that will execute and post the message (this is Rocket Chat user).

Once you have done that, scroll to the bottom and save the changes. This will now generate the webhook URL that you will use inside DSM in the next part of this article.

Webhook URL will generate after you click the save button

Finally, do not forget to activate this rule by using the Enable toggle on the top of this window (first image, upper right corner). This is very easy to miss, as you can configure webhooks and have them active or disabled however you want.

The URL will look like this example: https://rocket.domain.com/hooks/xxx...

Configuration of webhook on DSM side

Now that we have prepared the Rocket Chat side, it is time to configure the DSM push webhook settings to work with it. Head over to Control Panel > Notifications > Push Service (tab).

Push service section of DSM. Webhook settings are on the bottom

On the bottom, you will see the Application Webhooks section and a Manage webhooks button. Click it to open the dialog box.

Configure the webhook as follows:

Select Custom option as you application provider
Enter the needed values

As a provider name you can enter whatever you want, and do not modify the subject line in any way. Finally, copy the webhook URL that you got from Rocket Chat.

Finally, select POST as your HTTP method. After that move on to the next step.

Do not change the header

Rocket Chat when it comes to headers uses Content-Type with this exact value, so in this case, you don't have to add or enter anything, just move to the next step.

Enter the values as needed

For Rocket Chat we do need to add a single field that will contain the body of our message. Enter text as the parameter, and - as its value. Nothing more is needed so on to the final step.

Make sure to map the parameter and category

In the final step make sure to map the Message Content category to our text parameter. After that is done, click Apply and you are done.

Testing the webhook

Now that we have everything configured, you can use the Send Test Message button in order to see if your webhook works. If all is well, you will get similar results in your Rocket Chat channel.

Rocket Chat showing NAS/DSM events inside a predefined channel

That's it, now you can get your DSM 7 powered NAS notifications inside your Rocket Chat UI without the need to use other push services, or fill up your inbox with emails.

The benefit of webhook push notifications unlike classic push notifications is that they will remain in your history as part of the channel, so you can filter and search them as needed.

Finally, use the Rules tab inside the Notifications section to select what exact notifications you want to receive via the push method.

Use the checkboxes to select or deselect events

Hope this will come in handy, and if you have any questions, suggestions, or comments, leave them down in the comment section.