Title: BloomDesk Chatbot
Author: kwiatekelk
Published: <strong>4 de octubre de 2026</strong>
Last modified: 9 de octubre de 2026

---

Buscar plugins

![](https://ps.w.org/bloomdesk-chatbot/assets/icon-256x256.png?rev=3737042)

# BloomDesk Chatbot

 Por [kwiatekelk](https://profiles.wordpress.org/kwiatekelk/)

[Descargar](https://downloads.wordpress.org/plugin/bloomdesk-chatbot.0.2.1.zip)

 * [Detalles](https://es-do.wordpress.org/plugins/bloomdesk-chatbot/#description)
 * [Valoraciones](https://es-do.wordpress.org/plugins/bloomdesk-chatbot/#reviews)
 *  [Instalación](https://es-do.wordpress.org/plugins/bloomdesk-chatbot/#installation)
 * [Desarrollo](https://es-do.wordpress.org/plugins/bloomdesk-chatbot/#developers)

 [Soporte](https://wordpress.org/support/plugin/bloomdesk-chatbot/)

## Descripción

BloomDesk Chatbot connects your WordPress site to the [BloomDesk](https://bloomdesk.pl)
customer support platform. Let AI answer visitors and take over any conversation
when you want to reply personally, without losing its history.

AI features require a plan that includes them, and AI usage is billed separately.
Human-only live chat is also available, including on the Free plan.

**Availability:** BloomDesk is currently a B2B service for businesses in Poland.
Creating an account requires company details and acceptance of the [terms of use](https://bloomdesk.pl/terms).

#### Features

 * AI handles visitor conversations automatically, with one-click human takeover
   whenever needed
 * Manage conversations and reply as a human operator from the BloomDesk dashboard
 * Automatic footer placement or the `[bloomdesk_chatbot]` shortcode
 * Light, dark, and automatic themes, custom colors, and live appearance preview
 * Polish and English widget interface
 * Built-in rate limits and optional Google reCAPTCHA protection
 * Webhook credentials stay on the WordPress server and are not exposed to the visitor’s
   browser
 * Chat transcripts are not stored in the WordPress database
 * Optional "Powered by BloomDesk" link, disabled by default

#### Who it’s for

BloomDesk is designed for small and medium-sized service businesses that want to
respond to website visitors faster, improve customer contact, and generate more 
leads.

It is a good fit for agencies, consultants, local service companies, and other service
businesses where conversations with potential customers are an important part of
the sales process.

BloomDesk is not currently designed for online stores that require direct access
to product catalogs, stock levels, prices, or other e-commerce data.

#### How it works

Visitors send messages through the widget on your website. BloomDesk stores the 
conversation history and delivers replies to the same widget. When enabled, the 
AI assistant answers automatically; a human operator can take over and continue 
the conversation from the BloomDesk dashboard. You manage conversations in BloomDesk.

#### Get started

Create a [BloomDesk account](https://bloomdesk.pl/sign-up) and connect your WordPress
site to a team. The Installation section explains how to configure the webhook URL,
add your site’s Origin, and display the widget.

[View plans and pricing](https://bloomdesk.pl/pricing)

#### External services

This plugin depends on the external BloomDesk service to provide chat functionality.
External requests begin after an administrator configures a BloomDesk webhook URL
and visitors use the chat.

**BloomDesk** (required for chat)

 * Service: [BloomDesk](https://bloomdesk.pl)
 * Terms of use: [Terms of use](https://bloomdesk.pl/terms)
 * Privacy policy: [Privacy policy](https://bloomdesk.pl/privacy)

The BloomDesk terms of use and privacy policy are currently available in Polish.

The plugin connects to BloomDesk when:

 * a visitor sends a message
 * the widget checks for new messages
 * a visitor confirms or declines a chat action proposed by the service

Visitor message text and page context are sent to BloomDesk so that the chat can
operate.

Data sent to BloomDesk may include:

 * message text (`chatInput`) and the session ID
 * page URL, page title, and user agent inside `metadata`
 * source marker (`widget`) and supported client capabilities (`actions`, `room_switch`)
 * the site’s `Origin` header, added by the plugin on the server
 * when checking for messages: `externalSessionId`, `afterId`, and polling information
 * when confirming or declining a proposal: `externalSessionId`
 * when reCAPTCHA is enabled: a short-lived session pass issued by this WordPress
   site after verification

The BloomDesk webhook token is added to requests on the WordPress server and is 
not exposed to the visitor’s browser.

The Google reCAPTCHA token itself is not sent to BloomDesk.

The visitor’s IP address is not included in the chat request body sent to BloomDesk.
The WordPress site uses the address for local rate limiting and, when reCAPTCHA 
is enabled, for Google’s verification request.

Data received from BloomDesk includes chat messages from AI or human operators and
session metadata required to continue the conversation.

**Google reCAPTCHA** (optional)

Google reCAPTCHA is used only when an administrator enables it and saves the required
configuration.

 * Service: [Google reCAPTCHA](https://www.google.com/recaptcha/about)
 * Privacy policy: [Privacy policy](https://policies.google.com/privacy)
 * Terms of use: [Terms of use](https://policies.google.com/terms)

When reCAPTCHA is enabled, the visitor’s browser loads `https://www.google.com/recaptcha/
api.js` and displays the reCAPTCHA checkbox.

Google may receive the visitor’s IP address and interaction data according to Google’s
own privacy policy. After the visitor completes the verification, this site’s server
sends the reCAPTCHA token and the visitor’s IP address (`REMOTE_ADDR`) to `https://
www.google.com/recaptcha/api/siteverify`.

### Source code

The JavaScript and CSS included with this plugin are provided in human-readable 
source form.

The file `assets/js/widget.js` is both the source and runtime file. It is not compiled,
bundled, or minified, and there is no JavaScript build step.

Other scripts in `assets/js/` — including `backend-connection.js`, `admin.js`, `
btcb-defaults.js`, `appearance-preview.js`, `recaptcha.js`, `translations.js`, and`
dashboard-hero.js` — are also original source files.

Stylesheets in `assets/css/` are likewise included as their original source.

## Capturas

[⌊Match the widget to your brand with custom colors and a personalized chat title.⌉⌊
Match the widget to your brand with custom colors and a personalized chat title.⌉[

Match the widget to your brand with custom colors and a personalized chat title.

[⌊Connect your WordPress site to your BloomDesk team.⌉⌊Connect your WordPress site
to your BloomDesk team.⌉[

Connect your WordPress site to your BloomDesk team.

[⌊Set up your AI assistant's instructions and test its responses.⌉⌊Set up your AI
assistant's instructions and test its responses.⌉[

Set up your AI assistant’s instructions and test its responses.

[⌊Take a moment for yourself while your AI assistant answers visitors for you.⌉⌊
Take a moment for yourself while your AI assistant answers visitors for you.⌉[

Take a moment for yourself while your AI assistant answers visitors for you.

[⌊Take over any conversation with one click whenever you want to reply personally.⌉⌊
Take over any conversation with one click whenever you want to reply personally.⌉[

Take over any conversation with one click whenever you want to reply personally.

[⌊Expand your assistant's knowledge by adding and refining questions and answers.⌉⌊
Expand your assistant's knowledge by adding and refining questions and answers.⌉[

Expand your assistant’s knowledge by adding and refining questions and answers.

## Instalación

#### Install the plugin

 1. Install BloomDesk Chatbot from WordPress, or upload the plugin ZIP manually.
 2. Activate the plugin.

#### Connect the plugin to BloomDesk

 1. Create an account at [BloomDesk](https://bloomdesk.pl/sign-up), sign in, and create
    a new team.
 2. Open [Chat Settings  General](https://bloomdesk.pl/chat/settings/general) in BloomDesk
    and generate a webhook URL for the team.
 3. In WordPress, open BloomDesk Chatbot  Connection, paste the full webhook URL, and
    save the settings.
 4. After saving the webhook URL, confirm the prompt to display the chat widget on 
    your site. If you skip this step, you can enable it later under BloomDesk Chatbot
    Widget.
 5. On BloomDesk Chatbot  Connection in WordPress, copy the **Origin** value shown 
    for your site.
 6. Go back to [Chat Settings  General](https://bloomdesk.pl/chat/settings/general)
    in BloomDesk and paste the Origin below the webhook settings.
 7. Save the BloomDesk settings.

Your WordPress site is now connected to the selected BloomDesk team. If you enabled
widget display, open your site and send a test message.

#### Customize the appearance

 1. In WordPress, open BloomDesk Chatbot  Appearance.
 2. Choose Auto (follows the visitor’s system), Light, or Dark.
 3. Set the chat title and subtitle in Polish and English.
 4. Adjust the widget scale, corner radius, border width, shadow, and opacity. These
    settings apply to both themes.
 5. Set colors separately for Light and Dark, using the live preview to check the result.
 6. Save the settings.

#### Display and widget options

Under BloomDesk Chatbot  Widget, you can enable automatic footer placement, choose
the interface language, and configure the privacy-policy link and optional "Powered
by BloomDesk" link.

You can also display the widget using the `[bloomdesk_chatbot]` shortcode.

Automatic footer placement is disabled by default. Enable it through the prompt 
after saving the webhook URL or later on the Widget screen. Saving appearance settings
alone does not enable it.

## FAQ

### Do I need a BloomDesk account?

Yes. BloomDesk Chatbot is a client for the BloomDesk service and requires a BloomDesk
account and webhook URL to provide chat functionality.

BloomDesk is currently a B2B service for businesses in Poland.

### Is there a free plan?

Yes. The Free plan includes the chat widget and human live chat.

AI features require a plan that includes them. AI usage is billed separately based
on consumption.

Adding funds to the AI usage wallet does not by itself enable AI features.

Current plans are available at [BloomDesk](https://bloomdesk.pl/pricing). Billing
conditions are described in the [terms of use](https://bloomdesk.pl/terms).

### Can I use the chat without AI?

Yes. BloomDesk can work as a human-only live chat.

When AI is available and enabled, a human operator can take over the conversation
from the BloomDesk dashboard. The conversation history remains available in BloomDesk.

### Where do I see conversations and reply to visitors?

In the BloomDesk dashboard.

WordPress displays the widget and acts as a proxy between the visitor and BloomDesk,
but conversations are managed from BloomDesk rather than WordPress admin.

### Does the chat slow down my site?

The widget’s JavaScript and CSS are served from your own WordPress site. The widget
is not an embedded copy of the BloomDesk dashboard.

Like any front-end functionality, the plugin still adds its own JavaScript and CSS
to pages where the widget is used.

### Is the widget available in Polish?

Yes. The widget supports Polish and English.

It can follow the WordPress locale automatically or use a language selected under
BloomDesk Chatbot  Widget.

### Can I match the widget to my website?

Yes. Under BloomDesk Chatbot  Appearance you can adjust colors, size, shape, and
text, then preview the result live. Choose a light or dark theme, or let the widget
follow the visitor’s system preference.

### Does the widget show a "Powered by BloomDesk" link?

Not by default.

An administrator can enable the optional "Powered by BloomDesk" link under BloomDesk
Chatbot  Widget.

### Where do I paste the webhook URL?

Open BloomDesk Chatbot  Connection in WordPress admin and paste the full webhook
URL provided by BloomDesk.

Paste the complete URL, including `/ai/webhook/{token}`. Then copy the site’s Origin
from the same WordPress screen into the team’s general chat settings in BloomDesk
and save it.

The webhook URL is stored on the WordPress server. Its token is added to requests
server-side and is not sent to the visitor’s browser.

### What does the plugin store in WordPress?

Chat transcripts are not stored in the WordPress database.

The active conversation is temporarily stored in the visitor’s browser session storage
so that the widget can maintain the current conversation during that browser session.

The plugin stores its configuration and a hash of the browser owner token. Rate-
limit counters use temporary WordPress transients and expire automatically.

Uninstalling the plugin removes its settings and session-ownership tables (`btcb_settings`
and `btcb_session_owners`, with your WordPress table prefix) and the plugin options.

Information about processing by BloomDesk is available in the [privacy policy](https://bloomdesk.pl/privacy).

### How is access to a visitor’s conversation protected?

The anonymous widget does not use a logged-in WordPress user nonce.

The first message creates a browser ownership cookie. Later reads and writes for
that conversation, including proposal confirmation and rejection, require the same
ownership cookie.

Requests without the matching ownership cookie are rejected. Message reads before
the first message are refused.

If Google reCAPTCHA is enabled, its verification happens before the conversation
is created.

### Can I override settings in wp-config.php?

Yes. Optional WordPress constants can override selected values stored in the plugin
settings.

The plugin does not read a `.env` file from its directory.

Available constants:

 * `BTCB_SAAS_WEBHOOK_URL` — full webhook URL including `/ai/webhook/{token}`. This
   constant does not automatically enable footer placement.
 * `BTCB_RECAPTCHA_SECRET` — Google reCAPTCHA secret key.
 * `BTCB_RATE_LIMIT_PER_MINUTE` — per-minute rate limit.
 * `BTCB_RATE_LIMIT_PER_DAY` — daily rate limit. `0` disables the daily limit.

Example:

    ```
    define('BTCB_SAAS_WEBHOOK_URL', 'https://example.com/ai/webhook/your-token');
    ```

### I already use the [bloomtech_chatbot] shortcode. Will it still work?

Yes. `[bloomtech_chatbot]` remains supported for compatibility.

For new installations, use the current `[bloomdesk_chatbot]` shortcode.

## Reseñas

No hay reseñas para este plugin.

## Colaboradores y desarrolladores

"BloomDesk Chatbot" es un software de código abierto. Las siguientes personas han
colaborado con este plugin.

Colaboradores

 *   [ kwiatekelk ](https://profiles.wordpress.org/kwiatekelk/)

[Traduce "BloomDesk Chatbot" a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/bloomdesk-chatbot)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/bloomdesk-chatbot/),
echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/bloomdesk-chatbot/)
o suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/bloomdesk-chatbot/)
por [RSS](https://plugins.trac.wordpress.org/log/bloomdesk-chatbot/?limit=100&mode=stop_on_copy&format=rss).

## Registro de cambios

#### 0.2.1

 * Added a Conversation tests screen so administrators can try live assistant replies
   before enabling the widget on the site.
 * Appearance preview stays a visual mock and no longer depends on the WordPress
   admin URL.

#### 0.2.1

 * Reworked the WordPress.org directory description, installation instructions, 
   and FAQ.
 * Added clearer information about BloomDesk availability, plans, AI usage, and 
   human live chat.
 * Expanded external-service disclosure for BloomDesk and optional Google reCAPTCHA.
 * Clarified what chat data is stored in WordPress, the visitor’s browser, and BloomDesk.
 * Activating the plugin no longer replaces settings that are already saved.
 * Automatic footer placement remains disabled until an administrator explicitly
   enables it.

#### 0.2.0

 * Initial public release.
 * Added the chat widget, BloomDesk connection settings, appearance settings, and
   optional Google reCAPTCHA.
 * Added optional configuration through constants in `wp-config.php`.
 * Removed support for plugin-directory `.env` configuration.
 * Added optional "Powered by BloomDesk" attribution, disabled by default.

## Meta

 *  Version **0.2.1**
 *  Last updated **hace 5 horas**
 *  Active installations **Menos de 10**
 *  WordPress version ** 7.1 o superior **
 *  Tested up to **7.1.3**
 *  PHP version ** 8.2 o superior **
 *  Language
 * [English (US)](https://wordpress.org/plugins/bloomdesk-chatbot/)
 * Tags
 * [AI](https://es-do.wordpress.org/plugins/tags/ai/)[chat](https://es-do.wordpress.org/plugins/tags/chat/)
   [chatbot](https://es-do.wordpress.org/plugins/tags/chatbot/)[customer support](https://es-do.wordpress.org/plugins/tags/customer-support/)
   [live chat](https://es-do.wordpress.org/plugins/tags/live-chat/)
 *  [Vista avanzada](https://es-do.wordpress.org/plugins/bloomdesk-chatbot/advanced/)

## Valoraciones

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/bloomdesk-chatbot/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/bloomdesk-chatbot/reviews/)

## Colaboradores

 *   [ kwiatekelk ](https://profiles.wordpress.org/kwiatekelk/)

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/bloomdesk-chatbot/)