# What this PR does This is the first of many mobile app doc tweaks. Note that right now the docs are very much out of date. To make this a smooth process, I recommend to merge if it looks "good enough", don't sweat details at this time. We can make further refinements later. If @imtoori approves, this PR may be merged as is, and i'll make new ones in the future, or i will just keep pushing more and more tweaks over the next few business days ## Which issue(s) this PR fixes ## Checklist - [ ] Unit, integration, and e2e (if applicable) tests updated - [x] Documentation added (or `pr:no public docs` PR label added if not required) - [x] `CHANGELOG.md` updated (or `pr:no changelog` PR label added if not required) --------- Co-authored-by: Salvatore Giordano <salvatoregiordanoo@gmail.com> Co-authored-by: Matvey Kukuy <Matvey-Kuk@users.noreply.github.com> Co-authored-by: Matvey Kukuy <motakuk@gmail.com>
3.9 KiB
| canonical | keywords | title | weight | ||||
|---|---|---|---|---|---|---|---|
| https://grafana.com/docs/oncall/latest/mobile-app/push-notifications/ |
|
Push notifications | 200 |
Push notifications
There are three types of push notifications for the mobile app:
- Mobile push - Sends a typical push notification to your mobile device. Intended for all types of alerts.
- Mobile push important - Sends a push notification for important alerts. We recommend (and default) to louder notifications.
- On-Call Shift Notifications - Sends announcements for upcoming shifts (optional).
Add mobile app to notification policies
To receive push notifications from the Grafana OnCall mobile app, you must add them to your notification policy steps. Important notifications should include Mobile push important and Default notifications should include Mobile push.
In the Settings tab of the mobile app, tap on Notification policies to review, reorder, remove, add or change steps.
Alternatively, you can do the same on desktop. From Grafana OnCall, navigate to the Users page, click View my profile and navigate to the User Info tab.
Configuration
Use the Push notifications section in the Settings tab to configure push notifications.
You can always confirm how a notification is presented by going to Grafana OnCall on your desktop, navigate to the Users page, click View my profile and navigate to the Mobile App connection tab. Here you can send a test notification of default or important priority.
Android
On Android, we leverage the "Notification channels" system feature. Each type of notification (important, default, and on-call shifts) registers a channel. In this channel, you may configure the sound style, optional Do Not Disturb override, vibration, and so on. Customize notifications takes you to this system menu, while hitting the back button or swiping left (if enabled) takes you back to the application.
Volume Override can optionally be configured in the mobile app itself. Confusingly, this requires you to provide the Override Do Not Disturb permission to the application, in the system configuration. The app will prompt for this if applicable.
Note
: You can explore included sounds and recommendations via the Sound Library button, but to change the sound, go to Customize notifications.
iOS
On iOS, all configuration (such as sound selection, Do Not Disturb override, etc) happens inside the app.
For every type of notification (important, default, and on-call shifts), you can configure the sound and its style (constant vs intensifying).
You can also enable or disable Do Not Disturb override for important notifications.
On-call shift notifications
On-call shift notifications are sent to announce upcoming shifts, roughly ~15 minutes in advance.
To enable or disable on-call shift notifications, use the On-call shift notifications section in the Push notifications settings.