BloomDesk Chatbot
| 开发者 | kwiatekelk |
|---|---|
| 更新时间 | 2026年10月12日 20:44 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
- 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
- Service: BloomDesk
- Terms of use: Terms of use
- Privacy policy: Privacy policy
- a visitor sends a message
- the widget checks for new messages
- a visitor confirms or declines a chat action proposed by the service
- 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
Originheader, 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
- Service: Google reCAPTCHA
- Privacy policy: Privacy policy
- Terms of use: Terms of use
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.
安装:
- Install BloomDesk Chatbot from WordPress, or upload the plugin ZIP manually.
- Activate the plugin.
- Create an account at BloomDesk, sign in, and create a new team.
- Open Chat Settings → General in BloomDesk and generate a webhook URL for the team.
- In WordPress, open BloomDesk Chatbot → Connection, paste the full webhook URL, and save the settings.
- 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.
- On BloomDesk Chatbot → Connection in WordPress, copy the Origin value shown for your site.
- Go back to Chat Settings → General in BloomDesk and paste the Origin below the webhook settings.
- Save the BloomDesk settings.
- In WordPress, open BloomDesk Chatbot → Appearance.
- Choose Auto (follows the visitor's system), Light, or Dark.
- Set the chat title and subtitle in Polish and English.
- Adjust the widget scale, corner radius, border width, shadow, and opacity. These settings apply to both themes.
- Set colors separately for Light and Dark, using the live preview to check the result.
- Save the settings.
[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.屏幕截图:
常见问题:
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. Billing conditions are described in the terms of use.
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.
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.0disables the daily limit.
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.
更新日志:
- Reworked the WordPress.org directory description, installation, FAQ, and external-service disclosure for BloomDesk and optional Google reCAPTCHA.
- Prepared the plugin for the WordPress.org review: XSS-safe message rendering, human-readable JS sources, text domain and links aligned with the
bloomdesk-chatbotslug, and Requires PHP 8.2. - Activating the plugin again no longer replaces saved settings. Factory reset from the dashboard still restores defaults.
- Automatic footer placement stays off until an administrator enables it, or confirms the prompt when saving a new or changed webhook URL.
- Connected the widget to the BloomDesk FastAPI webhook instead of n8n. Connection settings include Origin copy, privacy-policy template link, long polling, and staged polling options.
- Added AI room-switch proposals with confirm/decline in the widget, plus clearer Agent AI / Operator status labels.
- Kept the active conversation in the visitor's browser session storage so a page refresh does not drop the chat.
- Added a Conversation tests screen with a live widget in wp-admin so administrators can try replies before enabling the chat on the site.
- Improved the admin UI: dashboard navigation and hero, clearer Connection screen, Appearance preview linked to settings fields, and factory reset moved under Limits and Security.
- 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
.envconfiguration. - Added optional "Powered by BloomDesk" attribution, disabled by default.