Every visual choice for the chat widget lives on the agent's edit form under Support Agents (or on a knowledge base's own Chat settings, which edit the same agent). Changes take effect the next time a visitor loads a page. Create the agent first if you have not yet; see Set up the AI chat widget.
Colour and button icon
- Primary color tints the floating button and the widget's accent elements. Pick it to match your site; text on it switches between light and dark automatically for contrast.
- Button Icon is the glyph on the floating button. Choose from ten presets: Message Circle, Message Square, Headphones, Help Circle, Bot, Sparkles, Life Buoy, Helping Hand, Zap, and Star.
Avatar and assistant name
- Assistant Name is what visitors see at the top of the chat. Leave it blank and it defaults to your company name followed by "Assistant".
- Assistant Avatar is either a Preset icon (the same set as the button icons) or an Upload image. Uploaded avatars can be PNG, JPG, or WebP, up to 10 MB.
A named assistant with a real avatar reads like a member of your team rather than a generic bot, which is worth the two minutes.
Launcher options
| Option | Choices | Default | Notes |
|---|---|---|---|
| Theme Mode | Light, Dark, System | System | System follows the visitor's operating-system setting |
| Position | Bottom right, Bottom left, Top right, Top left | Bottom right | The chat panel opens from the same corner |
| Button Size | Small, Medium, Large | Medium | |
| Show floating button | On, Off | On | Off hides the launcher; open the chat from your own button with HelpBento.open() (see the install code) |
| Allow visitors to drag the button | On, Off | Off | The dragged spot is remembered in the visitor's browser. Desktop and tablet only; on phones and in mobile apps the button stays in its corner |
| Welcome Message | Free text | Empty | Shown when the chat opens, before the visitor types anything |
Hiding the floating button is the way to put chat behind your own "Help" link in a navigation bar or footer, so the page keeps one consistent design.