The Bot Forge Chatbot

1. 01Upload the-bot-forge-chatbot to the /wp-content/plugins/ directory, or install it from the Plugins screen.
2. 02Activate the plugin through the ‘Plugins’ menu in WordPress.
3. 03Open ‘Bot Forge Chatbot’ in the WordPress admin menu.
4. 04Paste your Bot ID. The plugin checks the connection straight away.
5. 05Click ‘Save changes’. Your chatbot is now live.

How do I get a Bot Forge Chatbot ID?

Visit app.thebotforge.ai and sign up for a free account. Create your chatbot using our intuitive platform. Once your chatbot is ready, copy the Bot ID from Share / Embed → WordPress. You can paste the whole embed snippet or chat link; the plugin keeps only the ID.

Can I specify which pages the chatbot appears on?

Yes. Under “Where it appears”, choose “Only on pages I pick” or “Every page except…”, then search for pages and posts by title. The homepage can be picked even if it shows your latest posts. You can also limit the chatbot to desktop or mobile, and hide it for logged-in users.

Can I hide the chatbot on a single page?

Yes. Open the page or post in the editor and turn on “Hide chatbot on this page” in the Chatbot panel of the sidebar. This works in both the block editor and the classic editor, and it overrides your site-wide display rules for that page.

The connection check says my domain is blocked. What do I do?

Domain security is turned on for your bot and your site isn’t on its allowed list. In The Bot Forge, open your bot, go to Advanced → Domain Security and add your domain. The settings screen links straight there.

The chatbot doesn’t show up on my site.

Check these in order:

1. 01The header on the plugin’s settings screen says “Live”. If it doesn’t, follow the message under “Check connection”.
2. 02Your display rules include the page you’re looking at, and “Hide for logged-in users” is off if you’re testing while logged in.
3. 03If you use a caching or speed plugin, clear its cache. The “Speed and caching plugins” card on the settings screen lists the ones it found and how to exclude the chat widget.

Administrators can view the page source and look for the “The Bot Forge Chatbot” comment near the end, which explains why the chatbot was or wasn’t added.

Does it work with caching plugins?

Yes. Display rules are decided before the page is cached, and the desktop/mobile rule runs in the visitor’s browser, so cached pages behave correctly. The plugin automatically excludes the chat widget from JavaScript minification, combining and delaying in WP Rocket, LiteSpeed Cache, SiteGround Speed Optimizer, Autoptimize, Jetpack Boost and Cloudflare Rocket Loader. For W3 Total Cache, WP Fastest Cache, Perfmatters, FlyingPress, Hummingbird, NitroPack, WP-Optimize and Breeze, the settings screen shows the exclusion steps.

I upgraded from 1.x. Do I need to redo my page list?

No, when the old entries still match a page. Page IDs, paths such as about/team , slugs, and exact page titles are converted to the new page picker. An entry that matches nothing is listed on the settings screen until you pick those pages and save, or dismiss the note. Saving other settings does not clear that note. A site that showed the chatbot on every page stays that way.

For developers: are there hooks?

bot_forge_chatbot_should_display (filter, bool): final say on whether the widget loads on the current request. bot_forge_chatbot_script_attributes (filter, array): attributes added to the widget’s script tag. bot_forge_chatbot_exclude_from_optimizers (filter, bool): return false to stop the automatic speed-plugin exclusions. Define BOT_FORGE_CHATBOT_DEBUG as true (with WP_DEBUG on) to log every display decision to the debug log.

What are the system requirements?

Your site must be running WordPress 5.8 or higher and PHP 7.2 or higher.