Set Up Browser & PWA Push Notifications in 1 Minute (2026 Guide)
Turn on browser push and mobile PWA notifications in HeyChat so you never miss a chat. One-minute setup for Chrome, Firefox, Safari, Android, and iOS — plus fixes for the 5 most common reasons notifications stop working.
What kinds of notifications does HeyChat send?
HeyChat sends two kinds of notifications: in-app (the bell icon, always on) and web push (browser + PWA, opt-in per device). Web push is the one that actually wakes your screen when a customer messages you — in-app alerts only show while you have the tab open.
In-app notifications live in the bell icon at the top of HeyChat. They cover assignment alerts, role changes, integration events (a platform disconnected, a connector failed), storage warnings, and data-export completions. The bell shows an unread badge and persists until you mark items read. No setup needed.
Web push notifications are delivered by your browser's push service — Google's FCM for Chrome, Mozilla's autopush for Firefox, Apple's APNs for Safari — using the W3C Push API standard. They appear in the OS notification center even when HeyChat is closed or your laptop is locked, and they fire for two events: a new message in a conversation assigned to you, and a new conversation just assigned to you.
Role-based delivery: some events only go to specific roles. Integration failures and storage warnings notify Owners and Admins. Data exports notify only the Owner who started them. Customer assignment notifications go to the assigned Agent. You don't configure this — HeyChat routes by role automatically.
How do I enable browser push notifications in HeyChat?
Open HeyChat → click your avatar → Notifications → toggle "Enable push notifications" on, then click Allow in the browser prompt. Setup is one minute on a supported desktop browser.
- Sign in at
app.heychat.siand click your avatar (top-right) → Notifications. - Toggle Enable push notifications to on.
- Your browser shows a permission prompt at the top of the window. Click Allow.
- Click Send test notification in the same panel. A test alert should appear in your OS notification center within a few seconds.
Supported browsers: Chrome 50+, Edge 17+, Firefox 44+, Opera 39+, and Safari 16+ on macOS Ventura or newer. The Push API itself is supported across all modern browsers per MDN — Push API.
If you blocked the prompt by accident the toggle will look on but no notifications arrive. Re-allow site permissions:
- Chrome / Edge: click the lock icon left of the URL bar → Site settings → Notifications → Allow. Google documents the same flow in Chrome Help — Turn notifications on or off.
- Firefox: click the lock icon → Connection secure → More information → Permissions → Receive notifications → uncheck Use Default and select Allow. See Mozilla — Push notifications in Firefox.
- Safari (macOS): Safari → Settings → Websites → Notifications → find
app.heychat.siand set to Allow. Apple documents this in Safari User Guide — Customize website notifications.
You'll know it worked when the test notification appears in your OS tray with the HeyChat icon, the title "Test notification", and a body line confirming delivery.
How do I get push notifications on my phone?
Install HeyChat as a Progressive Web App (PWA), then enable push from inside the installed app — not from a regular browser tab. Mobile browsers only deliver web push to apps installed to the home screen.
Android (Chrome):
- Open
app.heychat.siin Chrome and sign in. - Tap the three-dot menu → Add to Home screen → Install.
- Launch HeyChat from your home screen icon (not from the browser tab).
- Go to avatar → Notifications → toggle on → tap Allow when Android asks.
iOS / iPadOS (Safari 16.4 or newer): Apple only supports web push for apps installed to the home screen — see Apple's WebKit — Web Push for Web Apps on iOS and iPadOS. The HeyChat settings panel will show an "Install to Home Screen first" message until you complete this step.
- Open
app.heychat.siin Safari (not Chrome — third-party browsers on iOS use WebKit but can't host installed PWAs). - Tap the Share icon (square with arrow) → Add to Home Screen → Add.
- Launch HeyChat from the new home-screen icon. The first launch enables PWA mode.
- Inside the PWA, go to avatar → Notifications → toggle on → tap Allow.
How working hours interact with mobile push: if you've set your shift in your employee profile and enabled Silence notifications outside my working hours, HeyChat skips push delivery to your device during off-hours. In-app bell items still accumulate so you have full context when you log back on. Configure your shift in working-hour settings.
Can I change the notification sound or which events alert me?
The notification sound is controlled by your operating system, not by HeyChat. HeyChat sends a standard web-push payload; macOS, Windows, iOS, and Android decide which sound plays based on each app's notification preferences.
Change the sound (or mute it without losing the banner):
- macOS: System Settings → Notifications → find your browser (Chrome / Safari / Firefox) → set Alert sound to None or any system sound. Apple documents this in macOS User Guide — Change notification settings.
- Windows 11: Settings → System → Notifications → expand your browser → uncheck Play a sound when a notification arrives.
- Android: long-press a HeyChat notification in the tray → tap the gear icon → choose a custom channel sound or set importance to Silent.
- iOS: Settings → Notifications → HeyChat → toggle Sounds off (you still get a silent banner).
Choosing which events alert you: the master toggle is one switch — on or off per device — but you can shape what reaches you with three controls:
- Mute individual customers: right-click a conversation → Mute. Push notifications stop for that contact; messages still arrive in your inbox. Useful for chatty low-priority threads.
- Silence outside working hours: in your profile, set your shift and enable Silence notifications outside my working hours. Pushes pause during off-hours and resume the next shift.
- Role-based routing: Agents only get notifications for conversations assigned to them. Admins and Owners additionally get integration and storage events. Change role in role settings.
HeyChat also rate-limits to 10 push notifications per minute per agent — if a single conversation goes hot, you'll see one batched alert instead of dozens.
Why am I not getting notifications from HeyChat?
Five things break push notifications in order of how often we see them: denied permission, an ad-blocker or privacy extension, OS Focus / Do Not Disturb, mobile background restrictions, and a missed PWA install on iOS.
1. Browser permission is denied. The HeyChat toggle reads as on but the browser is silently blocking. Open the lock icon next to app.heychat.si in the URL bar — if Notifications says "Block", switch to "Allow" and reload. Per Google's Chrome notification guide, denied permissions are sticky and won't re-prompt.
2. An extension is filtering push. Privacy Badger, uBlock Origin with custom filters, Brave's Shields, and corporate VPN clients can intercept the connection to fcm.googleapis.com (Chrome), updates.push.services.mozilla.com (Firefox), or web.push.apple.com (Safari). Disable extensions one at a time on HeyChat and re-test.
3. OS Focus / Do Not Disturb is on. macOS Focus, Windows Focus Assist, iOS Focus modes, and Android Do Not Disturb suppress notifications even when the browser receives them. Check the Focus indicator in your menu bar / control center and either disable it or add HeyChat to the allowed-apps list. Apple's Use Focus on iPhone guide covers the iOS allow-list.
4. Mobile aggressive battery-saving. Samsung One UI's "Put unused apps to sleep", Xiaomi MIUI's autostart manager, and Huawei EMUI's protected-apps list will freeze the HeyChat PWA in the background and drop its push connection. Open your phone's battery settings, find HeyChat (or your browser if you haven't installed the PWA), and set it to Unrestricted or Don't optimize.
5. iOS PWA not installed. Per Apple's WebKit announcement, iOS Safari only delivers web push to apps added to the Home Screen. Opening HeyChat in a Safari tab on iPhone will never produce push notifications, even with permission granted.
If notifications worked yesterday and stopped today: your browser may have rotated the push endpoint and the subscription expired. Toggle Notifications off then back on in your HeyChat profile — HeyChat will issue a fresh subscription on the next page load. Platform-side message-sync issues are separate from notifications and are handled per-connection in your channel settings.
Frequently Asked Questions
About one minute on a supported desktop browser: open avatar → Notifications, toggle on, click Allow in the browser prompt, then click Send test notification to confirm. Mobile setup takes two minutes including the Add to Home Screen step, which is required on iOS 16.4+ per Apple's WebKit documentation.
Yes, starting with iOS and iPadOS 16.4. You must add HeyChat to your Home Screen via Safari's Share menu first — Apple's WebKit policy only delivers web push to installed Progressive Web Apps, not to ordinary Safari tabs. Third-party iOS browsers like Chrome and Edge can't host installed PWAs, so install through Safari specifically.
Yes. Once you enable push notifications, your browser's push service (Google FCM on Chrome, Mozilla autopush on Firefox, Apple APNs on Safari) delivers alerts even when the tab is closed or your laptop is locked. The tab does not need to be open. Mobile PWAs receive push the same way native apps do.
Set your shift start and end time in your employee profile, then enable Silence notifications outside my working hours. HeyChat will pause push delivery during off-hours while still recording in-app bell items so you have full context when you log back on. Configure your shift on the working hours help page.
Notifications are opt-in per device, so each teammate enables them independently in their own profile. Role also matters: Agents only get notified about conversations assigned to them, while Owners and Admins additionally receive integration failures and storage warnings. If both of you have the same role and identical settings, suspect a permission, Focus mode, or ad-blocker on your device — see the troubleshooting section above.
Ready to try HeyChat?
$87/month flat. Up to 15 agents. 7-day free trial, no credit card required.
Start your free trial