Notification troubleshooting
Use this checklist when alerts appear in Zenhook but push notifications or email copies do not arrive.
iPhone push notifications
Zenhook can only send iOS push notifications after the app has iOS notification permission and has registered this device with the Zenhook server.
1. Check iOS permission. Open iOS Settings → Apps → Zenhook → Notifications and make sure notifications are allowed. Enable banners, sounds, and badges if you want visible alerts.
2. Check Zenhook preferences. In Zenhook, open Settings → Notifications. Make sure push alerts are enabled for your user, workspace, and any muted channel.
3. Check delivery health. The delivery health panel shows whether Zenhook has a registered iOS device for your account. If it is connected, use Send test push to verify Apple delivery.
4. Re-register the device. Fully force-quit Zenhook, reopen it, and leave it open for a few seconds on a stable network. If notifications still do not arrive, sign out and sign back in.
5. Check Focus modes. Disable Do Not Disturb, Sleep, Work Focus, and Scheduled Summary rules that may hide notification banners.
6. Contact support with your account email. We can verify whether your device token is registered and whether Apple accepted the latest push attempt.
Email alerts
Email alerts use the same notification preference cascade as push alerts. A channel or workspace override can mute email even when your user default is enabled.
1. Check Zenhook preferences. Open Settings → Notifications and confirm email alerts are enabled for the relevant workspace and channel.
2. Check spam and routing.
Look for mail from [email protected].
If your company uses strict filtering, allowlist that sender.
3. Confirm the alert was delivered to Zenhook. If the alert appears in the channel but no email arrives, contact support with the channel name and approximate time.
How delivery works
Zenhook stores your notification preferences server-side. For iOS push, Apple gives the app a device token, the app sends that token to Zenhook, and Zenhook passes it back to Apple when an alert is delivered. If Apple reports that a token is no longer valid, Zenhook removes it and waits for the app to register a fresh token.