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 follow the same settings as push. Zenhook takes the most specific answer: your choice for a channel, then your choice for the workspace.
To turn email off for a whole workspace, openSettings → Notifications and switch off Email on the Alerts row. A channel listed under Channel exceptions keeps its own setting. Every email we send also carries an unsubscribe link, which does the same thing.
1. Check Zenhook preferences. Open Settings → Notifications. It shows whether your phone can receive alerts, what you get in this workspace, and every channel where you chose something different.
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.
Busy streams
When the same event keeps coming, a game's Game started 25 times an hour for example, Zenhook notifies the first 3 of the hour and groups the rest: at most one notification an hour for the channel, listing each event and its count (Game started ×37 · New wave reached ×20). An event that rarely happens still notifies on its own, and a stream quiet for two hours notifies normally again.
More than 4 alerts in one minute pause notifications for the channel for 5 minutes. Either way, the feed and its widgets show every event.
Scheduled reports
Ask the Assistant for a report on a rhythm, in your own words:every morning at 8, give me the downloads and the new players of the last 24 hours. It answers once, then sends the report at that time in your timezone, on fresh data: a notification that opens the report's own conversation, where you can reply (and last week?). Every run also lands in your private Reports channel.
A report opens with its figures, each beside the one from the period just before (36 downloads (72 the day before)), and ends with the period it covers, in your local time.
Change it by asking (move it to 9:30 on weekdays, pause my morning report), or from the Reports list above the Assistant's history: edit, run now, pause, delete. Each run counts as one Assistant question; a run that cannot happen says so in the channel.
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.