Customize Your AI Chatbot
Configure the widget appearance, behavior, and AI settings
Widget Colors
Customize the color scheme of your chat widget to match your brand. All colors can be configured in the Widget Settings.
| Color Setting | Description | Default |
|---|---|---|
| Button Color | The main chat widget trigger button and send button color | #6366f1 |
| Header Background | The background color of the chat header and input area | #f8fafc |
| Text Color | Primary text color for headers and bot messages | #1f2937 |
| User Messages | Background color of messages sent by the visitor | #6366f1 |
| Bot Messages | Background color of AI assistant responses | #e5e7eb |
| Chat Background | Background color of the main chat message area | #ffffff |
Tip: Each color has a reset button to restore the default value. Use complementary colors for user and bot messages to make conversations easy to follow.
AI Assistant Name
Customize the name displayed in the chat header. This is what visitors see as the AI assistant's identity. Examples:
- AI Assistant (default)
- Customer Support
- Sales Assistant
- Your company name or mascot
Initial Message
The greeting message visitors see when they first open the chat widget. This message sets the tone for the conversation and encourages engagement. Maximum 200 characters.
Example: "Hello! 👋 How can I help you today? Feel free to ask me anything about our products or services."
Widget Position
Control where the chat widget appears on your website:
| Position | Description |
|---|---|
| Bottom Right | Standard position, bottom right corner (recommended) |
| Bottom Left | Bottom left corner of the screen |
| Custom | Fine-tune with custom X and Y offsets (in pixels) |
With Custom positioning, you can set:
- Side: Right or Left
- X Offset: Horizontal distance from the edge (0-200px)
- Y Offset: Vertical distance from the bottom (0-400px)
Auto-Trigger
Automatically engage visitors by opening the chat after they've been on your page for a set time. This proactive approach can significantly increase conversation rates.
Settings:
- Enable/Disable: Toggle the auto-trigger feature on or off
- Delay: Time in seconds before triggering (1-60 seconds)
- Display Mode:
- Full Chat + Bubble: Opens full chat on desktop, shows notification bubble on mobile
- Bubble Only: Shows notification bubble on both desktop and mobile (less intrusive)
Tip: Start with a 5-10 second delay and the "Bubble Only" mode for a less intrusive experience. Monitor engagement rates to optimize.
Notification Bubble
Display a floating message bubble next to the chat widget button to grab visitor attention and encourage engagement.
Settings:
- Enable/Disable: Toggle the notification bubble
- Bubble Message: Custom text displayed in the bubble (max 100 characters)
Examples: "Ask anything!", "Need help?", "Chat with us!", "Got questions? 👋"
Unread Badge
Show a red notification badge on the chat button indicating unread messages. This visual cue draws attention to the widget and improves engagement rates by suggesting the visitor has a pending message.
Instruction Mode
Control how the AI assistant responds to conversations:
| Mode | Description | Best For |
|---|---|---|
| Business Focused | AI stays on topic and focuses on your business, products, and services. Redirects off-topic conversations back to business matters. | Ideal for businesses, e-commerce, SaaS |
| General Conversations | AI handles broader conversations without strict topic restrictions. More flexible and conversational. | Education, community sites, blogs |
Ask Questions
When enabled, the AI will ask relevant follow-up questions at the end of its messages. This helps:
- Better understand the visitor's needs
- Keep the conversation flowing naturally
- Gather useful information for support
- Increase engagement and conversation depth
Use Emoji
When enabled, the AI will include friendly emojis in its responses to make conversations feel more warm and approachable. Disable for a more professional, formal tone.
Collect Emails
When enabled, an optional email input field appears above the chat input. The email is saved when the visitor sends their first message. Collected emails appear on your Leads page where you can view and export them.
Collect Phone Numbers
When enabled, an optional phone input field with international country code selector appears above the chat input. The phone number is saved when the visitor sends their first message. Phone numbers are saved to your Leads page alongside emails.
Note: Both fields are optional - visitors can dismiss them with the X button. If both options are enabled, the fields appear stacked above each other. If localization is enabled, the prompts are automatically translated.
Localization
Automatically translate your widget interface to match your visitor's browser language. Supports 32 languages including:
What Gets Translated:
- AI Assistant Name: The name shown in the chat header
- Initial Message: The greeting message when chat opens
- Notification Bubble Message: The text in the attention-grabbing bubble
Features:
- Auto-detection: Widget automatically detects visitor's browser language
- Edit Translations: View and customize translations for each language
- Regenerate: Re-generate all translations with one click
Tip: Localization significantly improves engagement rates for international audiences. The AI will also respond in the visitor's detected language.
Hide Branding
Remove the "Powered by Asyntai" text from the bottom of the chat widget for a completely white-label experience. This is ideal for agencies and businesses that want seamless brand integration.
Privacy Link
Display a link to your privacy policy in the chat widget footer, right next to the "Powered by Asyntai" branding. This helps you comply with privacy regulations and builds trust with your visitors.
Settings:
- Enable/Disable: Toggle the privacy link on or off
- Link URL: The URL to your privacy policy page (e.g., https://yoursite.com/privacy)
- Link Text: Customize the text displayed (default: "Privacy Policy", max 20 characters). You can translate this to any language.
How It Appears:
Note: If you have "Hide Branding" enabled (Pro plan), only the privacy link will appear in the footer. If both are disabled, the footer is hidden completely.
Custom Notice
Display a custom notice above the chat input field. This is perfect for disclaimers, consent notices, or important information you want visitors to see before chatting.
Features:
- Custom Text: Write any message up to 500 characters
- Markdown Links: Support for clickable links using markdown syntax:
[Link Text](https://url.com) - Dismissible: Visitors can close the notice with the X button (remembers their preference)
- Resets on New Session: Notice reappears when a new chat session starts
Example Uses:
- "AI responses may not always be accurate. Please verify important information."
- "By using this chat, you agree to our [Privacy Policy](https://yoursite.com/privacy) and [Terms](https://yoursite.com/terms)."
How It Appears:
Tip: Use markdown links to include clickable privacy policies or terms of service. Example: [Privacy Policy](https://yoursite.com/privacy)
Transcript Download
Allow visitors to download their chat conversation as a .txt file. When enabled, a "Download Transcript" option appears in the three-dot menu in the chat header.
How It Works:
- Visitors click the three-dot menu icon in the chat header
- Select "Download Transcript" to save the conversation
- The file includes all messages with timestamps and sender labels
New Conversation Button
Allow visitors to start a fresh conversation from the chat menu. When enabled, a "New Conversation" option appears in the three-dot menu in the chat header.
How It Works:
- Visitors click the three-dot menu icon in the chat header
- Select "New Conversation" to clear the current chat
- A new session ID is generated and the greeting message is displayed
- Email, phone, and custom notice inputs are reset for the new session
Conversation History
Allow visitors to browse and restore past conversations from the chat menu. When enabled, a "Conversation History" option appears in the three-dot menu alongside "New Conversation".
How It Works:
- When a visitor clicks "New Conversation", the current chat is automatically archived to their browser's local storage
- Visitors can click "Conversation History" in the menu to see a list of past conversations
- Each entry shows a preview of the first message, relative time, and message count
- Clicking a conversation restores it (the current chat is archived first so nothing is lost)
- Up to 20 past conversations are stored per widget
Note: Enabling Conversation History automatically enables New Conversation Button, since conversations are archived when visitors start a new conversation. Disabling New Conversation will also disable Conversation History.
Tip: Conversation history is stored in the visitor's browser (localStorage). If they clear their browser data, the history will be lost. Conversations with no user messages (only the greeting) are not archived.
Tagline & Status Dot
Control the tagline and status dot displayed in the chat widget header. By default, the text "Online" is shown in green below the AI name, and a green pulsing dot is displayed next to the AI name.
Status Dot:
- Toggle On/Off: Show or hide the green pulsing status dot next to the AI name
- Default: Enabled — the dot is visible by default to indicate the chatbot is available
Tagline:
- Toggle On/Off: Show or hide the tagline below the AI name
- Custom Text: Replace the default "Online" text with custom tagline text up to 30 characters (e.g., "Available 24/7", "Here to help")
- Smart Coloring: The default "Online" text displays in green. Custom tagline text automatically uses the same color as your AI name for a cohesive look
Note: The status dot and tagline are independent settings — you can enable either, both, or neither.
Speech to Text
Enable voice input in your chat widget so visitors can speak their messages instead of typing. Audio is transcribed using AI and placed directly into the chat input field.
How It Works:
- Microphone Button: A mic icon appears in the chat input area when enabled
- Recording: Clicking the mic button starts recording with a visual wave animation and timer
- Transcription: Speech is automatically converted to text using AI
- Auto-Stop: Recording automatically stops after 60 seconds
- Cancel: Discard the recording at any time without sending
After Transcription:
Choose what happens after the voice message is transcribed:
- Show in input field (default): The transcribed text appears in the chat input, letting the visitor review or edit before sending
- Send automatically: The transcribed message is sent immediately without requiring the visitor to press the send button
You can configure this under the "After transcription" dropdown in the Speech to Text settings.
Note: The visitor's browser will request microphone permission on first use. Voice input will not work if permission is not granted.
Chat Icon
Upload a custom image to replace the default chat widget button icon. Your image will be cropped to a square and displayed as the floating chat button that visitors click to open the chat.
Features:
- Custom Branding: Use your company logo or a custom icon that matches your brand
- Image Cropper: Built-in cropper lets you select exactly which part of your image to use
- Supported Formats: PNG, JPG, GIF, and WebP
- Easy Removal: Remove your custom icon anytime to restore the default chat bubble
Tip: For best results, use a square image with a simple design that's recognizable at small sizes (70x70 pixels).
Profile Picture
Upload a profile picture that appears in the chat header next to the AI assistant's name. This gives your chat a more personalized, human-like appearance.
How It Appears:
When set, a circular profile image displays in the chat header in this order:
- Online Status Dot: Green pulsing indicator
- Profile Picture: Your uploaded circular image
- Assistant Name: The AI name, status dot, and "Online" tagline
Use Cases:
- Add a friendly avatar to represent your AI assistant
- Use your brand mascot or logo
- Show a team member's photo for a personal touch
Tip: Use a clear, high-quality image with a face or recognizable icon. The image will be cropped to a circle and displayed at 40x40 pixels.
Conversation Starters
Add clickable prompt suggestions that appear above the input field in the chat widget. Visitors can click these instead of typing to quickly start a conversation. Starters only appear when the chat is empty and disappear after the first message is sent.
How It Works:
- Toggle ON/OFF: Enable or disable conversation starters from the Customize page
- Up to 4 Prompts: Add up to 4 short text prompts (max 100 characters each) via the "Edit Starters" button
- Clickable Chips: Starters appear as pill-shaped buttons directly above the input field
- Auto-Send: Clicking a starter sends the text as a user message, just as if they typed it
- Only on Empty Chat: Starters are only visible when the conversation is fresh — they won't appear if there are existing messages (e.g. after a page reload with chat history)
- Dynamic Hover: Chip hover color matches your widget button color
Use Cases:
- Guide visitors to common topics: "What are your prices?", "How do I get started?"
- Reduce friction for first-time visitors who don't know what to ask
- Highlight key services or features your AI assistant can help with
Tip: Keep your starters short and action-oriented. Questions work better than statements because they feel more natural to click.
Character Limit
Set the maximum number of characters a visitor can send in a single message. This helps prevent spam and keeps conversations focused.
How It Works:
- Default Limit: 750 characters per message
- Minimum Value: 500 characters
- Warning: A small red notice appears below the input field when a visitor exceeds the limit
- Auto-Shorten: Messages that exceed the limit are automatically shortened to the configured length before being sent
Recommendation: We recommend keeping the limit at 750 characters. Setting it too high may increase the risk of spam or misuse by allowing excessively long messages.
Temperature
Temperature controls how creative or focused your AI's responses are. It adjusts the randomness of the language model when generating replies.
How It Works:
- Range: 0.0 to 2.0
- Default: 0.7
- Lower values (0.0 - 0.5): More focused, consistent, and predictable responses. Best for factual Q&A, support, and technical queries.
- Medium values (0.5 - 1.0): A balanced mix of accuracy and creativity.
- Higher values (1.0 - 2.0): More varied, creative, and diverse responses. Best for brainstorming or conversational chatbots.
Tip: At 0, the answer to the same question will always be pretty much the same. At higher values, responses may vary more each time. Setting it to 2.0 is not recommended for businesses as it significantly increases the chance of hallucination and inaccurate answers.
Preview Your Widget
Before your changes go live, test how your chat widget will look and behave on different devices using the simulation buttons.
Tip: The preview simulations load the actual widget exactly as it would appear on your website, including your custom colors, messages, and auto-trigger settings.
Saving Changes
All customization changes are saved automatically as you make them. You'll see a confirmation message when settings are saved successfully. Changes take effect immediately on your website.