Push Notification Configuration

Keep your team informed in real time with push notifications from KyberAccess. This guide walks you through enabling Firebase Cloud Messaging (FCM), configuring browser and mobile push permissions, selecting which events trigger notifications, setting per-user preferences, configuring quiet hours, and reviewing your notification history.

Overview

Push notifications deliver instant alerts directly to your browser or mobile device whenever key events occur in KyberAccess — a new visitor checks in, an emergency is triggered, or a watchlist match is detected. Unlike email, push notifications appear immediately on-screen, making them ideal for time-sensitive events at your facility.

Before individual users can receive push notifications, an administrator must enable Firebase Cloud Messaging at the account level. Once enabled, each user can fine-tune which events they want to be notified about and when.

Enabling Firebase Cloud Messaging (FCM)

Firebase Cloud Messaging is the underlying service that delivers push notifications to browsers and mobile devices. An account administrator must configure FCM before any push notifications can be sent.

Step 1: Access Notification Settings

1. Log in to the KyberAccess Admin Dashboard at admin.kyberaccess.com.
2. Click Settings in the left sidebar.
3. Select Notifications from the settings menu.
4. Click the Push Notifications tab at the top of the page.

Step 2: Connect Firebase

1. In the Push Notifications tab, locate the Firebase Cloud Messaging section.
2. Click the Configure FCM button.
3. You will be prompted to upload your Firebase service account JSON key file. If you do not have one, follow the on-screen link to the Firebase Console to generate a new key under Project Settings → Service Accounts → Generate New Private Key.
4. Upload the JSON key file by clicking Choose File and selecting the downloaded key.
5. Click Save Configuration.
6. A green confirmation banner will appear: "FCM configured successfully."

Step 3: Verify the Connection

1. After saving, click Send Test Notification.
2. Select a user from the dropdown and click Send.
3. The selected user should receive a test push notification within a few seconds. If they do not, verify the JSON key file is correct and that the user has granted browser notification permissions.

Browser Notification Permissions

Each user must grant their browser permission to display push notifications. Without this permission, notifications will be silently blocked by the browser regardless of your KyberAccess settings.

Granting Permission

1. Log in to KyberAccess from your browser (Chrome, Edge, Firefox, or Safari).
2. When prompted with a browser pop-up asking "kyberaccess.com wants to send you notifications," click Allow.
3. If you previously dismissed or blocked the prompt, you can re-enable it:
   • Chrome: Click the lock icon in the address bar → Site Settings → set Notifications to Allow.
   • Edge: Click the lock icon → Permissions for this site → set Notifications to Allow.
   • Firefox: Click the shield icon → Permissions → clear the notification block.
   • Safari: Go to Safari → Settings → Websites → Notifications → set kyberaccess.com to Allow.
4. After granting permission, return to KyberAccess and navigate to My Profile → Notification Preferences to confirm that Browser Push shows a green Active badge.

Mobile Push Setup

The KyberAccess mobile app (available on iOS and Android) supports native push notifications for on-the-go alerting.

iOS Setup

1. Download KyberAccess from the App Store and log in with your credentials.
2. When prompted with "KyberAccess Would Like to Send You Notifications," tap Allow.
3. If you missed the prompt, go to iPhone Settings → Notifications → KyberAccess and toggle Allow Notifications on.
4. Ensure Sounds, Badges, and Banners are all enabled for the best experience.

Android Setup

1. Download KyberAccess from the Google Play Store and log in.
2. When prompted, tap Allow to grant notification permissions.
3. If notifications are not appearing, go to Android Settings → Apps → KyberAccess → Notifications and ensure the toggle is enabled.
4. For critical alerts, tap Notification Categories and set the Emergencies channel to High or Urgent priority so they override Do Not Disturb.

Configuring Event Triggers

Not every event needs a push notification. KyberAccess lets you choose exactly which events trigger a push alert.

Step 1: Open Event Trigger Settings

1. Navigate to Settings → Notifications → Push Notifications.
2. Scroll down to the Event Triggers section.

Step 2: Enable or Disable Event Types

Toggle each event type on or off based on your facility needs:

3. Click Save Changes after adjusting your selections.

Note: Emergency Alerts and Watchlist Matches are enabled by default and cannot be disabled by non-admin users for security compliance.

Per-User Notification Preferences

Each user can customize their own notification preferences to control what they receive, independent of the account-level settings.

Adjusting Your Preferences

1. Click your profile avatar in the top-right corner of the dashboard.
2. Select My Profile from the dropdown menu.
3. Click the Notification Preferences tab.
4. Under the Push Notifications section, you will see a list of all enabled event types.
5. Use the toggles to enable or disable notifications for each event type.
6. Click Save Preferences.

Administrators can also manage notification preferences on behalf of other users:

1. Navigate to Settings → Users.
2. Click on the target user.
3. Select the Notifications tab.
4. Adjust toggles and click Save.

Quiet Hours

Quiet hours let you suppress non-critical push notifications during specific time windows — perfect for after-hours or weekends.

Setting Up Quiet Hours

1. Go to My Profile → Notification Preferences.
2. Scroll to the Quiet Hours section.
3. Toggle Enable Quiet Hours to on.
4. Set your Start Time (e.g., 8:00 PM) and End Time (e.g., 7:00 AM).
5. Select which days quiet hours apply (e.g., Monday–Friday, Every Day, or custom selection).
6. Click Save.

Important: Emergency alerts and watchlist matches will always break through quiet hours. These critical notifications cannot be silenced to ensure safety compliance.

Administrators can set facility-wide default quiet hours under Settings → Notifications → Quiet Hours Defaults. Individual users can override these defaults with their own schedule.

Notification History and Log

KyberAccess maintains a complete log of all push notifications sent, allowing you to review past alerts and troubleshoot delivery issues.

Viewing Your Notification History

1. Click your profile avatar → My Profile.
2. Select the Notification History tab.
3. You will see a chronological list of all notifications sent to your devices, including:
   • Timestamp of when the notification was sent.
   • Event type (e.g., Visitor Check-In, Emergency).
   • Delivery status (Delivered, Pending, Failed).
   • Device the notification was sent to (Browser, iOS, Android).
4. Use the date picker and event type filter to narrow results.

Admin Notification Log

Administrators can view the notification log for all users:

1. Navigate to Settings → Notifications → Notification Log.
2. Filter by user, event type, date range, or delivery status.
3. Click on any entry to view full details, including the notification payload and delivery receipt.
4. Use the Export button to download the log as a CSV file for auditing purposes.

Troubleshooting

If issues persist, contact your KyberAccess administrator or reach out to our support team at support@kyberaccess.com.