Settings
Access: Admin.
URL: /staff/settings
The Settings page controls workspace-wide configuration. Each section has its own Save button — saving one field does not affect others.
Agent Behavior
Section titled “Agent Behavior”System prompt override — a large textarea where you define how Stenbee behaves. This is the primary instruction set for the AI agent.
- Default: a built-in prompt tailored for e-commerce sales
- Override: write custom instructions (tone, greeting style, sales approach, do’s and don’ts)
- Format: free-text, supports natural language
- Save: click the Save button below the textarea
Example overrides:
- “Always greet the customer by name if available”
- “If the customer asks about pricing, ask for their project size first”
- “Never mention competitor products”
Agent Appearance
Section titled “Agent Appearance”Avatar URL — a text input for the agent’s avatar image URL.
- Paste a publicly accessible image URL
- A live preview circle (32px) appears next to the input, showing the current avatar
- If no URL is set, Stenbee uses a default letter avatar
The avatar appears in the chat widget and in message bubbles where Stenbee is the sender.
Widget Customization
Section titled “Widget Customization”Three fields control how the chat widget appears to customers:
| Field | Description |
|---|---|
| Widget Title | The heading text at the top of the chat widget (e.g., “Hi there! 👋“) |
| Agent Display Name | The name shown as the sender for AI messages (e.g., “Stenbee”, “ShopBot”) |
| Primary Color | The accent color for the widget — includes a color picker |
The primary color field shows:
- A text input for hex values (e.g.,
#FFC529) - A native color picker that updates the hex input
- The color is reflected in the widget preview
Notification Webhook
Section titled “Notification Webhook”Webhook URL — a text input for receiving event notifications from Stenbee.
- Enter a URL that accepts POST requests
- Stenbee sends notifications for events like new conversations, escalated sessions, and closed sessions
- Leave empty to disable webhook notifications
How settings are applied
Section titled “How settings are applied”Changes take effect immediately for new conversations. Ongoing conversations use the configuration that was active when they started.
Channels can override workspace-level settings. If a channel has custom widget settings (title, agent name, color, avatar, system prompt), those override the workspace defaults for conversations on that channel.
Check the channel’s Widget Settings section to see if any overrides are active. If no channel overrides exist, the workspace settings apply globally.
States
Section titled “States”| State | What you see |
|---|---|
| Loading | Form fields show gray placeholders; values appear when loaded |
| Save success | Green message: “Settings saved” |
| Save error | Red message with the specific error |
- Test system prompt changes on a test workspace before deploying to production
- The agent avatar URL must be publicly accessible — use a CDN or image hosting service
- The webhook URL should be an HTTPS endpoint
- Channel-level overrides take precedence — if settings don’t seem to apply, check if the channel has its own overrides configured