When creating a notification, you can set a category in the
notification.category parameter. A category must contain less than 256
characters and should not contain spaces.
{
"notification": {
"title": "Join the September webinar",
"category": "annoucement",
"recipients": [{ "matches": "*" }]
}
}
Creating categories
To create a category, simply pass the desired category into the notification.category parameter. No additional action is needed!
You can also create/update/delete categories from the dashboard by visiting the Categories tab.
Controlling delivery channels
By default, notifications are delivered to the channels enabled for the project. However, if you'd like notifications of a specific category to be delivered to fewer channels, we can enable that for you. Please write to us.
For example, in a Google docs-like application, you may send the 'page updated' notification only in-app, not via email or mobile push. To accomplish this in MagicBell, you can use the category update and write to us to disable email and mobile-push channels for this category.
End-user notification preference management
Notification preferences for a user are set per category. For example, in the
screenshot below, the preference labels are derived from two categories -
new_message, and new_invoice:
If you build a custom UI or integrate these preferences into your existing settings screen, you can use the notification preferences API endpoint.
Coming soon
Shortly, categories are going to enable you to
- Drill down into analytics
- Select templates