Skip to main content
The Settings page controls how your workspace behaves — from AI configuration to spam handling to data retention. This page covers every setting available.

​
Widget Toggle

The master switch for your chat widget. When disabled, the widget does not load on your site at all. Visitors will not see the chat bubble. Use this to temporarily take your widget offline without removing the embed code from your site. When you re-enable it, the widget starts working immediately.

​
AI Provider

Configure which AI model powers your chatbot.
  • Provider — Choose between OpenAI and Anthropic.
  • Model — Select a specific model from the chosen provider. Options vary by provider. See AI Provider Setup for model comparisons.
  • API Key — Enter your API key. Once saved, the key is masked for security. See Security & Privacy for how keys are stored.
  • Max Session Tokens — Set a cap on how many tokens a single conversation can use. This prevents runaway costs from unusually long conversations.
  • Test Connection — Click to verify your API key works and the model is reachable. A status indicator shows whether the connection succeeded.

​
Allowed Origins

A list of domains where your widget is allowed to run. The widget will only load on pages served from these origins. Enter origins separated by commas. Include the protocol: 
https://example.com, https://www.example.com, https://shop.example.com
This prevents your widget from being embedded on unauthorized sites. For local development, add http://localhost:5173 or whichever port you use.

​
Knowledge Base Thresholds

Fine-tune how your knowledge base search works.
  • Minimum Similarity Score — The lowest relevance score a knowledge base chunk must have to be considered for a response. Higher values mean stricter matching (fewer but more relevant results). Range: 0 to 1.
  • High Confidence Threshold — When a chunk scores above this threshold, the bot treats it as a highly confident match. Range: 0 to 1.
Leave these at their defaults unless you are seeing too many irrelevant responses (raise the minimum) or too many “I don’t know” answers (lower the minimum).

​
Response Cache

Toggle caching on or off. When enabled, ReplyBubble caches AI responses for similar questions. This means:
  • Faster responses — Cached answers are returned instantly without calling the AI.
  • Lower cost — Cached responses use zero tokens.
  • Consistent answers — Visitors asking the same question get the same response.
The cache is automatically invalidated when you update your knowledge base, so answers stay current.

​
Offline Mode

When offline mode is enabled and the AI provider is unavailable (API outage, rate limit, or expired key), the widget falls back to a decision tree of canned responses instead of showing an error.

​
Configuration

  • Enable/Disable — Toggle offline mode on or off.
  • Welcome Message — The first message visitors see when offline mode is active.
  • Contact Capture — Toggle whether the offline flow asks visitors for their contact information.
  • Contact Prompt Text — Customize the message that asks for contact details.

​
Decision Tree Editor

Build a tree of questions and answers that guide visitors through common scenarios without AI.
  • Add response nodes with a question and up to several answer options
  • Each option can lead to another node (creating branches) or end with a final response
  • Maximum depth: 3 levels
  • Maximum nodes: 50 per workspace
The decision tree is useful for directing visitors to the right resource, collecting basic information, or providing quick answers to FAQs when AI is temporarily down.

​
Spam Detection

Control how ReplyBubble handles suspicious conversations.
ModeBehavior
ShadowSpam is detected and labeled, but conversations proceed normally. You can review flagged conversations in the dashboard.
BlockSpam conversations are blocked. Blocked messages do not consume AI tokens.
Shadow mode is useful when you want to monitor spam patterns before actively blocking. Block mode is for workspaces that receive significant spam traffic. You can override individual spam classifications from the Contacts detail page.

​
Quotas

​
Data Retention

Set how many days conversation and analytics data is kept before automatic cleanup. After this period, old data is permanently deleted. The retention cleanup runs daily at 03:00 UTC.

​
Daily Token Quota

Set a daily spending cap for AI token usage. Once the quota is reached, the bot stops processing new messages for the rest of the day. This prevents unexpected costs from traffic spikes. The quota resets at midnight UTC.

​
Backup & Transfer

​
Export Settings

Download a complete JSON backup of your workspace settings. The export includes:
  • AI configuration
  • Appearance settings
  • Form definitions
  • Personality settings
  • Integration configuration
  • All other workspace-level settings
Use this to back up your configuration before making changes, or to transfer settings between workspaces.

​
Import Settings

Upload a previously exported JSON file to restore or apply settings. This overwrites the current workspace settings with the imported values.
Caution: Importing settings replaces your current configuration. Export your current settings first if you want a backup.