1. System Overview
QueueSystem.my cloud portal — three interconnected components
QueueSystem.my is a cloud-based Queue Management System for businesses managing customer flow at physical locations. The platform has three portals — all working together in real-time.
Customer Queue Page
Public page — customers scan QR code, fill details, receive queue number. WhatsApp confirmation if enabled.
Admin Portal
Full management dashboard — settings, reports, queue control, KPI analytics, user management, audit logs.
Queue Display Screen
TV display showing currently-serving number with sound alert. Customers watch this to know when called.
WhatsApp QMS vs Cloud QMS: Both use the exact same admin portal. The only difference is notification method — WhatsApp QMS sends a WhatsApp message when customers are called. Cloud QMS shows the number on TV display only. All features, settings, and reports are identical.
2. User Roles & Permissions
2 permission levels — ADMIN and EMPLOYEE
Two role levels are available for your business — ADMIN for managers and EMPLOYEE for counter staff. Each role controls what the staff member can see and do in the portal.
| Feature | ADMIN | EMPLOYEE |
|---|---|---|
| Dashboard | Own company | Own company |
| Queue Control | ||
| Queue Type ON/OFF Toggle | ||
| Queue Types Settings | ||
| Company Settings | ||
| Queue Request History | ||
| WABA History & Charges | ||
| Queue KPI Dashboard | ||
| Admin User Management | ||
| Audit Log |
ADMIN is for managers and supervisors who need full access to settings, reports, and user management. EMPLOYEE is for counter staff who only need to call customers from Queue Control.
3. Logging In — Two-Factor Authentication
2-step secure login with email OTP
Open Admin Portal URL
Navigate to q.queuesystem.my/webportal in your browser. Desktop recommended.
Enter Username & Password
Type your assigned username and password in the login form.
Solve Math CAPTCHA
Solve the simple math question shown (e.g., "What is 4 + 7?") and type the answer. This prevents automated bot logins.
Check Email for OTP
A 6-digit One-Time Password is sent to all email addresses registered on your account. Check your inbox.
Enter OTP Within 20 Minutes
Type the OTP code in the verification page and click Verify. You are now logged in.
Session expires after 2 hours of inactivity. Closing the browser tab does NOT log you out — the session cookie persists. To log out, click the arrow (→) at the bottom of the sidebar.
4. Dashboard
Real-time queue overview — first screen after login
| Card / Widget | What It Shows |
|---|---|
| WABA Credit Balance | Current WhatsApp credit in MYR, today's usage amount and message count. Goes red when below MYR 5. |
| Queue Served Today | Customers fully served today with serve rate %. Green = healthy, red = low serve rate. |
| Total Queue Requests Today | Total tickets issued today vs yesterday with % change indicator (▲ up, ▼ down). |
| Live Queue Status | Real-time count of customers currently Waiting and being Served — auto-updates. |
| 7-Day Queue Trend Chart | Area chart showing daily queue volume for the past week. Identify busy days and growth trends. |
| Service Type Donut Chart | Today's split of requests per service type (Walk In vs Online etc.). |
| Queue Type Quick Control | Toggle switches to pause/open any queue type instantly without leaving the dashboard. |
5. Queue Control
The most important page — counter staff use this every day
Queue Control opens in a new tab. Keep it open all day alongside other tabs. It auto-refreshes every 12 seconds — you never need to manually reload.
How to Call a Customer — Step by Step
Select Your Counter Number
Choose your counter (e.g., "Counter 3") from the dropdown in the centre panel. You must select a counter before calling.
Filter by Service Type (Optional)
Click a service filter tab (e.g., "Walk In", "Online", "All") in the left column to narrow the queue list to the service you handle.
Click a Queue Item to Select
Click on a customer's entry in the Waiting Queue list on the left. It highlights blue when selected. You can select up to 10 at once.
Press the Action Button
Press NEXT to call, SKIP if absent, CUT for priority, or RECALL to re-call a served customer.
Action Buttons Reference
NEXT — Call Queue
Marks as served. Sends WhatsApp notification (WhatsApp QMS). Updates TV display screen. Shows green success banner.
SKIP This Queue
Marks as skipped (done) without calling. Use when customer has left or is unresponsive. Preserves counter stats.
CUT Queue (Priority)
Serves out of order for VIP or urgent cases. Same as NEXT but jumps the queue. Requires confirmation popup.
RECALL Customer
Re-calls a customer from the "Served Today" list. Select from right panel, press RECALL. New WhatsApp notification sent.
Status banners: Green = success · Amber = warning (e.g., no counter selected) · Red = error. Banners disappear automatically after 3.5 seconds.
Queue Type ON/OFF Toggle
The right column of Queue Control shows all queue types with ON/OFF toggles. Use this to instantly pause a service (e.g., stop accepting Walk In during lunch break) without affecting other services. Customers see the change immediately on the public queue request page. Green = OPEN, Red = PAUSED.
6. Settings
Queue type configuration and company settings
Queue Types Settings
Create and manage your service queue types — each represents a service category (Walk In, Online, Appointment, etc.).
| Field | Description |
|---|---|
| Description | Internal name for this queue type (e.g., "Walk In Registration") |
| Button Text | Short label shown to customers on the queue request page (e.g., "Walk In") |
| Prefix | Number prefix on tickets (e.g., "W" → W001, W002, or "1" → 100, 101) |
| Daily Limit | Max tickets per day. 0 = no limit. When reached, customers see the limit message. |
| Daily Limit Message | Custom message shown to customers when today's limit is reached |
| Queue ON/OFF | Instantly pause or open — same toggle as Dashboard and Queue Control |
| Hide from Public | If enabled, this queue type is not shown on the customer request page |
Company Settings
| Section | What You Can Configure |
|---|---|
| Basic Info | Company name, branch name, address, contact number, email, website URL |
| Queue Settings | Operating hours, max pax per ticket, WABA notification on/off |
| Customer Form Fields | Whether to collect IC/Passport, show Remark field, daily max requests, daily reset |
| Queue Closed Message | Custom message shown when all queues are paused or daily limit reached |
| WABA Settings | WhatsApp notification toggle, WABA balance top-up info (WhatsApp QMS only) |
| Appearance | Hide contact info, custom notes/announcements, Terms & Conditions URL |
Changes to operating hours take effect immediately. Customers trying to submit outside hours will see a closed message. Enable "Reset Queue Counter Daily" to restart ticket numbers from 001 each morning.
7. Reports & KPI Analytics
7-section performance dashboard + full queue history
7 KPI Sections
| Section | Key Metrics & Insights |
|---|---|
| 1. Headline KPIs | 8 stat tiles: Total Requests, Served, Avg Wait Time (green ≤10min · amber ≤20min · red >20min), No-show Rate, Avg Pax, Peak Hour, Busiest Day, WABA Cost per Customer |
| 2. Daily Trend Chart | Bar chart of requests vs served per day, with average wait time as a line overlay |
| 3. Peak Hour Analysis | Hourly traffic bar chart — know exactly when to schedule extra staff |
| 4. Day of Week Pattern | Which days are busiest — justify weekend/Monday staffing decisions |
| 5. Service Type Breakdown | Per-queue-type: requests, served, serve rate %, avg wait, total pax |
| 6. Counter Performance | 🥇🥈🥉 ranked table — avg wait, fastest, slowest, throughput bar per counter |
| 7. WABA Efficiency | Messages sent, delivery rate %, total cost, cost per served customer (WhatsApp QMS only) |
Queue Request History
Full log of every queue ticket issued. Filter by date range, customer name, phone, status (Served/Pending), or service type. Click Detail on any row for complete record including IP address. Export all matching records as CSV with one click.
8. Admin Users
Manage staff accounts, roles, and access
Add New Staff Account
Go to System → Admin Users → Add User. Set username, email, role (ADMIN or EMPLOYEE), and password. The new staff member uses this to log in. Assign ADMIN for managers, EMPLOYEE for counter staff.
Edit Username or Email
Click Edit on any user to change their username or email addresses. Multiple emails supported — OTP is sent to all. Use Reset Password to change their password.
Suspend a Staff Account
Use Suspend/Reactivate to disable login without deleting. Accounts cannot be deleted — only suspended. Audit history is always preserved.
Multi-Email OTP: An admin can have multiple email addresses (comma-separated). The 2FA OTP is sent to ALL registered emails simultaneously — useful for shared accounts where multiple team members need to receive the code.
9. Customer Queue Request Page
The public QR page customers access to join the queue
Customers access this page by scanning your QR code. No login, no app download required.
| Element | What Customer Sees |
|---|---|
| Service Type Buttons | One button per active queue type. Blue = open, Grey = paused, Amber = daily limit reached |
| Customer Form | Full Name (required), Number of Pax, WhatsApp Phone Number, IC/Passport (if enabled), Remark (if enabled) |
| Security CAPTCHA | Image CAPTCHA to prevent spam/bots. Click image to regenerate code. |
| After Submission | Large queue number badge shown. WhatsApp confirmation sent automatically (WhatsApp QMS only). |
10. Queue Display Screen
TV screen showing currently-serving number to waiting customers
Get the Display URL
In the admin portal sidebar, go to Dashboards → Queue Display. The URL contains your unique company UUID.
Open on TV or Monitor
Open the URL on any Smart TV browser, or connect a laptop/tablet to a TV via HDMI. No login required for the display page.
Bookmark for Daily Use
Bookmark the URL on the TV browser or set it as the home page so it opens automatically each morning.
| Feature | Details |
|---|---|
| Layout | 3-column layout — one column per queue type, large serving number in each |
| Sound Alert | Ding sound plays every time a new number is called by counter staff |
| Auto-Update | Live polling — updates the instant staff press NEXT, no manual refresh needed |
| Last 20 Served | Right column shows the last 20 queue numbers served across all types |
| YouTube Embed | Optional — display a promotional video in the background panel |
| No Login Needed | The display URL is public — no admin credentials required |
11. Security Features
Enterprise-grade protection at every layer
12. Troubleshooting
Quick solutions for common issues
| Problem | Solution |
|---|---|
| Queue list not loading in Queue Control | Check internet connection. Press Refresh button. If persists, reload the page and check if still logged in. |
| "Network error" on NEXT/SKIP action | Reload the Queue Control page. Check login status. The action may still have processed — check Served Today list. |
| Customer says WhatsApp notification not received | Check WABA History report for that customer's phone number. Check WABA credit balance on Dashboard — goes red if low. |
| Queue type showing as "Paused" to customers | Go to Dashboard → Queue Type Quick Control, or Queue Types settings page, and toggle it to ON/Open. |
| Cannot log in — wrong password | Use Forgot Password link, or ask your system administrator to reset your password via Admin Users page. |
| OTP not received in email | Check spam/junk folder. Ask your administrator to verify your registered email addresses in Admin Users. |
| Session keeps expiring too quickly | Sessions expire after 2 hours of inactivity. Keep the Queue Control tab active to prevent expiry. |
| WABA balance low / messages not sending | Check balance on Dashboard (shown in red if below MYR 5). Top up via your WABA provider (isms.com.my). |
| TV display screen not updating | Check that the display device is connected to the same network. Refresh the display page. Check if Queue Control actions are completing successfully. |
| Daily limit message showing to all customers | The queue type has reached today's daily limit setting. Either raise the limit in Queue Types settings or wait for the daily reset. |
13. Quick Reference — Daily Counter Workflow
Print this and keep it at your counter station