Skip to content

Getting Started — HUPH Dashboard Tour

Purpose

This page helps you log in to the HUPH dashboard for the first time and understand the 4 main areas in under 5 minutes. Intended for counselors, marketing staff, and admins newly joining the UPH admission team.

Prerequisites

  • HUPH account already provisioned in Zitadel by a super_admin
  • Access to https://admin.huph.val.id
  • A modern browser (Chrome, Firefox, Safari, or Edge, recent versions)
  • An assigned role (marketing_counselor, marketing_staff, marketing_admin, system_admin, or super_admin)

No account yet?

Contact your team's super_admin (typically admin@huph.uph.edu). They will create your Zitadel account + give you the first-login instructions. There is no self-signup flow.

Steps

1. Open the login page

Point your browser to https://admin.huph.val.id. You will see a login page with an SSO button:

Text Only
 ┌────────────────────────────────────┐
 │        HUPH Admin Dashboard        │
 │                                    │
 │       Sign in to continue          │
 │                                    │
 │       [ Continue with SSO ]        │
 │                                    │
 │   Powered by Zitadel SSO           │
 └────────────────────────────────────┘

2. Sign in via SSO

Click Continue with SSO. The browser redirects to the Zitadel login page (https://auth.huph.val.id). Enter your Zitadel email + password. If your team has enabled 2FA (MFA), you will also be asked for an additional code.

On success the browser redirects back to HUPH and you land on Dashboard (role-specific variant for counselors).

Session lasts 24 hours — you do not have to log in again every time you open a new tab.

3. Overview dashboard

After login you land on Dashboard showing today's summary:

Text Only
 ┌─────────────────────────────────────────────────┐
 │  Sidebar       │  Dashboard                      │
 │                │                                 │
 │  OVERVIEW      │   ┌─────────┐ ┌─────────┐      │
 │  CONVERSATIONS │   │ Convers.│ │ New     │      │
 │  LEAD PIPELINE │   │   42    │ │ leads 7 │      │
 │  KNOWLEDGE     │   └─────────┘ └─────────┘      │
 │  BOT CONFIG    │                                 │
 │  ADMIN         │                                 │
 │                │   ┌──────────────────────┐     │
 │                │   │ Pending escalations 3│     │
 │                │   └──────────────────────┘     │
 └────────────────┴─────────────────────────────────┘

4. Know the 6 sidebar groups

The sidebar is organized by daily workflow:

Group Items Audience
OVERVIEW Dashboard, Executive Summary, Analytics All users — daily + strategic metrics
CONVERSATIONS Agent Inbox, All Conversations, Leads All users — interactions with prospective students
LEAD PIPELINE Pipeline Board, Follow-up, Campaign Links Marketing + counselor — funnel management
KNOWLEDGE FAQ, Documents, Web Sources, Answer Eval Admin/faculty — chatbot content
BOT CONFIG Chatbot, Intents, Style Rules, Escalation Rules Admin — bot-behavior configuration
ADMIN Users, Faculty Clusters, System Health, Audit Log super_admin & system_admin — team + system mgmt

Role-based visibility

Counselors see only OVERVIEW, CONVERSATIONS, and LEAD PIPELINE + FAQ (read-only). BOT CONFIG and ADMIN are hidden. Executive Summary is restricted to super_admin, system_admin, marketing_admin, and faculty_admin.

5. Open Conversations

Click Agent Inbox in the sidebar to see conversations needing attention today. You can Take Over and reply directly here (full walkthrough at Inbox).

6. Log out when done

Click your avatar in the top-right → Logout. Always log out explicitly on shared machines (office kiosk, shared workstations).

Example scenarios

First-day counselor. Log in → check Dashboard → open Agent Inbox → read 3 new threads → reply to 1 → check Pipeline Board for your leads. Total ~15 minutes. Goal: get comfortable with the daily flow.

Marketing staff, Monday morning. Log in → Executive Summary (select 7 days) → scan KPI + funnel + alert panel → drill into Analytics for detail charts → screenshot for the weekly report to the head of admission.

Super admin weekly check. Log in → Dashboard → scroll to the Feature Coverage widget at the bottom → identify 0%-usage features → follow up with the team on why → update docs or run coaching.

Troubleshooting

"Continue with SSO" button does not respond. Symptom: click the button, no redirect, no loading indicator. Cause: JavaScript blocked by a browser extension (ad-blocker, privacy tool). Fix: hard-refresh with Ctrl+Shift+R, or whitelist admin.huph.val.id in the relevant extension.

"Unauthorized" after successful Zitadel login. Symptom: SSO succeeds but the dashboard shows an unauthorized error. Cause: your Zitadel account isn't mapped to admin_users yet — typical for a brand-new user on their first login. Fix: contact a super_admin; they need to verify your cluster_id and role metadata in the Zitadel app. One-time setup.

Session expires every 5 minutes. Symptom: you're asked to log in again shortly after logging in. Cause: cookies for admin.huph.val.id are blocked. Fix: allow cookies for that domain in your browser privacy settings.

Can't log in on Safari iOS. Symptom: redirect loop between admin and auth.huph.val.id. Cause: Safari's "Prevent Cross-Site Tracking" blocks the SSO cookie handshake. Fix: Settings → Safari → disable "Prevent Cross-Site Tracking" for the login session (you can re-enable it afterwards).

Sidebar doesn't render after login. Symptom: login succeeds but sidebar is empty/blank. Cause: your role has no feature permissions (usually an initial-setup bug). Fix: contact a super_admin to check admin_users.role in the database.

See also