Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

WordPress Plugin Guide

Complete guide to installing, connecting, and using the AI BotKit WordPress plugin to embed your chatbot and sync your site content.

The AI BotKit WordPress plugin lets you connect your WordPress site to your AI BotKit account, embed chatbots, sync your content for training, and integrate with WooCommerce -- all without leaving your WordPress admin.

Installation

Method 1: Install from WordPress.org (Recommended)

  1. Log in to your WordPress admin dashboard.

  2. Go to Plugins → Add New Plugin.

  3. Search for "AI BotKit for Lead Generation".

  4. Click Install Now, then click Activate.

Method 2: Upload the ZIP File

  1. Download the plugin ZIP from wordpress.org or your AI BotKit account.

  2. In WordPress, go to Plugins → Add New Plugin.

  3. Click Upload Plugin.

  4. Choose the ZIP file and click Install Now.

  5. Click Activate.

Connecting to Your AI BotKit Account

After activation, the plugin needs to connect to your AI BotKit SaaS account.

  1. In your WordPress admin sidebar, click AI BotKit.

  2. You'll see the Onboarding screen with a Connect button.

  3. Click Connect. This opens a popup asking you to log in to your AI BotKit account.

  4. Log in and authorize the connection.

  5. Once connected, your site URL and a secure token are saved automatically.

You only need to do this once. The connection persists until you manually disconnect.

Dashboard Overview

After connecting, the AI BotKit menu appears in your WordPress admin with these sections:

My Bots

Lists all chatbots from your AI BotKit account. You can view bot names, status (Active/Inactive), deployment scope (Sitewide/Page-specific), messages, and sessions. Editing happens on the SaaS dashboard via the Edit Bot link.

Analytics

Mirrors your SaaS analytics inside WordPress. See message counts, active sessions, and usage trends without leaving your site admin.

Content Sync

Configure which post types should be automatically synced to your AI BotKit knowledge base.

WooCommerce Enquiry

If you use WooCommerce, configure the Product Enquiry Integration (PEP) settings here.

Content Sync

Content Sync sends your WordPress pages, posts, and products to AI BotKit so your chatbot can answer questions using your site content.

What Gets Synced

Content Type
Description

Posts

Blog posts and articles

Pages

Static pages like About, Contact

Products

WooCommerce product pages

How to Sync

  1. Go to AI BotKit → Content Sync.

  2. Enable automatic content sync using the toggle.

  3. Select the post types you want to sync (Posts, Pages, Products, etc.).

  4. Click Save Settings.

  5. When you update a post of the selected types, it will be automatically synced to your knowledge base in the background.

  • The sync only applies for posts that are added in your chatbot's knowledge base.

  • Only published posts are synced.

  • Deleted posts are removed from your knowledge base automatically.

  • Syncing happens in the background and won't slow down your website.

Embedding Your Chatbot

Option 1: Site-Wide Embed

The easiest way to show your chatbot on every page:

  1. Go to your AI BotKit SaaS dashboard.

  2. Open your chatbot and go to DEPLOY → Publish.

  3. Select the WordPress deployment method.

  4. After connecting the plugin, your chatbot will appear automatically based on your deployment settings.

Option 2: Shortcode

Use the shortcode to place the chatbot on specific pages or posts:

  1. Edit any page or post.

  2. Paste the shortcode where you want the chatbot widget to appear.

  3. Publish or update the page.

If you omit the id attribute, the default chatbot is used.

Option 3: Share Link

Want to share your chatbot without embedding it? Use the direct link:

Anyone with this link can chat with your bot, even if it's not embedded on a website.

Disconnecting

To disconnect the plugin from your AI BotKit account:

  1. Go to AI BotKit → Settings.

  2. Click Disconnect.

  3. Confirm. Your connection token is removed.

Your chatbot will stop appearing on your site, and no new data will sync. Your AI BotKit account and chatbots remain unchanged.

Troubleshooting

The plugin says "Not Connected"

  • Make sure you've completed the onboarding and clicked Connect.

  • Check that your AI BotKit account is active.

My content isn't syncing

  • Go to Content Sync and make sure automatic sync is enabled.

  • Make sure the correct post types are selected.

  • Check that your site is accessible from the internet (localhost sites can't sync).

The chatbot isn't showing on my site

  • Make sure you've activated the chatbot in the SaaS dashboard (DEPLOY → Publish).

  • Check that the correct pages are selected.

  • Try using the shortcode as a test.

Related Topics

PreviousWordPress / Other Website IntegrationNextUsing Code Injection

Last updated