Customizing Your Agent
Style the chat bubble, set how your agent greets and answers customers, and give it your brand's voice
You can shape how your agent looks on your website and how it talks to customers. The look of the chat bubble lives on Channels → Chat bubble → Appearance; how your agent sounds and what extra guidance it follows live on Settings.
Chat bubble appearance
Open Channels → Chat bubble → Appearance to style the bubble next to a preview of the real widget. The preview shows your unsaved changes as you make them: switch between the Home, Chat and Help screens, the light and dark palettes, and a desktop or phone frame, and click the launcher to see the bubble closed with your proactive messages. Preview on your site shows it over your homepage. Messages typed in the preview aren't sent. Changes are saved when you press Save (or ⌘ S) and show on your site the next time a page loads. You don't need to change your install code.
Launcher
The launcher is the round button that opens the chat.
- Icon: chat, robot, info or the FutureBase logo
- Bubble color: the launcher's background colour
- Position: bottom left or bottom right of the page
Home screen
The first screen customers see when they open the chat.
- Background: animated, gradient or flat, with its own colours for light and dark mode (see Light and dark mode)
- Welcome message: a headline and a line under it
- Suggested questions: your most popular FAQs, a custom list you pick, or none
- Contact links: buttons for Telegram, WhatsApp, Messenger and Discord, optionally in each app's own colours
Conversation
- Initial greeting message: the first message your agent sends when a chat opens
- Assistant name: the name shown next to your agent's messages
- Input placeholder: the hint in the message box before the customer types
- Customer message color: the colour of the customer's own messages and the send button. The text on them turns white or dark, whichever reads better
- Fallback message: what your agent replies when your knowledge has no answer. Leave it empty to use the default
The greeting customers see when your agent hands them to a person is edited on Actions → Hand off to your team. See Hand off to your team.
Floating messages
Short messages that pop up above the launcher before the chat is opened, for example to point out a sale. Each one can show after a delay, hide after a while, and let customers dismiss it.
Help tab
Turn on the Help tab to list links to your help articles, guides or status page inside the chat.
Skip the home screen
Turn on Auto-start conversation to open customers straight into a chat instead of the home screen.
Light and dark mode
The chat opens in light mode unless your install snippet asks for something else. Add data-futurebase-theme to the script tag:
<script
src="https://embed.futurebase.io/widget.js"
data-wid="YOUR_WEBSITE_ID"
data-futurebase-theme="auto"
defer
></script>| Value | What customers see |
|---|---|
light (default) | Always the light chat and your light home colours |
dark | Always the dark chat and your dark home colours |
auto | Follows the customer's device setting, and switches while the chat is open if it changes |
If your site has its own theme switch, set the attribute to light or dark from your code when the theme changes; an open chat follows it. With the React package, pass theme="dark" to ChatBubble instead.
On Appearance, the Light / Dark switch above the home colours picks which palette you edit, and the preview shows that palette.
Tone of voice and custom instructions
Open Settings to set how your agent sounds everywhere it answers: the chat bubble, the shareable link and your messaging channels.
- Tone of voice: pick a preset such as friendly or professional. See Personality.
- Custom instructions: extra guidance your agent follows in its replies, such as policies to mention, words to use or avoid, and topics to handle in a certain way. Your agent still answers only from your knowledge.
Be specific. "Always mention our 30-day money-back guarantee when customers ask about refunds" works better than "Be helpful about refunds".
Branding
On Settings → General you set:
- Brand name: shown in the chat header (falls back to the agent name)
- Logo: shown in the chat header
The assistant name shown next to your agent's messages is set on Appearance.
Testing changes
- Make your changes on Appearance and save them.
- Switch the preview to Interactive and ask a few real questions, including ones your agent might struggle with.
- Open your website to check the bubble in place. Try
data-futurebase-theme="dark"if you support dark mode.
Tone of voice and custom instructions apply to new replies straight away. Messages already sent in a conversation stay as they were.
Best practices
- Start simple: begin with the defaults and adjust based on real conversations.
- Review regularly: read conversations each week to spot questions your agent can't answer yet.
- Match your site: use your brand colour for the launcher and pick a customer message colour that fits it.
- Test every channel: if customers reach you through several channels, ask a question in each.