> ## Documentation Index > Fetch the complete documentation index at: https://docs.minidesk.ai/llms.txt > Use this file to discover all available pages before exploring further. # WordPress > Install the plugin, connect in one click, and run your chat from WordPress. The **miniDesk AI** plugin puts your chat on your WordPress site without copying any code. It also recognizes visitors who are signed in to WordPress, lets you choose where the chat shows, and lets you change how the chat looks and whether the AI answers by itself, all from your WordPress admin. The plugin is free. It needs WordPress 6.2 or later and PHP 7.4 or later. > [!NOTE] > > Running a WooCommerce store? The same plugin lets the AI answer "where is my > order?" with real status and tracking. See [WooCommerce](/integrations/woocommerce). ## Install and connect **1. Install the plugin** In your WordPress admin, go to **Plugins → Add New**, search for "miniDesk", and install **miniDesk AI**. Click **Activate**. **2. Click Connect** Go to **miniDesk AI** in the WordPress admin menu and click **Connect with miniDesk**. ![The miniDesk AI page in WordPress before connecting, with the Connect with miniDesk button](https://mintcdn.com/minidesk/-b91qe10vakJKfoG/images/wordpress/not-connected.png?fit=max\&auto=format\&n=-b91qe10vakJKfoG\&q=85\&s=de9e09c09a86f2451f51220b77036240) **3. Sign in and pick a workspace** You land on miniDesk.ai. Sign in, or create an account if you do not have one yet, then pick the workspace this site belongs to. **4. Click Connect** The Connect screen shows what connecting changes. Click **Connect**, and you are sent back to WordPress with the chat live on your site. ![The Connect screen on miniDesk.ai, with the workspace picked and the Connect button](https://mintcdn.com/minidesk/-b91qe10vakJKfoG/images/wordpress/connect-screen.png?fit=max\&auto=format\&n=-b91qe10vakJKfoG\&q=85\&s=2a903a3471d870516bc819e4346505bc) Only an owner of the workspace can connect a site. A member who opens the Connect screen is asked to find an owner. ### What connecting changes * **Your workspace's website becomes this site.** The chat only loads on your workspace's website, so this is what lets it appear here. If the workspace already had another website, the Connect screen asks before switching. * **miniDesk starts reading your site**, so the AI can answer from your pages. * **Your workspace gets a chat**, or the plugin uses the one it already has. A workspace has one chat, so the chat on this site and the one on your **Channels** page are the same. ## The miniDesk AI page in WordPress Everything the plugin does is on one page, **miniDesk AI** in your WordPress admin menu. On a connected site it has: ![The miniDesk AI page on a connected site: the status card, where the chat shows, and the Your chat card with its preview](https://mintcdn.com/minidesk/-b91qe10vakJKfoG/images/wordpress/plugin-page.png?fit=max\&auto=format\&n=-b91qe10vakJKfoG\&q=85\&s=c1831e35defae3e9309e8d89f78ef747) * **A status card**: which site the chat is live on, your workspace and plan, how much of your AI allowance and how many seats are left, and how many conversations are waiting for a reply. **Open inbox** and **Manage plan** open miniDesk.ai in a new tab. * **Where the chat shows**: the pages and paths where the chat is hidden. * **AI replies**: whether the AI answers by itself. * **WooCommerce**, when WooCommerce is active: see [WooCommerce](/integrations/woocommerce). * **Your chat**, on the right: how the chat looks, with a live preview. Your conversations, your team and your billing stay on miniDesk.ai. The buttons on this page take you there. ## Changing how the chat looks The **Your chat** card has the same settings as the chat on your miniDesk **Channels** page: ![The Your chat card: the settings on the left and a preview of the open chat on a phone on the right](https://mintcdn.com/minidesk/-b91qe10vakJKfoG/images/wordpress/your-chat.png?fit=max\&auto=format\&n=-b91qe10vakJKfoG\&q=85\&s=52651bf32653aaae7acf9df5dee55fe2) | Setting | What it does | | - | - | | **Ask for an email** | **Optional**: asked, and the visitor can say no. **Required**: they cannot carry on until they give one. **Do not ask**: replies reach them only while their chat window is open. | | **Opening message** | Shown before anyone types, up to 300 characters. Leave it empty and the chat opens with nothing. | | **Colour** | One of six colours, or your own as a six-digit hex code like `#3049A8`. | | **Position** | The bottom left or bottom right corner. | | **Theme** | Light, or dark for a site with a dark background. Your colour stays the same in both. | | **On a phone** | Full screen, or a floating panel if your site is itself a full-screen app. | | **Language** | **Match the visitor**, or one fixed language for everyone. Your opening message stays as you wrote it. | | **What the visitor sees** | Whether visitors see when someone on your team is typing, and when their message has been read. Your team always sees both. | The phone beside the settings shows your chat as you change them, before you save. **Closed** and **Open** switch between the button in the corner and the open chat. Click **Save chat settings** and your site shows the new look straight away. These are one set of settings, not a copy. Saving in WordPress changes them in miniDesk, and a change made in miniDesk shows up in WordPress the next time you open the page. Only the settings you changed are sent, so saving never undoes a change someone else made in miniDesk in the meantime. Some colours are refused because neither white nor black text reads well on them. The page says so before you save; try one a little lighter or darker. > [!NOTE] > > Only an owner of your miniDesk workspace can change a chat. WordPress makes > the change as the person who connected the site, so if that person is no > longer an owner, the page says so and nothing changes. Ask an owner to change > it in miniDesk, or to connect the site again. ## Hiding the chat on some pages Under **Show the chat on all pages, except**, tick the pages and posts where the chat should not appear. The search box above the list finds a page by its title. You can also hide the chat by address. Under **And on these paths**, write one path per line. End a path with `*` to hide every address that starts with it: `/checkout*` hides the chat on `/checkout`, `/checkout/payment` and any other page under `/checkout`. ![Where the chat shows: a searchable list of pages and posts, and a box of paths, with /checkout\* written in it](https://mintcdn.com/minidesk/-b91qe10vakJKfoG/images/wordpress/where-the-chat-shows.png?fit=max\&auto=format\&n=-b91qe10vakJKfoG\&q=85\&s=1aacc31273ee86410618c7528777ac04) A hidden page carries no chat code at all. The plugin decides before the page is built, so nothing loads and nothing flashes. ## Letting the AI answer by itself Under **AI replies**, **Let the AI answer by itself** decides whether the AI replies to chat visitors on its own or writes drafts for your team: * **On**: the AI answers chat visitors by itself when it is confident. * **Off**: the AI writes a draft, and someone on your team sends it. ![The AI replies section, with Let the AI answer by itself ticked](https://mintcdn.com/minidesk/-b91qe10vakJKfoG/images/wordpress/ai-replies.png?fit=max\&auto=format\&n=-b91qe10vakJKfoG\&q=85\&s=7c6529dbf99213ba35a2a8d3635ca381) It is the same setting as **Enable AI auto reply** with **Live chat** ticked in your miniDesk AI settings: * Ticking it turns on **Enable AI auto reply** and **Live chat** in miniDesk. Enable AI auto reply is the main switch, so the other channels ticked there start getting automatic answers too. * Unticking it turns **Live chat** off in miniDesk. Your other channels keep what you set for them. * The box shows ticked only when both are on in miniDesk. A change made there shows up in WordPress within a minute. If the AI is turned off for your whole workspace, the box is greyed out, with a link to your AI settings. If your workspace only lets owners change automated replies, the person who connected the site must be an owner. ## Signed-in visitors When someone signed in to your WordPress site opens the chat, miniDesk knows who they are. Their name and email appear in your inbox, and their conversation follows them from page to page. The plugin vouches for them: it signs who is signed in, and miniDesk only trusts that signature. A visitor cannot pretend to be someone else by typing an email. Nothing about the visitor is written into the page itself. The chat asks your site for it after the page has loaded, so a cached page is safe to serve to anyone. On a shared computer, a visitor who signs out, or another who signs in, never continues the previous person's conversation. ## The waiting count The number of conversations waiting for a reply shows on the **miniDesk AI** item in your WordPress admin menu and in a **miniDesk AI** box on the WordPress Dashboard. It is checked at most once a minute while you use the admin, and every hour in the background. ![The WordPress Dashboard with 3 conversations waiting, in the miniDesk AI box and on the menu item](https://mintcdn.com/minidesk/-b91qe10vakJKfoG/images/wordpress/waiting-count.png?fit=max\&auto=format\&n=-b91qe10vakJKfoG\&q=85\&s=f33091c921993196b06bbfee3ffbdae5) ## Using a public key instead of connecting On the miniDesk AI page, **Paste a public key instead** adds the chat without connecting. In miniDesk, open **Channels**, then your chat, then **Install**, and copy the part of the code that starts with `mdw_`. The chat works, but the rest of the plugin does not: * Signed-in visitors' name and email are passed to the chat but not verified. * There is no waiting count, no **Your chat** card, no AI switch and no WooCommerce orders. * You set your website in miniDesk yourself, so the chat is allowed to load on your site. Click **Connect for more** at any time to connect the site properly. ## Languages The plugin's pages in WordPress are in English, French, German, Spanish and Portuguese (Brazil), the same languages the chat speaks to your visitors. They follow the language set for your WordPress admin, under **Settings → General** or in your user profile. ## Staging and development copies Hosting companies often copy a whole site, plugin settings included, to make a staging site. The plugin notices when it runs somewhere other than the site it was connected on. The copy shows **This looks like a copy of** your site, turns its chat off, and never sends anything to your workspace. The original site keeps its connection. To use miniDesk on the copy, click **Connect this site** there. ## Page caches When you connect, disconnect, save a public key or change where the chat shows, the plugin clears the cache of these caching plugins, so visitors see the change straight away: * LiteSpeed Cache * WP Rocket * W3 Total Cache * WP Super Cache With another caching plugin, clear its cache yourself after these changes. ## Disconnecting Click **Disconnect** on the miniDesk AI page in WordPress, or open the WordPress row on your miniDesk **Channels** page and click **Disconnect site**. ![WordPress and WooCommerce under Connected integrations on the miniDesk Channels page](https://mintcdn.com/minidesk/-b91qe10vakJKfoG/images/wordpress/channels-rows.png?fit=max\&auto=format\&n=-b91qe10vakJKfoG\&q=85\&s=6946b5b9b9a413f908384571a22fd1ac) Either way the chat leaves your site and the plugin's key stops working. Conversations that came in through the chat stay in your inbox. A disconnect made in miniDesk reaches your site within an hour, or as soon as someone opens the WordPress admin. Deleting the plugin from WordPress disconnects it too, and removes all of its settings. ## What the plugin sends to miniDesk * **When you connect**: your site's address and name, the WordPress, WooCommerce and plugin versions, and a public key the plugin uses to sign who is signed in. * **About once an hour**, and when an administrator opens the WordPress admin: the same versions and which of the plugin's switches are on. miniDesk answers with the waiting count, your plan, your AI and seat usage, and your chat's settings. * **While the miniDesk AI page is open**: nothing. The preview on the **Your chat** card is drawn by the plugin itself; only your workspace logo is loaded from miniDesk. * **When a visitor uses the chat**: their messages, and their name and email if they are signed in. A copy of a connected site sends nothing. ## Troubleshooting ### Your site cannot reach miniDesk The page says **This site could not reach miniDesk** after you connect. Connecting ends with your site asking miniDesk for its key. That request goes from your server, not your browser, and it did not get through within 10 seconds. * Ask your host whether your site can make outgoing HTTPS requests to `api.minidesk.ai`. * If your `wp-config.php` sets `WP_HTTP_BLOCK_EXTERNAL`, add `api.minidesk.ai` to `WP_ACCESSIBLE_HOSTS`. * If a security plugin or a firewall blocks outgoing requests, allow `api.minidesk.ai` in it. Then click **Connect with miniDesk** again. ### The connection request expired The page says **That connection request expired or was already used**. A connection request works once, for one hour, and only for the administrator who started it. Click **Connect with miniDesk** again, signed in to WordPress as the same person who finishes on miniDesk.ai. ### miniDesk cannot connect sites right now The site tried to connect too many times in a short while, or miniDesk is briefly unavailable. Wait a few minutes, then click **Connect with miniDesk** again. ### The chat does not appear on my site * **Check that the page is not hidden** under **Where the chat shows**. * **Clear your page cache** if you use a caching plugin not listed above. * **With a public key only**, check that your workspace's website in miniDesk is this site. The chat only loads there. * **On a staging copy**, the chat is off until you connect that site. ### The chat settings cannot be loaded The **Your chat** card says **Your chat's settings cannot be loaded from miniDesk right now**. Your site could not reach miniDesk when the page loaded. The chat on your site is not affected. Reload the page in a minute. If it keeps happening, check that your host allows your site to make outgoing requests to `api.minidesk.ai`. ### Only an owner can change the chat Saving the **Your chat** card says **only an owner of your miniDesk workspace can change the chat**. The person who connected the site is no longer an owner of the workspace. An owner can change the chat from miniDesk, or click **Disconnect** and connect the site again under their own account. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.