Notifications not arriving
Notifications have a lot of moving parts: OS permissions, device tokens, server-side delivery rules, channel toggles. When they don’t arrive, work through these in order.
Step 1: Check that you allowed notifications
Open the iOS or Android Settings app → Hilal → Notifications → confirm Allow Notifications is on.
If it’s off, turn it on, return to the Hilal app, and Send a test notification (Settings → Notifications → Send test).
Step 2: Check Hilal’s channel toggles
Open the Hilal app → Settings → Notifications → confirm the channels you care about are on.
The default for every channel is on, so unless you toggled something off intentionally, they should all be active.
Step 3: Send a test push
Settings → Notifications → Send test notification.
If this works, your device is registered correctly with Hilal’s backend; the issue is with the specific events not firing, not with push delivery itself.
If this doesn’t work, the device isn’t registered. Continue to step 4.
Step 4: Re-register the device
Sign out of the app (Settings → Sign out) and sign back in. Re-signing in re-registers your device’s push token with Hilal’s backend.
After signing back in, immediately try Send test notification.
Step 5: Check Do Not Disturb / Focus modes
iOS Focus modes and Android Do Not Disturb suppress notifications even when permission is granted.
- iOS: Settings → Focus → check that no Focus is active blocking Hilal.
- Android: pull down the quick-settings panel → check Do Not Disturb is off (or that Hilal is on its allowed list).
Step 6: Check OS-level battery saving
Aggressive battery-saving features can suppress background processes, including push delivery.
- iOS: Settings → Battery → confirm Low Power Mode isn’t blocking apps.
- Android: Settings → Battery → Battery optimization → confirm Hilal isn’t restricted. Some Android OEMs (Xiaomi, Huawei) have aggressive optimizers that need explicit allow-listing.
Step 7: Check the channel-specific event is actually live
Some channels are coming soon — even with everything else right, those won’t fire until backend delivery is live.
| You expected… | Status today |
|---|---|
| Note reminder | ✅ Live |
| Test push | ✅ Live |
| New buyer message | Partial (delayed) |
| Order received | Coming soon |
| Listing change | Coming soon |
| Hijack alert | Coming soon |
| Customer escalation | Coming soon |
| Workflow status | Coming soon |
If you were expecting a Coming-soon channel, that’s why nothing arrived.
Step 8: Reinstall as a last resort
If all the above fail, delete and reinstall the app. This forces a fresh token registration.
Reporting unresolved issues
Report a bug with:
- iOS or Android, and OS version.
- App version (Settings → About).
- Which test or expected event didn’t fire.
- Result of the test-push button.