Push Integration Guide (OneSignal)

Push integration sends MailHook events to subscribed devices.

Requirements

• OneSignal app configured for your origin.
• Browser permission granted.
• Resolved OneSignal subscription identifier.

Validation sequence

1. Confirm NEXT_PUBLIC_ONESIGNAL_APP_ID in dashboard frontend.
2. Check browser push support.
3. Initialize OneSignal SDK and request permission.
4. Resolve subscription ID and store it.
5. Activate integration and test delivery.

Common issues

• Missing app ID configuration.
• Browser permission denied.
• Origin mismatch in OneSignal settings.