Back to overview
AI Chatbot
AI chatbot widget on your website: set up, customise and test.
What is the Chatbot?
The AI Chatbot is a smart widget you can place on your website. Visitors can ask questions and receive instant answers powered by AI.
The chatbot appears as a floating button (usually bottom-right) and opens a chat window when clicked. You can fully customise the appearance, position and behaviour.
Tips
- An API key is always required, even for free models.
Enabling the Chatbot
To enable the chatbot:
1. Go to Chatbot Settings in the sidebar
2. Toggle "Enable Chatbot" on
3. Enter your API key
4. Select an AI model from the dropdown
5. Click Save
The chatbot is now active and can be placed on your website via the Page Builder.
API Key & Provider
The chatbot uses the BYOK model (Bring Your Own Key). This means you use your own API key from an AI provider.
Supported providers:
• OpenRouter – access hundreds of models via a single key
• OpenAI – direct access to GPT models
• Google – access to Gemini models
Your API key is stored encrypted in the database and is never readable after entry.
Note
- Your API key is stored encrypted but never share it with third parties.
System Prompt
The system prompt determines how the chatbot behaves. Here you provide instructions about:
• Your company or website name
• The tone (formal, informal, friendly)
• Topics the chatbot may or may not discuss
• Specific information that should always be mentioned
Example: "You are the customer service assistant of Golden Bakery. Always reply in English, be friendly and refer complaints to info@goldenbakery.com."
Tips
- Keep your system prompt short and specific for the best results.
Placing the Chatbot on your website
The chatbot is placed on your website via the Page Builder:
1. Open a page in the editor
2. Add the "ChatbotSection" block
3. The chatbot appears as a floating button on that page
You only need to add the block to one page – the chatbot is then available on that page. Want the chatbot on multiple pages? Add the block to each desired page.
Customising appearance
You can fully customise the chatbot's appearance:
• Button colour – the background colour of the chatbot button
• Icon – choose from various chatbot icons
• Position – bottom-right or bottom-left on the page
• Bubble style – the shape of the chat button (round, rounded)
• Chat width – how wide the chat window is
All style settings can be found in the ChatbotSection settings in the Page Builder.
Knowledge Base (RAG)
With the knowledge base you can upload PDF documents as an additional information source for the chatbot. The chatbot uses these documents as context when answering questions.
How it works:
1. Go to Chatbot Settings → Knowledge Base
2. Upload a PDF (max 10 MB)
3. The document is automatically processed and indexed
4. The chatbot uses the content for relevant questions
You can upload multiple documents and delete them individually.
What are chunks?
Chunks are small pieces of text that your documents and website pages are automatically split into. Think of it like a book: instead of searching the entire book, the system cuts it into handy paragraphs.
When a visitor asks a question, the chatbot searches these chunks to find the most relevant information. The more chunks you have, the more knowledge the chatbot has at its disposal.
You can see the number of chunks at:
• Chatbot usage → RAG chunks (total)
• Knowledge Base → per document
• Website content → per indexed page
Tips
- More chunks = better answers, but also more storage usage.
- Delete outdated documents to free up space.
Display mode: sitewide or per page
You can choose how the chatbot appears on your website:
• Sitewide — The chatbot appears automatically on all pages. Ideal if you want the same chatbot everywhere.
• Per page — Manually add the Chatbot block in the Page Builder on specific pages. Useful if you only want the chatbot on certain pages, or want different settings per page.
This setting can be found in Chatbot Settings → Display mode.
Chat styles (templates)
Choose a visual style for the chat window that matches your brand:
• Default — Clean, neutral style
• WhatsApp — Green bubbles, familiar chat look
• Facebook Messenger — Blue bubbles
• Microsoft Teams — Purple business style
• Minimal — Sleek and minimalist
• Neon — Eye-catching with neon colours
• Glassmorphism — Modern transparent glass effect
The style can be set in Chatbot Settings or per page in the Chatbot block.
Widget data
With widget data you can automatically index the content of your active widgets (such as rental, shop, menu, jobs, reservations and real estate) for the chatbot.
This allows the chatbot to answer questions about for example:
• Prices and availability of your rental property
• Products and stock in your webshop
• Dishes, allergens and prices on your menu
• Open vacancies and requirements
• Reservation options and events
• Property listings and features for real estate
How it works:
1. Go to Chatbot Settings → Knowledge Base
2. Scroll to 'Widget data'
3. Click 'Index widget data'
4. The data is processed and stored as chunks
Widget data is not automatically updated. After changing your widget content you need to re-index.
Tips
- Re-index widget data after changing prices, products or other widget content.
- Widget data uses the same RAG chunks as documents and website content.
Testing
Test your chatbot before visitors see it:
1. Go to Chatbot Settings
2. Use the test section at the bottom of the page
3. Type a test message and check the response
4. Adjust the system prompt or model if needed
The test function uses the same settings as the live chatbot, including knowledge base documents and widget data.
Note
- Changes to chatbot settings take effect immediately on your live website.