Chatbots

Customize a chatbot

Change how a chatbot looks, where it sits, what language it uses and how many messages it accepts.

Open in ChatGPT Open in Claude

Open a chatbot from Chatbots to change its settings. The dialog has a basic section at the top and an advanced section below it. Save with Update Chatbot. Changes show up on pages that already embed the chatbot.

Basic settings#

  • Chatbot Name and Chatbot Description.
  • Chatbot enabled: switch the chatbot on or off.
  • Show title & description: show the title and description at the top of a new conversation, above the first message.
  • Used Agent: the agent that answers. You can point a chatbot at a different agent later.
  • Chatbot Style: Chat button, Embedded, Full page or Commerce search. See Create and embed.
  • Show close button: for the embedded style only.
  • Show session messages history: sets a cookie in the visitor’s browser so the chat stays open as they move between pages.

Window and layout#

Under URL & Window:

  • Chatbot window width: defaults to 540px. Use a CSS size such as 500px.
  • Chatbot window height: empty by default. Use a CSS size such as 80vh.

Under Window & Layout:

  • Chatbot theme: Auto, Light or Dark.
  • Chatbot position: Bottom right, Bottom left, Top left or Top right. It applies to the chat button style.
  • Text direction: Auto-detect, Left to Right (LTR) or Right to Left (RTL).
  • Chatbot language: English, Slovak, Dutch, Persian or Danish. The agent’s instructions, not this setting, decide which language it answers in.

Colors, bubble and input#

  • Primary color: the color of the visitor’s chat bubbles and the buttons in responses.
  • Sent message text color: the text color inside the visitor’s bubbles.
  • Chatbot bubble background color and Chatbot bubble icon color: the chat button.
  • Chatbot bubble size in px and Chatbot bubble custom image URL: resize the button or replace its icon with your own image. Use a valid image URL.
  • Message placeholder text: the hint in the empty input. The default is “Ask me any question…”.
  • Max input characters: the longest message a visitor can type. Leave it empty for no limit.

Branding and personalization#

  • Chatbot header text and Chatbot header logo URL: a name and logo shown in the chat window’s header.
  • Chat header logo URL: replaces the default picture above the title when Show title & description is on.
  • Assistant avatar image URL: the avatar next to the agent’s replies.
  • Remove FlowHunt branding hides the FlowHunt label. The switch is available only when your plan allows it. Removing branding needs the Pro plan plus a paid monthly add-on, and the dialog shows the price and a button to buy it.

Under Popup Messages, add short messages that appear next to the chat button to invite a visit. Type a message and click Insert message. Messages display delay sets the wait in milliseconds. Clicking a popup opens the chat.

Rate limiting#

Under Rate Limiting, protect your credits from heavy use:

  • Rate limit messages: the most messages per hour the whole chatbot accepts.
  • Rate limit messages from the same IP: the most messages per hour from one visitor address.
  • Custom message for Rate limit messages: what visitors see when a limit is hit. Without it they get a generic error.

A value of 0 means no limit.

Commerce search options#

For the Commerce search style, extra settings appear: AI Mode button text, Search bar placeholder, AI Mode button inside the search bar, colors for the search bar and the button, the corner radius from Square to Pill, and up to four AI Mode sample queries that a shopper can pick when AI Mode opens. Leave the sample queries empty to use the defaults.

Test before you save#

The Test your chatbot panel shows a live preview as you change colors and text, using the agent you selected. Pick an agent first, or the panel asks you to.

Widgets on the page

These settings apply to the chat window. To change what the agent says or knows, edit the agent and its knowledge sources.