Notification Topics

As mentioned in the Prerequisites section, topics serve the purpose of categorizing notifications so that they can be muted/unmuted independently from other notifications.

• Topics configuration is optional.
• Topics are defined & agreed between NET2GRID & the Customer.
• By default all topics are unmuted.
• Topics can be muted or unmuted on a channel level and on a channel/device level in case of push notifications

Muting/unmuting a topic

To allow end users to mute a topic use the Mute notification topic CE API endpoint:

The request body of the call should look like the following in case the end-user wants to not receive notifications under the "APPLIANCE_EVENTS_DETECTION" topic in their email:

{
     "channel": "EMAIL",
     "topic": "APPLIANCE_EVENTS_DETECTION"
}

while if push notifications of the same topic would be disabled, then the device_id needs to also be provided like in the example below:

{
     "channel": "MOBILE_PUSH",
     "device_id": "<deviceId>",
     "topic": "APPLIANCE_EVENTS_DETECTION"
}

📘

For PUSH notifications, similar to channel enabling/disabling, the topics need to be muted/unmuted on a device level. See Unmute topic for a detailed overview of this endpoint.

Check topic status

The same endpoint and process described in the Get current notification channel state section to check if a topic is muted or not for a specific channel and device.