Skip to main content

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 (default true). 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 (payload brief_send_hour; the endpoint still validates 0–20; model default 9).

  • Yesterday in numbers — what to include → knox.daily_brief.sections.*:

    Section keyLabelIncludes
    statsDaily statsVisitor and lead counts
    captured_leadsCaptured leadsNew form submissions
    hot_leadsHot leadsHigh-intent returning visitors
    identified_visitorsIdentified visitorsOther named visitors
    ask_noxSuggested questionsPrompts 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_warm and needs_attention are 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. Default auto.
  • Email signature → email_signature (rich HTML; appended at send by NoxGhlActionService._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_send still exists in the code.

Visitor alerts (org admins)​

Written under knox.visitor_watch:

ControlFieldOptions / rangeDefault in form
Identity confidence to alertmin_confidenceverified (only) or strong (match)verified
Auto-engage cooldown (hours)auto_engage_cooldown_hours0–1686
Quiet push outside business hoursquiet_push_outside_business_hourson/offon

The form initializes min_confidence to verified, while the CompanyModel schema default is strong. Accounts that never saved this screen use strong. 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:

CardPayload key(s)
Morning emaildaily_brief_enabled; brief_send_hour; brief_sections.{…}
Follow-ups (GHL only)channel_preference, autonomous_send (always false), ghl_contact_update_policy, email_signature
Visitor alertsvisitor_watch.{min_confidence, auto_engage_cooldown_hours, quiet_push_outside_business_hours}
Your assistantname / 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 name settings-nox, path /settings/assistant (alias /settings/nox), menu label from composables/useSettingsMenu.js.
  • Cards: frontend/src/components/nox/* and components/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 in nox_rapport (NoxRapportModel).
  • Funnel settings are a separate page — Settings → Nox Funnel (/settings/funnel); see Nox Funnel.