Skip to main content
On the Chatbot tab you decide what your chatbot says, how it looks and where it appears. You see every change in the Live Preview before you save.

Quick setup

  1. Go to AI Universe → AI Chatbot/Search.
  2. Click the Chatbot tab.
  3. On Configuration, turn on Enable AI Chatbot, choose the Language and write the title and welcome messages.
  4. On Customize, choose your logo, avatar, colour and position.
  5. On General, choose on which pages the chatbot shows.
  6. Check the Live Preview on the right.
  7. Click Save Configuration.
All fields are explained below.

Configuration

  1. Go to AI Universe → AI Chatbot/Search.
  2. Click the Chatbot tab. The Configuration sub-tab opens.
  3. Fill in the fields below.
  4. Click the chatbot avatar in the Live Preview to test it.
  5. Click Save Configuration.
Chatbot tab, Configuration sub-tab with the chatbot settings and Live Preview

Settings

  • Enable AI Chatbot – switches the chatbot on or off for this website and language. (The label currently reads “Enable AI Chatbot Chatbot”.)
  • Enable chatbot feedback – thumbs up / down under answers. You see the ratings in Usage Analytics.
  • Enable email transcript – visitors can email themselves a copy of the chat. See Email transcript.
  • Transcript From email / Transcript From name – the sender of these emails. Leave empty to use the default.
  • Save chatbot history – saves conversations, so you can read them in Usage Analytics and visitors can reopen past chats. Switch off for stricter privacy.
  • Language – which language you are editing. Default (site default language) is your main language. See Multilanguage.
  • Chatbot Title – the name at the top of the chat window.
  • Short Description – a short line under the title.
  • Bubble Message – the small speech bubble next to the chat button, for example “Hey there, how can I help you?”
  • Welcome Message – the first message visitors see.
  • Chatbot Instructions – rules for the answers, for example “Answer friendly and in max. 3 sentences”.

Email transcript

Visitors can email themselves a copy of the chat, for example to keep opening hours or a price. Turn it on
  1. Go to AI Universe → AI Chatbot/Search → Chatbot → Configuration.
  2. Turn on Enable email transcript.
  3. Optional: enter a Transcript From email and Transcript From name.
  4. Click Save Configuration.
What visitors see
  1. The visitor opens the menu in the chatbot and clicks Email transcript.
  2. The chatbot says: “We will send a copy of this chat conversation to the email address you provide.”
  3. The visitor enters an email address and clicks Send.
  4. The chatbot shows “Transcript sent. Please check your inbox.”
TYPO3 must be able to send emails. If no sender address is set here or in the TYPO3 mail settings, visitors see an error.
The visitor’s email address is personal data. Mention this feature in your privacy policy.

AI Prompts

AI Prompts are standing instructions for the AI, for example “always answer politely” or “never give prices”. Use them to keep all answers in the same tone.
Tips
  • Keep instructions short and easy to test.
  • Test them with real visitor questions.
  • For instructions shared by all AI extensions, see AI Foundation AI Prompts.

Customization

On the Customize tab you make the chatbot match your website.
  • Upload Logo – your logo in the chat header.
  • Show Logo – show or hide the logo.
  • Avatar – the chatbot’s profile picture. Avatar Size makes it bigger or smaller.
  • Chatbot Color – one of five colour themes.
  • Show Date & Time – show the time of each message.
  • Transparent Trigger – makes the chat button less visible.
  • Chatbot Position – Left or Right.
  • Widget Bottom Space – distance from the bottom of the screen (15 to 200 pixels).
Chatbot tab, Customize sub-tab with logo, avatar, colour and position
To put the chatbot in another corner or side (for desktop and mobile separately), see Change the widget position.

General

On the General tab you choose on which pages the chatbot appears, source links, quick replies and the exact position.
These settings used to be in the site configuration. See Upgrading? Where your old settings moved
Chatbot tab, General sub-tab with Page Visibility, Sources Links, Quick replies and Custom Styling

Page Visibility

By default, the chatbot shows on all pages. To change that:

Show Chatbot on Specific Pages

Enter the page IDs (the number of each page in the page tree), separated by commas, for example 10, 22, 35. The chatbot shows only on these pages.

Hide Chatbot on Specific Pages

Enter the page IDs where the chatbot should not show, for example 45, 60, 72.
To hide the chatbot on one page (and its subpages), you can also use a switch in the page properties. See Hide the chatbot on a page.
  1. Turn on Enable Sources Links.
  2. In Maximum source links, choose how many links an answer may show (1–10).
