Skip to main content
The Chat and Widget deployments are Noxus-hosted interfaces — they need no third-party credentials and ship with a built-in conversation UI.
  • Chat — an authenticated web chat available inside the Noxus platform (or at a deployment URL) for users in your workspace.
  • Widget — an embeddable chat widget you can drop onto any website, letting external visitors talk to the agent.
Both deployments share the same rendering layer, so the agent can send markdown, images, file attachments, buttons, and adaptive cards. They differ mainly in who can access them and in how they’re branded.
Both the Chat and the Widget include a built-in conversation history panel — users can pick up any of their previous conversations where they left off or start a brand-new one at any time.

Chat Deployment

Chat is the quickest way to put an agent in front of a user. No setup is needed beyond publishing the agent and choosing who is allowed to use it.
Chat interface

Deployment

FieldDescription
StatusToggle the deployment Online or Offline. A published version is required before going online.
VersionThe published agent version this deployment uses.
A published version is required before you can set a deployment to Online. Switch the deployment to Offline before editing its configuration.

Access

Control who in your workspace can open the chat.
FieldDescription
Custom InstructionsPer-deployment instructions appended to the agent’s system prompt (e.g. "Always respond in Spanish").
Allow all app users to use this appWhen enabled, every App user in the workspace can open the chat.
Allowed usersWhen the toggle above is off, pick a specific list of users who can access this deployment.

Branding

Override the default Noxus look and feel to match your brand.
FieldDescription
Use custom brandingMaster toggle — when off, the chat uses the default theme and the fields below are hidden.
Agent logoImage shown next to the agent name in the chat header.
Sidebar logoImage shown at the top of the sidebar. Falls back to your tenant logo when empty.
Main colorPrimary / accent color set. Pick from presets or provide a custom color.
Pick fairly light colors — chat text is rendered in black, so dark backgrounds make messages hard to read. When you edit the main color, the system automatically derives a matching accent color; you can override it afterwards if you’d prefer a different pairing.

Widget Deployment

The Widget is an embeddable chat that can live on any public website. It shares the agent’s configuration with the rest of the platform, but exposes a public front-end that anonymous visitors can use.
Widget chat and conversation history

Setting Up the Widget

1

Create a Widget deployment

On the agent’s Deployments page, create a new Widget deployment and publish a version.
2

Copy the embed snippet

Once the deployment is Online, Noxus generates an embed snippet you can paste into your website’s HTML.
Widget embed snippet
3

Paste the snippet on your site

Add the snippet to any page where the widget should appear. Visitors will see the chat bubble in the corner and can start a conversation without signing in.

Deployment

FieldDescription
StatusToggle the deployment Online or Offline.
VersionThe published agent version this deployment uses.

Widget content

Copy shown to visitors in the widget UI. Every field is optional — leave blank to use the defaults.
FieldDescription
Widget titleShown at the top of the widget panel.
Widget descriptionShort subtitle shown under the title.
Custom InstructionsPer-deployment instructions appended to the agent’s system prompt.
TitleTitle shown on the conversations history page.
SubtitleSubtitle shown on the conversations history page.
New conversation buttonLabel used for the “start a new conversation” CTA.
No conversations messagePlaceholder text shown when the visitor has no conversations yet.
Title logoOptional square image shown next to the widget title.
Show “Powered by Noxus” messageToggle the Noxus credit line in the widget footer.

Branding

FieldDescription
Use custom brandingMaster toggle for the branding fields below.
Bubble logoSVG code for the icon shown inside the chat bubble on your site. We recommend a 24×24px icon — the SVG is rendered with the theme’s colors and sizing.
Main colorPrimary / accent color set used throughout the widget. Pick from presets or provide a custom color.
Because the widget is public, keep Custom Instructions focused on behavior (tone, scope, fallback responses). Avoid putting secrets or internal URLs there — anything in the agent’s prompt can be surfaced to visitors through conversation.