Mailbox Management

Inspect mailbox activity and message content without modifying Genesys Cloud.

Genesys Connection Status

Loading

Checking saved configuration.

Active Region

-

Derived from the active profile or bootstrap defaults.

API Base URL

-

The read-only Genesys API base URL currently in use.

Settings Source

-

Database settings override environment bootstrap values.

Read-Only Mode

Application
-
GENESYS_EMAILS_READONLY
-
Write-back
Disabled
Last Successful Test
-

Current Profile Summary

Profile Name
-
Public Base URL
-
Tenant Id
-
Auth Type
-

Implemented In This Build

  • Encrypted local storage for Genesys client secret using AES-256-GCM.
  • Environment bootstrap fallback with database override precedence.
  • Admin API routes for settings, status, security, and connection tests.
  • Read-only enforcement in the UI, backend routes, and Genesys wrapper.
  • Traefik HTTPS routing on the existing proxy network.
  • Read-only domain, email address, mailbox, and email content viewers.

Live Snapshot

Client Secret State
-
Encryption Key Configured
-
Viewer Availability
-
Route Guard
POST/PUT/PATCH/DELETE blocked

Domains Inspector

Select a domain, then inspect the configured email addresses and route details. These panels are read-only and do not modify Genesys Cloud.

Domains

Configured inbound email domains.

No domain data loaded.

Email Addresses

Select a domain to load its configured addresses.

No domain selected.

Email Configuration

Select an email address to inspect its settings.

Email Settings

Route details
No email address selected.

Spam Email Options

Read-only
No email address selected.

Work Sources

Select a queue or mailbox source to load email activity.

Emails

Shows active or waiting emails currently in Genesys.

Select a mailbox to load recent emails from the last 31 days.

No mailbox selected.
No email selected.

Connection Settings

This form mirrors the NQX AI Studio Genesys MCP settings model with standalone local storage for GEM.

Saved secrets are never returned to the browser. Leave Client Secret blank to keep the current encrypted value.

Current Settings State

Connection Test

Runs a read-only authentication and permissions check. No Genesys Cloud configuration is modified.

No test has been run yet.

Logs

Audit trail for GEM actions, including triage actions, connection settings changes, and write-back enforcement changes.

Timestamp User Category Action Summary Result Details
Loading logs...

Security / Secret Storage

Spam Management

Select a division to load the mapped SPAM table.

Select a division to load the associated SPAM table.
i
If a user has multiple GEM roles, the most restrictive role applies: APP_GEM_AGENT -> APP_GEM_SUPERVISOR -> APP_GEM_ADMIN
Loading Access Control matrix...

Email Routing Mapping

Map each source queue to controlled Review Queue and SPAM handling targets.

Genesys Write-Back

Controls whether GEM can write back to Genesys Cloud.

Logs & Debug

Controls debug capture behavior and manages the persisted debug file used for Genesys action diagnostics.

Mailbox Handling

Controls how often the selected Current Emails mailbox is checked for new or changed emails while this browser session is open.

Default is 1 minute. The browser refreshes the selected Current Emails mailbox at this interval.

Configuration Backup / Import / Export

Export and restore GEM application configuration without including live email data, tokens, or secrets.

Export

Choose which configuration sections to export.

Import

Upload or paste a configuration JSON file, validate it, then apply the import.

Import Validation Result

Review schema, source metadata, warnings, errors, and the planned create/update/skip actions before applying an import.

Help

Administrator reference for GEM features, mappings, role gates, and Genesys Cloud permission dependencies.

Genesys Tenant Switch

Emergency controls for the active Genesys tenant connection.

Current Enforcement