Operator guideENplayersinboxnotificationsmessaging

Players / Inbox

Inbox tab inside the player workspace for reviewing sent notifications, filtering by read state or notification type, and resending or deleting messages.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this tab shows

Players / Inbox is the message-history tab for one player. It lets operators review previously sent notifications and manage the player's inbox state without leaving the workspace.

When to use it

Use this tab when you need to:

  • confirm whether a player received a notification
  • review unread vs read inbox state
  • search sent messages by title or content
  • resend, mark as read, or delete inbox records

How to read it

The tab is built around a split view:

  • message list on the left
  • message preview on the right

On mobile, the FE switches between a list view and a preview view instead of keeping both panes visible at once.

Operators can narrow the list with read-state filters, notification-type filters, and a text search field. Search matches the message title and the rendered English content.

The preview pane shows:

  • title
  • sender identity (customFrom, admin creator name, or System)
  • notification type
  • priority
  • delivered timestamp
  • optional read timestamp
  • optional image/avatar
  • rendered message content

Known caveats

  • This tab shows inbox records and notification history. It is not the same thing as the Send To Inbox modal, which is the mutation flow for creating a new player message.
  • All, Unread, and Read filters change the inbox result set, while System, Personal, and Broadcast filters change the notification source type.
  • The FE loads this tab with includeDeleted=true, so soft-deleted rows can still be visible in history and show a Deleted badge in the sender line.
  • Delete and Bulk Delete are soft-delete operations on user_notifications.deleted_at, not hard removal from the notification tables.
  • Resend Message does not update the old inbox row. It creates a new notification through POST /api/admin/notifications with the selected message content and isResend=true.
  • The FE allows bulk delete and resend operations from the message list, but these actions should still be treated as notification-management operations, not chat support history.

Verification status

  • status: verified_backend
  • last verified: 2026-04-18
  • note: user-notification list, read/delete mutations, and resend creation flow are traced through the inbox hooks and notification controller/services.
Field dictionary

Fields

field

Sender

Sender line shown at the top of each inbox row and in the preview pane.

Data Type
string
field

Title

Subject shown in the message list and preview.

Data Type
string
field

Content

Message body rendered in the preview pane.

Data Type
rich_text
field

Notification Type

Source classification such as system, personal, or broadcast.

Data Type
enum
field

Priority

Visual urgency marker used for message badges.

Data Type
integer
field

Sender Image

Optional image/avatar shown next to the sender line and in the preview header when the notification carries artwork.

Data Type
image_url
field

Delivered At

Delivery timestamp for the player-facing inbox record.

Data Type
datetime
field

Read At

Read timestamp, when present.

Data Type
datetime
field

Deleted

Soft-delete timestamp. When present, the FE renders a `Deleted` badge in the sender row and still shows the message because the list is loaded with `includeDeleted=true`.

Data Type
datetime
field

Created By

Admin context behind the notification when available.

Data Type
string
field

Message Selection

Checkbox selection state used for bulk delete and list-level select-all behaviour.

Data Type
selection_state
Filter dictionary

Filters

field

Read State

Switches the inbox list between all, unread, and read messages.

Type
segmented
field

Notification Type

Limits the list to system, personal, or broadcast notifications.

Type
segmented
field

Search Messages

Matches message title and rendered English content in the inbox list.

Type
text
Operational notes

Notes

item

The inbox tab fetches `includeDeleted=true`, so soft-deleted rows can still appear in the visible history with a `Deleted` badge.

item

`Resend Message` uses `POST /api/admin/notifications` with `isResend=true` and the selected row's message payload. The current tab does not call `PUT /api/admin/notifications/:notificationId`.

Related references

Related pages

pagePlayers / Banking

Banking tab inside the player workspace with transaction filters, a paginated banking grid, analytics cards, CSV export, and automatic-withdrawal availability.

pagePlayers / Detail Workspace

Main player workbench at `/player/[playerId]` with tabbed sections, player-level actions, and modal-based operator workflows.

pagePlayers / Fraud Detection

Fraud-detection tab inside the player workspace with fraud risk assessment, related fraud reports, IP analysis, and identity-graph filtering.

pagePlayers / Game Report

Per-player game or provider report inside the player workspace, filtered by date option and grouped either by game or by provider.

pagePlayers / KPI Summary

Grouped player-level KPI snapshot inside the player workspace, covering player info, deposits, withdrawals, casino totals, bonus cost, and predictive metrics.

pagePlayers / KYC Status

KYC tab inside the player workspace for browsing user documents, checking third-party verification state, and approving, rejecting, or re-requesting documents.