---
title: "Install the real WordPress plugin (not just a script tag) | Busymate AI"
description: "Install the busymate-ai plugin, add the floating widget or an inline [bmai_assistant] block, publish your knowledge, and recognize signed-in visitors."
last_updated: "2026-09-15T10:34:55+03:00"
---
# Install the real WordPress plugin (not just a script tag) | Busymate AI

Source: https://busymate.ai/fr/docs/guides/wordpress
Last modified: 2026-09-15T10:34:55+03:00
Busymate AI reaches WordPress through a real, installable plugin — not a copy-pasted script tag. The plugin loads the floating widget on every front-end page and signs a short-lived proof of who is logged in, so a returning signed-in visitor never has to sign in twice.

This is the WordPress-specific path. Wix, Squarespace and Webflow don't yet have a native app of their own — on those builders you still add the one script tag from [Add Busymate AI to WordPress, Wix or Squarespace](https://busymate.ai/articles/add-ai-assistant-wordpress-wix-squarespace).

## Before you start

- A self-hosted WordPress site (wordpress.org). The widget works on any PHP build; signed-in visitor recognition additionally needs the OpenSSL PHP extension (ES256) — without it the widget still loads, and the settings screen names exactly what your host is missing.
- An admin account on the site.
- Your workspace open in the Console.

## 1. Download your plugin

Every workspace's plugin is generated for that workspace — your workspace id and the embed origin are baked in at download time, so there is nothing to type into it.

1. In your [Console](https://busymate.ai/console), open your connection settings and choose **Download WordPress plugin**.
2. In wp-admin, open **Plugins → Add New → Upload Plugin**, upload the zip and activate it.
3. Activation generates the site's own ES256 signing key. Its settings screen shows the values a signed-in-visitor identity provider needs (issuer, JWKS URL, the launch endpoint) and a **Test identity** button that proves the signing endpoint answers.

The plugin's own copy, look and available tools all come from Busymate AI at chat time — updating any of that never means updating the plugin.

## 2. Put the chat where you want it

Out of the box the plugin adds the floating widget to every page — nothing else to do. To put a button inside a specific page (a contact page, a pricing page) that opens the same assistant — optionally with a starting question — use the **Busymate AI trigger** block in the block editor, or the `[bmai_assistant]` shortcode anywhere shortcodes work:

```
[bmai_assistant label="Ask about sizing" prompt="What sizes do you have?"]
```

Both ship directly in the plugin you downloaded — no separate install, no iframe to hand-place. See the live example at [wordpress.demo.busymate.ai](https://wordpress.demo.busymate.ai) (Larkspur Studio), where both the floating widget and an inline block are visible.

## 3. Teach it your content

Point a [website source](https://busymate.ai/fr/docs/guides/knowledge) at your site, or paste in your own pages and policies — the same knowledge pipeline every connection uses, with citations back to the page an answer came from.

## 4. Recognize signed-in visitors

The plugin signs the WordPress user id into its proof, so a signed-in visitor is recognized automatically once you register it as an identity provider — see [Recognize signed-in customers](https://busymate.ai/fr/docs/guides/identified-visitors) for the exact fields (issuer, JWKS URL, the launch endpoint the plugin's settings screen shows) and how to verify the wiring end to end before trusting it with real customer data.

## Manage from any MCP client

Every step above is available from any MCP client on your own account:

{{snippet:claude-code}}

## Troubleshooting

- **Settings screen warns about openssl** — the site's PHP build is missing the OpenSSL extension with EC (prime256v1) support; ask your host to enable it. The widget itself still works; only signed-in visitor recognition is unavailable until then.
- **The widget never appears** — check the browser console for a blocked or 404'd request to `/embed/v1.js`; a caching plugin that strips query-string-free `<script>` tags can remove it.
- **A signed-in visitor is still treated as a guest** — open **Test identity** on the plugin's settings screen; if it fails, the identity provider fields registered in Console don't match what the plugin's screen shows.

## Verify

1. Open your site in a private window: the floating widget appears and answers from your own content, with citations.
2. Sign in as a real WordPress user and ask the assistant something only a signed-in visitor should see (if you've wired identity) — the reply recognizes that visitor.
3. Ask it to hand off to a person — the conversation reaches your Inbox.

<!-- qa:start -->
### Do I need the plugin, or can I just use the script tag?
The script tag works everywhere, WordPress included. The plugin adds one thing the script tag can't: a signed proof of who is logged in, so a returning customer doesn't have to identify themselves twice.

### Does the plugin work without WooCommerce?
Yes. WooCommerce only changes which admin capability guards the plugin's settings screen — everything else (the widget, the identity proof) is the same on any WordPress site.

### Can I put the chat inline on a page instead of a floating button?
Yes, with the **Busymate AI trigger** block or the `[bmai_assistant]` shortcode the plugin ships with — no manual markup, no iframe. See the live demo above.
<!-- qa:end -->

## Next

- **[Teach your assistant your own content](https://busymate.ai/fr/docs/guides/knowledge)** — pages and posts beside whatever else you connect.
- **[Recognize signed-in customers](https://busymate.ai/fr/docs/guides/identified-visitors)** — the proof the plugin mints, registered as an identity provider.
- **[Set up human handoff](https://busymate.ai/fr/docs/guides/human-handoff-setup)** — staff the Inbox before visitors start asking to talk to someone.