The chatbot then adds links to the pages or files the answer is based on, so visitors can read more. Weak matches are left out, so an answer can show fewer links.

Quick replies

Quick replies are buttons that visitors see under the welcome message, for example “Opening hours” or “Shipping costs”. When a visitor clicks one, the chatbot shows the answer you prepared. No AI is used, so the answer comes at once and costs nothing. Chatbot tab, General sub-tab: the Quick replies box with two quick replies, and the buttons in the Live Preview Add a quick reply
  1. Go to AI Universe → AI Chatbot/Search → Chatbot → General.
  2. Find the box Quick replies.
  3. Click Add quick reply. A new row (for example Quick reply 1) opens.
  4. In Label, enter the button text, for example Opening hours. Keep it short (max. 120 characters).
  5. In Answer, write the reply. You can use bold, italic, underline, lists and links.
  6. Check the buttons in the Live Preview on the right.
  7. Click Save Configuration.
You can add up to 5 quick replies. After the fifth one, Add quick reply can no longer be clicked. Edit or remove a quick reply
  • Saved quick replies are shown closed, with their label (for example Quick reply 1 Opening hours). Click the row or the small arrow to open or close it.
  • Change the Label or the Answer, then click Save Configuration.
  • Click × at the end of a row to remove it, then click Save Configuration.
Change the order The buttons are shown in the same order as the rows. You cannot drag rows to move them. To change the order, remove a quick reply and add it again at the end. What visitors see
  1. The visitor opens the chatbot. The quick replies are shown as buttons under the welcome message.
  2. The visitor clicks a button. The label appears as the visitor’s message, and your answer appears as the chatbot’s reply.
  3. After the first message (a click or a typed question), the buttons are hidden. Typed questions are answered by the AI as usual.
A quick reply is only saved if it has both a Label and an Answer. Quick replies are the same for all languages of the chatbot, so write them in the language most of your visitors use.

Custom Styling and Chatbot Position

At the bottom of the General tab, the Section list has two panels: Custom Styling and Chatbot Position.

Custom Styling

In Custom Internal CSS you (or your web designer) can change the chatbot design with CSS code. It only changes the chatbot, not the rest of your website.

Change the widget position

By default, the chat button sits at the bottom right of the screen. You can move it to another corner or side, separately for desktop and mobile.
  1. Go to AI Universe → AI Chatbot/Search → Chatbot and open General.
  2. Scroll down to the Chatbot Position card. If you see Custom Styling instead, choose Chatbot Position in the Section list.
  3. Under Desktop, click a place: Left Top, Left Middle, Left Bottom, Right Top, Right Middle or Right Bottom.
  4. Under Mobile, click a place for phones.
  5. Check the Live Preview on the right: the chat button moves to the new place. Use the computer and phone icons above the preview to see both.
  6. Click Save Configuration.
Chatbot tab, General: Section list (2), Desktop (3) and Mobile (4) positions; the Live Preview shows the chat button at the bottom left (5) More options
  • Widget Hide on Desktop / Widget Hide on Mobile – hide the chatbot on that kind of device.
  • Exact Position Options – turn on Enable/Disable exact positioning and enter the distance in pixels (5 to 500). With Standard Positions you choose To the Left or To the Right and Lower or Higher. This replaces the place you clicked. For phones, use Exact Position Mobile Options.
The Customize tab also has Chatbot Position (Left / Right). Set it to the same side as your Desktop choice, so your website looks like the Live Preview.

External Embed

Show the chatbot on another website, for example your shop. All steps, the allowed websites and the server setting (.htaccess) are on the External Embed page. Chatbot External Embed tab with the embed code, External Embedding Settings and Apache Configuration AI Search has the same feature: AI Search External Embed.

Multilanguage

On the Configuration tab, use Language to choose which language version you are editing. Default (site default language) is the main language of your site. The list only shows languages that exist in your site configuration (Languages tab in Site Management → Sites on TYPO3 v12 and v13, Sites → Setup on TYPO3 v14).
  • Per language: Chatbot Title, Short Description, Bubble Message, Welcome Message, Chatbot Instructions, source links and chatbot feedback.
  • Same for all languages: the look (Customize), page visibility, quick replies, allowed websites and chat history. Change them once.

Crawling protected websites and large data

  • Pages behind a browser login? Go to AI Universe → AI Foundation → AI Features → Access & Notifications. See Basic authentication.
  • Very large website? Open the Training card in AI Features and change Chunk Size (default 1000). See Database chunking.
Access & Notifications drawer in AI Foundation with Enable Basic Authentication Support