How-To Guides
Step-by-step walkthroughs for the most common tasks in Q-Flow.
Table of Contents
For Citizens
- Take a Virtual Token
- Track Your Queue Position
- Defer Your Token (Postpone Your Turn)
- Verify a Lost Token by Phone
- Submit Feedback After Service
For Counter Staff
- Log In to the Staff Dashboard
- Call the Next Token
- Finalise a Token
- Mark a No-Show
- Transfer a Token to Another Counter
- Call a Deferred / Specific Token
Manager or admin? Manager/admin task walkthroughs live in the Admin How-To Guides, available inside your admin area at
/{org}/admin/docs(organisation admins) and/admin/docs(super admins).
For Citizens
1. Take a Virtual Token
- Go to the platform home page and click "Join Queue", or navigate directly to
/[org]/join. - Select your Office / Organisation from the dropdown.
- Select the Department you need to visit.
- (Optional) Enter your Name, Phone Number, and/or National ID.
- Entering a phone number enables SMS notifications when you are called.
- Read the document acknowledgment disclaimer and tick "I confirm I have all required documents."
- Click "Take Token" (or "टोकन लिनुहोस्" in Nepali).
- Your token number is shown on the confirmation screen. You will also receive an SMS if you provided a phone number.
- The page automatically redirects to your live token status page after 5 seconds (you can cancel the redirect to stay on the confirmation screen).
Tip: Use the 🌐 EN ↔ नेपाली language toggle in the top-right corner of the page to switch languages at any time.
2. Track Your Queue Position
After taking a token, your live status page is available at:
/{orgSlug}/token/{tokenId}
This page shows:
- Your token number with a colour-coded status badge.
- People ahead of you in the queue.
- Estimated Wait Time (EWT) — calculated as people ahead × average service time.
- The counter name, floor, and room when you are called to service.
- Step-by-step Pathfinder directions to navigate to your counter.
- Any active notice banners (holidays, closures).
- A real-time alert if your counter goes offline.
The page updates automatically — no manual refresh required.
3. Defer Your Token (Postpone Your Turn)
If you need to step away briefly while waiting:
- On your token status page, click the "Defer My Token" button (visible only when your status is
WAITING). - Confirm the action.
- Your status changes to
DEFERRED. You retain priority in the queue and will be called before new WAITING tokens when you return. - When you are back and ready, click "I'm Ready — Rejoin Queue" on the same page.
Note: You can only defer a token that is currently in WAITING status. Once called (SERVING), deferral is not available.
4. Verify a Lost Token by Phone
If you lose the link to your token status page:
- Go to
/[org]/joinand look for the "Find My Token" link, or navigate to/{orgSlug}/token/verify. - Enter the phone number you used when taking the token.
- Your active token will be displayed with a link to the live status page.
5. Submit Feedback After Service
Once your token reaches FINALISED status, the feedback survey appears automatically on your token status page:
- Emoji Micro-Survey: Tap one of the five emoji (😠 😕 😐 🙂 😍) to rate your experience (1–5).
- If you select 😠 (very poor), a secondary picker appears: Long Wait | Rude Staff | Complex Process.
- Suggestion Box (optional): Scroll down to find a text area where you can type a free-form suggestion (up to 1 000 characters).
- Click Submit.
You may also receive an SMS 15 minutes after finalisation inviting you to rate the service via a link.
For Counter Staff
6. Log In to the Staff Dashboard
Option A — Via the unified portal:
- Go to
/login(or click "👤 Staff / Admin Login" on the home page). - Click the 🏛️ Find My Org tab.
- Search for your organisation by name.
- Click your organisation's name — you are taken to
/{orgSlug}/login. - Enter your email and password, then click Login.
Option B — Direct org portal:
- Go directly to
/{orgSlug}/login(e.g.,/lalitpur-metro/login). - Enter your credentials and click Login.
After logging in, you are automatically redirected based on your role:
- STAFF →
/{orgSlug}/dashboard/staff(queue operations view) - MANAGER / ADMIN →
/{orgSlug}/dashboard/manager(org-wide metrics view)
7. Call the Next Token
- On the dashboard, ensure your Counter is shown (it is pre-assigned and read-only for STAFF).
- Click "Call Next" (or "अर्को बोलाउनुहोस्") in the top action bar.
- The system selects the highest-priority token (TRANSFERRED → RAINCHECK → WAITING order) and changes its status to
SERVING. - The token number is announced on the public display board and the citizen receives an SMS (if a phone number was provided).
8. Finalise a Token
- After serving the citizen, click "Finalise" (✅) next to the currently SERVING token.
- The token status changes to
FINALISED. - The citizen's feedback survey becomes available on their token status page.
- An SMS is sent to the citizen 15 minutes later inviting them to rate the service.
9. Mark a No-Show
If the citizen does not arrive within the expected time after being called:
- Click "No Show" (🚫) next to the SERVING token.
- The token enters a STANDBY grace period (15 minutes). A countdown timer is shown.
- If the citizen does not arrive within 15 minutes, the token is automatically moved to
NO_SHOW. - The citizen's token page shows a one-time Re-Queue option.
10. Transfer a Token to Another Counter
- In the queue list, find the SERVING (or WAITING) token you want to transfer.
- Click the Transfer icon (↔️) next to it.
- In the transfer dialog, select the destination department and counter.
- (Optional) Add a staff note for context (e.g., "Requires biometrics first").
- Click Confirm Transfer.
- The token disappears from your queue and appears in the destination department's queue as a TRANSFERRED token (given priority over regular WAITING tokens).
11. Call a Deferred / Specific Token
- In the queue list, find the DEFERRED token (marked with a 🔁 icon).
- Click ▶ Call Now next to it.
- The token moves to SERVING and the citizen is notified.
For role-specific details, see the Staff Guide. Manager and admin walkthroughs: Admin How-To Guides (inside the app at /{org}/admin/docs).