Troubleshooting Notification Delivery Issues
Questions:
- Why am I not receiving push notifications?
- Why is a notification missing from a user's inbox?
- Why do topic broadcasts reach some devices but not others?
Description:
When users experience issues with missing alerts or inbox discrepancies, support teams can quickly diagnose the problem by verifying token settings and inbox states.
We'll show you, step by step, how to:
-
Investigate Push Failures: Verify token registration and user opt-in preferences.
-
Resolve Missing Inbox Items: Check if a user has hidden messages from their view.
-
Verify Read Statuses: Understand why read timestamps might disappear or change.
-
Check Topic Delivery: Ensure group subscriptions match the intended audience.
Solution:
-
Investigate Missing Push Notifications
If a user is not receiving push alerts, verify their token registration. Check that the device token, application code, and platform type are valid, and confirm the push preference is enabled.
-
Check for Cleared Inbox Items - If a message is completely missing from the inbox, it may have been cleared. The standard inbox view excludes any entries marked as cleared, so you must inspect the backend linkage state to verify.
-
Review Read and Unread Toggles
If a previously read message suddenly shows as unread, the user likely toggled its status. Triggering the unread action sets the read status to false and permanently clears the original read timestamp.
-
Verify Topic Subscriptions
If a group broadcast misses certain devices, check the user's subscription list. Confirm the device token is still active for the correct platform and that the specific topic name exists in their subscribed list.
-
Inspect Creation Permissions
If a user complains that they can view notifications but cannot send them, review their assigned security rights. Creating notifications requires a specific add permission, which is separate from standard viewing rights.
-
Validate Timestamp Updates
To verify when an action occurred, check the unix timestamps stored in the database. Read, clear, and seen timestamps are recorded immediately at the exact moment the user triggers the action.
Tips and Tricks:
Pro-Tips:
-
Inspect the underlying linkage data to see the true historical state of a user's inbox, including hidden items.
-
Check the Firebase environment configuration first if push notifications are failing globally across all users.
Warnings:
-
Cleared items cannot be seen in the active user inbox, which is the most common cause of "missing" messages.
-
A missing platform type or application code in the device token record will cause push delivery to fail entirely.