Notifications & Alerts

import { Aside } from “@astrojs/starlight/components”;

QUEUE POS provides real-time banner and sound alerts for incoming QR self-orders, delivery platform orders, scheduled bookings, and customer service requests. You can customize notification behavior individually for each device in your store.

Quick Summary

• Navigation path: Settings > Store > Notification Sound (Store-wide) / Top-bar Bell Icon (Device-specific)
• Supported platforms: iOS, Android, macOS, Web

---

1. Notification Channels

The system categorizes incoming notifications into five dedicated channels:

Notification Channel	Trigger Event	Banner Action
Self Orders (selfOrder)	Customer submits a dine-in QR code order from their smartphone.	Pinned banner with Go to order (navigates to Self Orders page).
External Orders (external)	Order arrives from delivery platforms (Uber Eats, Foodpanda, Web).	Pinned banner with platform logo and Go to order (navigates to External Orders).
Scheduled Orders (scheduled)	Future order due for preparation.	Pinned banner with scheduled badge and Go to order.
Call Staff (callStaff)	Customer taps “Call Staff” at their assigned table.	Banner showing table/section name and logs into notification center.
Customer Message (message)	Customer sends a special request or message from table ordering.	Banner showing table/section name and message content.

---

2. Device Notification Styles

Each POS terminal or tablet can independently configure how it receives alerts:

Notification Style	Banner Alert	Audio Tone	Recommended Device Usage
Toast & Sound	✅ Yes (Pinned)	✅ Yes	Kitchen display, main cashier, or primary order reception tablet.
Toast only	✅ Yes (Pinned)	❌ No	Quiet dining areas, customer-facing counters, or secondary terminals.
Off	❌ No	❌ No	Dedicated inventory tablets, office computers, or devices not handling live orders.

---

3. Persistent Banner Behavior

Incoming order banners remain **permanently displayed on screen** until a staff member acknowledges them by tapping **Go to order** or manually closing the banner. They do not auto-hide after 5 seconds, ensuring no rush-hour orders are missed.

Banner Actions:

• Go to order: Immediately opens the corresponding order queue and dismisses the banner.
• Close (✕): Dismisses the visual banner and stops any active alert chime.

---

4. Notification Sounds

Store managers can choose from 7 built-in notification chimes in Settings > Store:

• Default Alert (Standard chime)
• Alert
• Chime
• Ping
• Arcade
• Flow
• Space

To change the alert sound:

1. Navigate to Settings > Store.
2. Scroll to the Notification Sound dropdown.
3. Select your preferred chime and tap Save. All devices configured with Toast & Sound will immediately adopt the new tone.

---

Troubleshooting & FAQs

Issue	Cause	Solution
No banner or sound appears on new orders	Notification style is set to Off on this device, or system notifications are disabled in OS settings.	Tap the Notification icon on the top bar and select Toast & Sound. Also check iOS/Android/macOS system settings to allow notifications for QUEUE.
Banner appears but no sound is heard	1. Notification style is set to Toast only. 2. Device volume is muted or in Do Not Disturb mode. 3. Running on web browser before user interaction.	1. Change style to Toast & Sound. 2. Turn up device volume and disable silent mode. 3. Web browsers require an initial click on the page to enable audio playback.
Banner disappears too quickly	Older app versions had a 5-second auto-dismiss timer.	Upgrade to the latest QUEUE POS release (version 4.5.1+), where order banners are sticky by default.