Skip to content

How to Create and Manage Bots

A bot is your AI chatbot — the thing your visitors talk to. Each bot has its own AI model, personality, knowledge sources, and settings. You can create multiple bots for different purposes (e.g., one for customer support, another for product docs).


  1. Go to Bots in the sidebar.
  2. Click “Create Bot”.
  3. The creation wizard walks you through six steps:
StepWhat you do
Name & DescriptionGive your bot a friendly name (e.g., “Support Bot”) and an optional description.
Knowledge SourcesChoose which sources your bot should know about, or leave it on “All sources” to use everything in your knowledge base.
AI ModelPick the language model that powers your bot. Each model shows a description to help you choose. See Choose and Switch AI Models for guidance.
BehaviorChatbotIQ detects the language of your content and suggests a base prompt (tone and style). Accept the suggestion or write your own. Configure suggested questions and citation settings.
SupportOptionally enable human handoff and/or a contact form. Configure trigger modes, agent labels, and notification emails. See Enable Human Handoff.
ReviewConfirm your choices and create the bot.
  1. Click Create and your bot is ready to test in the Playground.

All your bots appear in a table showing:

  • Name and description
  • Sources — how many knowledge sources are attached
  • AI model — which model powers the bot
  • Conversations — total conversation count
  • Status — Active (accepting messages) or Inactive (paused)
  • Created — when the bot was created

For each bot, you can:

  • Design & Deploy — open the Playground to customize the widget, test conversations, and get the embed code.
  • Edit — change the bot’s name, description, model, sources, or any other setting. Opens a quick-edit panel.
  • Delete — permanently remove the bot and all its conversation history. This can’t be undone.

Tip: You can also access bot settings directly from the Playground by clicking the gear icon (⚙) in the header.


Toggle the Active switch on a bot to control whether it accepts messages:

  • Active — the bot responds to questions through the widget and API.
  • Inactive — the widget won’t load and API calls are rejected. Useful when you’re making changes and don’t want visitors to see an incomplete bot.