Customization Guide

Customize the appearance, behavior, and AI personality of your widget.

Appearance Settings

Configure in Dashboard → Widget → Appearance tab.

Setting	Type	Description
Primary Color	`hex`	Brand color for buttons and accents
Position	`bottom-right \| bottom-left`	Where the widget appears on screen
Theme	`light \| dark \| auto`	Color scheme (auto follows system)
Launcher Icon	`chat \| message \| help \| ai`	Icon shown on the launcher button
Greeting	`string`	Welcome message when chat opens
Placeholder	`string`	Input field placeholder text

Behavior Settings

Confidence Threshold

Controls when the AI refuses to answer due to low confidence.

Value	Behavior
`0.3`	Lenient - answers more questions, may be less accurate
`0.5`	Balanced - good default for most use cases
`0.7+`	Strict - only answers when highly confident

Refusal Message

Shown when the AI doesn't have enough information to answer.

I don't have enough information to answer this question accurately.
Would you like to contact our support team?

Allowed Domains

Restrict which domains can embed your widget. Leave empty to allow all domains.

example.com
app.example.com
*.example.com  // subdomains

AI Personality (Custom Prompt)

Define your AI's tone, expertise, and behavior with a custom system prompt.

Core Rules (Cannot Override)

Must cite sources using [Source N] format
Cannot make up information
Must admit when information is insufficient

Preset Templates

Friendly Support

You are a friendly and helpful customer support assistant.
Your goal is to make users feel welcome and supported.
Use a warm, conversational tone while remaining professional.
Break down complex topics into simple explanations.
Show empathy when users face issues and celebrate their successes.

Technical Expert

You are a technical expert assistant for developers.
Provide accurate, detailed technical answers with code examples when relevant.
Use proper technical terminology and assume familiarity with programming concepts.
Be concise but thorough - developers value precision over pleasantries.
When explaining concepts, include relevant context and edge cases.

Concise & Direct

You are a direct and efficient support assistant.
Provide brief, actionable answers without unnecessary elaboration.
Get straight to the point - users value their time.
Use bullet points and short sentences for clarity.
Only include essential information to answer the question.

BYOK (Bring Your Own Key)

Use your own API key for unlimited usage. Supports any OpenAI-compatible provider.

Supported Providers

OpenAI (GPT-4, GPT-3.5)
Anthropic (Claude 3)
OpenRouter (multiple models)
Any OpenAI-compatible API

Benefits of BYOK

Unlimited messages (no platform quota)
Choose your preferred model
Your API costs, your control
Keys are encrypted at rest

Multi-Language Support

The widget automatically detects the user's language and responds in the same language.

Supported Languages

Language detection works for most major languages including:

EnglishChineseJapaneseKoreanSpanishFrenchGermanPortugueseRussianArabic

Note: Your knowledge base content can be in any language. The AI will answer in the user's language regardless of the source content language.