Platform

Notifications

How real-time notifications work in HUMA and how to configure your preferences.

Overview

HUMA delivers real-time in-app notifications via WebSocket push — so you know the moment an interview ends, a report is ready, or a candidate joins.

Notifications are per-user and per-workspace. Each member controls exactly which events they receive.

Notification Types

| Event | Description | |---|---| | AI Call Completed | A candidate has finished their AI voice interview | | Report Ready | An AI evaluation report has been generated | | Panel Interview Started | A panel interview session has begun | | Panel Interview Ended | A panel interview session has closed | | Low Credit Balance | Your workspace credits are below the configured threshold | | Workspace Invitation | You've been invited to join a workspace | | Candidate Added | A new candidate has been added to your workspace | | Interview Invitation Sent | An interview invite has been sent to a candidate |

How It Works

Notifications are pushed via a WebSocket connection that HUMA maintains while you're logged in:

WebSocket URL: ws/notifications/<workspace_id>/

When you open HUMA, the client connects and subscribes to your workspace notification channel. New events arrive in real time without page refresh.

The unread count is tracked in the frontend store and displayed as a badge on the notification bell icon.

Configuring Notification Preferences

Each member can configure their own notification settings independently:

  1. Go to Profile → Notification Preferences
  2. Select your current workspace
  3. Toggle on/off any of the 8 notification types
  4. Changes take effect immediately

Email Notifications

In addition to in-app notifications, HUMA also sends email notifications for key events (e.g. report ready, low credits). Email notification preferences are configurable separately from in-app.

Viewing Notifications

Click the bell icon in the top navigation bar to open the notifications panel.

  • Unread notifications are highlighted
  • Click any notification to navigate directly to the relevant resource
  • Click Mark all as read to clear the badge

FAQ

Do notifications work on mobile? Yes. The WebSocket connection works in mobile browsers. Notifications appear in the HUMA interface if the tab is open.

Can I receive push notifications when the browser is closed? Browser push notifications are not currently supported. Notifications are delivered in-app and via email only.

Are notification preferences shared across workspaces? No. Notification preferences are configured separately for each workspace.