Settings — Nox
Audience: Management · Sales · Support · QA · Engineering · Where in app: Settings → {Nox} Assistant (/settings/assistant, alias /settings/nox; tabs Settings | Activity) · Plan availability: every company; company-level cards require the settings.organization permission
This screen controls how the Nox admin assistant behaves for the account. It mixes company-level cards (org-admin only) with personal ones available to everyone. Since the v3 launch (2026-11) the page is two columns: a right-hand aside with the business-email card, and the main column of settings cards. The Activity tab embeds Nox Activity (NoxActivityView with embedded); /activity and /nox-activity redirect to ?tab=activity (the PDF report stays at /activity/report). The tab needs Activity access (agency client permission pages.nox_activity) and is hidden while the agency has paused the account.
The assistant name is white-labeled — the page reads "{Nox} Assistant" using the resolved brand name. The assistant itself is documented under modules/nox and the v2 engine.
Cards
Several cards render only when the company is on the v2 engine (getKnoxV2Status(); every company in PROD): the business-email aside, check-ins, morning brief, and "How Nox works for you". The old "Nox isn't enabled yet" card (knox.enabled check) is gone.
Nox reads your business email (aside, org admins)
components/nox/NoxEmailCard.vue. Connect Gmail or Outlook (a Unipile account — the same backend as Sales Replies; POST /knox/sales-replies/reconnect-link) so Nox notices enquiries and replies. Before connecting it shows the fee — the admin unipile seat price, charged on connect and monthly while connected (7b92facf3; wallet lines nox_mailbox_connect / nox_mailbox_renewal; renewals by SalesRepliesMailboxFeeJob, which releases the mailbox and emails the owner when the wallet is short; reconnecting the same mailbox isn't re-charged). A consent tick box gates Connect Gmail or Outlook. Connected state: Connected / Needs attention (lost session, detected by NoxEmailHealthJob), monthly fee + next charge, Reconnect, Disconnect, then "What {Nox} did with your mail" (7 / 30 days). Bodies are encrypted at rest with NOX_EMAIL_KEY (backend + schedular secret).
Your assistant (org admins)
components/knox/NoxIdentityCard.vue + NoxIdentityForm.vue + NoxLookCustomizer.vue: Name (blank = "Nox"), Voice, Persona, Welcome message (placeholders {greeting}, {first_name}, {assistant}, {business}), Look (families Plush / Medical / Home services; Plush presets, colour, headwear/eyes/face/neck/lashes slots; default teal with specs and a moustache). Saved through PUT /company/:id/nox-settings. Agency clients see the agency's identity read-only and may only pick an outfit (Save outfit); the default outfit comes from industry_details.trade (noxIdentity.js TRADE_OUTFIT / outfitFor). Own characters (agency.nox_avatar ∈ chirpy | bee | nexus | chatsmart) are set by a super admin on the admin agency page, not here.
Morning email (org admins)
-
Morning email switch →
knox.daily_brief.enabled(defaulttrue). The email leads with today's plan, then yesterday's numbers — see Daily Brief. -
Send time (your timezone) →
knox.daily_brief.send_hour— UI options 5–10 am (payloadbrief_send_hour; the endpoint still validates 0–20; model default 9). -
Yesterday in numbers — what to include →
knox.daily_brief.sections.*:Section key Label Includes statsDaily stats Visitor and lead counts captured_leadsCaptured leads New form submissions hot_leadsHot leads High-intent returning visitors identified_visitorsIdentified visitors Other named visitors ask_noxSuggested questions Prompts you can ask next Funnel-enabled tenants also get
funnel_snapshot(Funnel snapshot),funnel_pace(Rates and pace),new_noteworthy,whats_working,booked_journeys,after_meeting,learning(What {Nox} is learning).funnel_priorities,very_warmandneeds_attentionare no longer offered; the payload only sends known keys, so their stored values are untouched.
Follow-ups (only when GHL is connected)
Renders only if GoHighLevel is connected (company.go_high_level.access_token).
- Follow-up channel →
knox.actions.channel_preference:auto(SMS then email),email,sms. Defaultauto. - Email signature →
email_signature(rich HTML; appended at send byNoxGhlActionService._send). - Update LeadConnector contacts with corrected identity →
knox.ghl_contact_update_policy:created_only(default — only contacts Nox auto-created from enrichment; pre-existing ones are conflict-flagged),all,off. - "Let Nox send follow-ups without approval" is retired (2026-11-01): the toggle is gone and every save writes
autonomous_send: false. A send receipt deep-link?highlight=nox_autonomous_sendstill exists in the code.
Visitor alerts (org admins)
Written under knox.visitor_watch:
| Control | Field | Options / range | Default in form |
|---|---|---|---|
| Identity confidence to alert | min_confidence | verified (only) or strong (match) | verified |
| Auto-engage cooldown (hours) | auto_engage_cooldown_hours | 0–168 | 6 |
| Quiet push outside business hours | quiet_push_outside_business_hours | on/off | on |
The form initializes
min_confidencetoverified, while theCompanyModelschema default isstrong. Accounts that never saved this screen usestrong. Note this when supporting "why did/didn't an alert fire."
How Nox talks to you (per user)
components/nox/NoxTalkStyleCard.vue → backend GET/POST /knox/style (nox_rapport.style): Call me (call_me; blank = first name), How you like {Nox} to talk (short talk rules; Nox's nox_style_set tool writes the same list), and Answer {Nox}'s greetings by voice → style.greet_listen (default false): when on, a greeting Nox starts by itself listens without a tap.
When Nox speaks up by itself (wake mode)
components/nox/NoxWakeVoiceCard.vue, composables/noxWakeMode.js. Options Wake up quietly (default) / Wake up and talk / Don't wake up (+ Your agency's choice for managed clients) → company knox.wake_voice (quiet | speak | off). Resolved against agency.nox_wake_voice (default quiet) and agency.nox_wake_voice_locked by noxIdentity.js resolveNoxWakeVoice; a locked agency makes the company save return 403 and the card reads "Your agency has set this to … for every account." Read via GET /company/:_id/nox-wake-voice; ms-ai writes through POST /internal/knox/wake-voice (nox_wake_voice_set tool). Quiet became the default in 8540d0caa / c9b8f1570 (9 Nov). Agencies set theirs in Agency settings → AI Assistant ("Speaking up by itself": Quietly, a note / Out loud / Never, + "Clients can't change it").
What Nox remembers (per user)
getNoxMemories() / deleteNoxMemory(id) (ms-ai GET/DELETE /knox-agent/memories), paginated with Load more; Forget this per row.
When Nox checks in (org admins, v2)
components/nox/NoxCheckInsCard.vue → ms-ai GET/POST /knox-v2/schedules (nox_schedule). Let {Nox} check in with me turns off both the morning plan + greeting and event check-ins. Weekly review on Mondays at sets the weekly_review time. There is no morning time to pick any more — the hunt runs at 05:30 local (v2 engine).
Morning brief (v2)
components/nox/NoxMorningBriefCard.vue: Run my morning brief now → ms-ai POST /knox-v2/day/redo → backend POST /internal/knox/day/reset (NoxDayPlanController): a fresh plan and the greeting as if the admin just arrived ("Done — {Nox} is greeting you now (bottom right).").
How Nox works for you (v2)
components/nox/NoxWorksForYou.vue → ms-ai knox-v2 endpoints: rules (GET/POST /rules, rules/:id/approve|enabled|edit, DELETE rules/:id; nox_rule) — "Your rules, in your words", with use/override counts, Pause/Resume, retire, and learned rules pending confirmation; Limits the system enforces (nox_guard_rules, Switch off → DELETE /limits/:id); What {Nox} is following (nox_case, drop/reopen); Your goals (nox_goal, close); What {Nox} raised (nox_standup_item).
Watched visitors (per user)
GET/DELETE /knox/visitor-watches (NoxActionUserController); Stop watching per row; empty state "No active watches."
Removed in the v3 launch
- My preferences → Auto-play daily brief (
noxSettings.autoPlayBrief, localStorage) — gone; the brief-ready badge shows once a day and is played on demand. - Let {Nox} send follow-ups without approval — retired (above).
- "Waiting for you" briefly lived here (
17d53333); it now lives in the Nox panel's Inbox (components/nox/NoxWaitingList.vue).
Save endpoint
PUT /company/<id>/nox-settings (dot-path $set, never clobbers the rest of knox) carries the company cards and the identity card:
| Card | Payload key(s) |
|---|---|
| Morning email | daily_brief_enabled; brief_send_hour; brief_sections.{…} |
| Follow-ups (GHL only) | channel_preference, autonomous_send (always false), ghl_contact_update_policy, email_signature |
| Visitor alerts | visitor_watch.{min_confidence, auto_engage_cooldown_hours, quiet_push_outside_business_hours} |
| Your assistant | name / voice / persona / welcome message / look (outfit only for agency clients) |
Per-user and v2 cards save through their own endpoints (above).
Behaviors & edge cases
- Non-org-admins see only the per-user cards (talk style, wake mode, memories, watches, morning brief, works-for-you); the company form and Save button are hidden.
- No GHL: the Follow-ups card is hidden.
- Unsaved-changes guard: leaving with a dirty company form prompts to save. Switching to the Activity tab keeps the form (
v-show). - The identity card has its own save bar ("You have unsaved changes" / Discard / Save changes).
Technical implementation
- View:
frontend/src/views/settings/nox/Index.vue(vee-validate + zod); route namesettings-nox, path/settings/assistant(alias/settings/nox), menu label fromcomposables/useSettingsMenu.js. - Cards:
frontend/src/components/nox/*andcomponents/knox/NoxIdentity*.vue. - Company model:
backend/app/models/CompanyModel.js→knox.daily_brief,knox.actions,knox.visitor_watch,knox.ghl_contact_update_policy,knox.wake_voice; per-user style innox_rapport(NoxRapportModel). - Funnel settings are a separate page — Settings → Nox Funnel (
/settings/funnel); see Nox Funnel.
Related
- What is Nox · v2 engine · Nox Daily Brief · Nox Voice · Nox Tools
- subsystems/nox-assistant
- Integrations — GoHighLevel — required for the Follow-ups card and the contact-update policy.
- subsystems/identity-graph — the confidence levels (
verified/strong) behind visitor alerts.