Skip to main content
This guide shows you how to install AI Chatbot on your TYPO3 website for the first time. It takes about 15 minutes. AI Chatbot needs a second, free extension called AI Foundation. AI Foundation connects TYPO3 to an AI service (for example OpenAI). Keep both extensions switched on.
Upgrading from an older version (before v14)? Follow Reinstall After Upgrading instead.
AI Chatbot works with TYPO3 v12, v13 and v14. On TYPO3 v14, Admin Tools is called System. See TYPO3 v12, v13 and v14.

​
Before you start

You need:
  • An administrator login for the TYPO3 backend.
  • Your AI Chatbot license key from T3Planet.
  • An account with an AI service (for example OpenAI) and its API key (a password for the AI service). No account? You can use T3Planet Credits instead.

​
Step 1 — Install the License Manager

The License Manager (ns_license) unlocks T3Planet Premium extensions. Install its latest version first.

​
Step 2 — Activate the License

  1. Go to Admin Tools → T3Planet Shop (on TYPO3 v14: System → T3Planet Shop). Only system maintainers see this module.
  2. Enter your AI Chatbot license key.
  3. Click to activate the license.
  4. Wait until AI Chatbot is downloaded and installed.
  5. Check that AI Foundation was installed too. If not, see Step 3.
If your project is managed with Composer:
  1. Add nitsan/ns-t3ac and nitsan/ns-t3cs to the only list of the T3Planet repository in composer.json:
  1. Run:
  1. Check that nitsan/ns-t3af (AI Foundation) is installed. If not, run composer require nitsan/ns-t3af.
Full details: License activation

​
Step 3 — Install AI Foundation

Skip this step if AI Foundation was already installed in Step 2.
  1. Go to Admin Tools → Extensions (on TYPO3 v14: System → Extensions).
  2. Choose Get Extensions.
  3. Search for AI Foundation (ns_t3af).
  4. Click install.
  5. Clear all caches.
AI Foundation is free. Download page: extensions.typo3.org/extension/ns_t3af

​
Step 4 — Run Database Analyzer

TYPO3 needs to create new database tables for AI Chatbot.
  1. Go to Admin Tools → Maintenance (on TYPO3 v14: System → Maintenance).
  2. Click Analyze Database Structure.
  3. Apply all suggested changes.

​
Step 5 — Load the required TypoScript

Now switch on AI Chatbot for your website. Choose one of the two ways. Option A – Site set (TYPO3 v13 and v14, recommended) A site set is a package of settings you switch on for your website.
  1. Go to Site Management → Sites (on TYPO3 v14: Sites → Setup).
  2. Click Edit (pencil icon) on your website.
  3. On the General tab, find Sets for this Site.
  4. Add AI Chatbot - TYPO3 Extension. The base set AI Chatbot/Search - TYPO3 Extension is added automatically.
  5. Click Save.
  6. Clear all caches.
Site configuration, General tab with Sets for this Site (TYPO3 v14) Option B – Static templates (TYPO3 v12, or if you don’t use site sets)
  1. Go to Site Management → TypoScript (on TYPO3 v14: Sites → TypoScript).
  2. Select the start page of your website.
  3. Edit the TypoScript record and open the Includes tab.
  4. Under Include static (from extensions), add AI Chatbot/Search - TYPO3 Extension.
  5. Add AI Chatbot.
  6. Save and clear all caches.
AI Chatbot no longer has its own tab in the site configuration. Switching the chatbot on, page visibility, CSS and allowed websites are now in AI Universe → AI Chatbot/Search → Chatbot. See Upgrading? Where your old settings moved

​
Step 6 — Configure the AI Provider

Connect AI Chatbot to your AI service.
  1. Go to AI Universe → AI Foundation → AI Providers.
  2. Click New Provider.
  3. Choose your AI service under Adapter type.
  4. Enter your API key and choose the models.
  5. Turn on Provider enabled and Set as Default Provider.
  6. Click Save.
  7. Test the connection (see Testing a connection).
No own API key? Use T3Planet Credits instead. See T3Planet Credits. For a guided setup, use Quick Setup in AI Foundation (AI Foundation installation).

​
Step 7 — Verify the Installation

Check that:
  • AI Universe → AI Chatbot/Search opens without errors.
  • The license is active.
  • The AI provider test was successful.
AI Universe menu in the TYPO3 backend with AI Foundation and AI Chatbot/Search Done! Next, add your content and start the training: see Configuration and Data Source.
AI Chatbot is a Premium extension and needs a T3Planet license. AI Foundation is free. More about licenses: License.