Chatbot

The chatbot answers your visitors’ questions on your site, at any time of day. It sits behind a launcher button in a corner of every page, or wherever you place it, and writes its answers with the AI model you connect. Your instructions tell it who it speaks for, how it speaks and what it never says.

Set it up

  1. Connect an AI provider on Connections, for example OpenAI with your API key. See AI environments.
  2. Go to Chatbot → Behaviour. In the Model card, choose the AI environment and the Model that write the answers. See AI models.
  3. In the Instructions card, write the Instructions: who the chatbot works for, what it helps with, its tone, and what it must not do. New sites start with instructions you can adapt.
  4. Turn on Add the current date if visitors ask about dates, events or deadlines.
  5. Select Save changes.
  6. Go to Chatbot → Appearance. In the Launcher card, Show on every page is on: the chatbot shows on every page of your site. Turn it off to show the chatbot only where you place the AI chat block or the [kimaai_chatbot] shortcode.
  7. Open your site and ask the chatbot a question.
The Instructions card on Chatbot → Behaviour
  1. Instructions are what the chatbot follows in every conversation.
  2. Add the current date gives the chatbot today’s date with every question.

Visitors open the chat from the launcher and ask their question:

A question and its answer in the open chatbot on the demo site
  1. The chatbot’s name and the line under it, as set on Chatbot → Appearance.
  2. The visitor’s question.
  3. The chatbot’s answer.
  4. The message field, where visitors write.

Settings

Instructions

SettingWhat it does
InstructionsWhat the chatbot follows in every conversation: its role, its tone and its rules. Placeholders in curly brackets are replaced with live values (see “How it works”).
Add the current dateAdds a line with today’s date to the instructions, so the chatbot answers questions about events, deadlines or “this year” correctly.

The other settings of the Instructions card belong to Content awareness and Guardrails.

How it works

The instructions can hold placeholders in curly brackets, which the chatbot fills in for every question:

PlaceholderReplaced with
{post_url}The address of the page the visitor is on, when content awareness is on. Without any of the page placeholders, the page is added at the end of the instructions (Content awareness).
{post_title}The title of that page.
{post_content}The text of that page.
{post_section}The part of that page the visitor is reading.
{current_date}Today’s date, in your site’s time zone. The date goes where you put it, whether Add the current date is on or not.
{glossary}Your glossary terms and banned terms. Without the placeholder they are added at the end of the instructions (Glossary).
  • Add the current date adds the date at the end of the instructions, for example “Current date: Thursday, November 19, 2026 (2026-11-19).”, unless the instructions use {current_date}.
  • With Show on every page on, the chatbot shows on every page of the site. With it off, it shows only on pages with the AI chat block (Inline chat) or the [kimaai_chatbot] shortcode. The shortcode works in posts and pages, and also in widgets and templates.
  • [kimaai_chatbot] shows the floating chatbot on its page, and nothing when Show on every page is on already. Its attribute greeting sets a welcome text for this chat instead of the one on Chatbot → Appearance: [kimaai_chatbot greeting="Ask me about our workshops."].
  • [kimaai_chatbot mode="inline"] puts a chat into the page’s content instead, with an optional height such as 480px, 32rem or 60vh (a plain number is pixels). See Inline chat.
  • Developers can change where the chatbot loads with the hook kimaai_chatbot_should_load, and the instructions with kimaai_chatbot_instructions.

Troubleshooting

  • The chatbot does not show on my site. Check Show on every page on Chatbot → Appearance. With it off, the page needs the AI chat block or the [kimaai_chatbot] shortcode.
  • The chatbot gets the date wrong. Turn on Add the current date, or put {current_date} into the instructions. The date follows the time zone in Settings → General of WordPress.
  • The chatbot does not answer. Check that an AI environment is connected on Connections and chosen on Chatbot → Behaviour.

What are your feelings