Descripción
BotPar puts an AI assistant on your WordPress site in under a minute. It answers using the knowledge base you load from your panel (URLs, PDFs, SQL connectors), escalates to a human when needed, and matches your branding.
Features
- Conversational AI assistant (not rigid decision trees).
- Per-widget knowledge base (URLs, PDFs, connectors).
- Fully custom branding (color, logo, position).
- Live chat with escalation to a human agent.
- Multi-language.
- Per-widget domain allowlist.
How it works
- Create an account at botpar.com and set up your first widget.
- Copy the widget’s public key (it looks like
widget_pk_…). - Install this plugin and paste the key in Settings BotPar.
- The widget shows up on the front end of your site.
Privacy
- The plugin only injects a
<script>tag carrying your public key. WordPress itself does not send data to any server, with one exception: the Test connection button in the settings screen, which you trigger manually. - Visitor conversations go straight from the browser to the BotPar backend. They never pass through your WordPress install.
- If you enable «auto-identify logged-in users», the plugin passes the WordPress user’s email and display name to the widget so the human agent can see who is writing.
- The plugin contributes suggested text for your site’s privacy policy. You will find it under Settings Privacy Privacy Policy Guide, ready to review and adapt.
- Because conversations are not stored in your WordPress database, WordPress’s personal data export and erase tools do not reach them. Access and deletion requests are handled from your BotPar panel.
External service
This plugin integrates with BotPar, a separate SaaS product. The widget script is loaded from widget.botpar.com and conversations are sent to app.botpar.com. An account is required. Terms: https://botpar.com/terms-of-service. Privacy policy: https://botpar.com/privacy-policy.
Capturas
Bloques
Este plugin proporciona 1 bloque.
- BotPar Hace aparecer el botón del chat de BotPar en esta página.
Instalación
- Upload the
botpar/folder to/wp-content/plugins/, or install it from Plugins Add New and search for «BotPar». - Activate the plugin from Plugins.
- Go to Settings BotPar.
- Paste your public key and save.
- Visit your site: the widget appears in the bottom-right corner.
FAQ
-
Do I need an account to use the plugin?
-
Yes. The plugin only embeds the widget; the bot itself runs on the BotPar service.
-
Is there a free plan?
-
Yes. The Free plan includes 100 conversations per month and 1 widget.
-
How do I control where the widget appears?
-
You have four ways, and they combine:
- Excluded paths: one path per line, with
*supported as a trailing wildcard (for example/legal/*). - Excluded post types: tick the ones you want (posts, pages, products…) and the widget will not appear when viewing them.
- Hide on mobile or hide from logged-in users.
- Only where I place it: switch the Where it appears setting and the widget will show up only on pages where you add the
[botpar]shortcode.
- Excluded paths: one path per line, with
-
How do I use the shortcode?
-
In the block editor, search for BotPar in the block inserter and add it. In the classic editor, or if you prefer, type
[botpar]in the content. Both do the same thing and neither renders anything visible on the page: they simply make the floating chat button appear.If you left Where it appears set to «everywhere», no shortcode is needed. The shortcode is meant for the «only where I place it» setting.
When you place it by hand, the shortcode takes precedence over the path and post type exclusions: if you put it there, you want it there. It does respect «hide from logged-in users», because that setting is about who sees the widget rather than where it appears.
-
The widget does not show up on my site. What should I check?
-
Quickest path: go to Settings BotPar and click Test connection. It tells you which of these is failing:
- The public key is copied correctly.
- Your site’s domain is on the widget’s allowlist in your panel (Widgets General Domains).
- The widget is in Active state.
- No caching plugin is serving stale HTML (purge the cache after configuring).
-
I already had the plugin installed as «chat-bot-web». How do I migrate?
-
- Deactivate the old plugin from Plugins.
- Delete the
wp-content/plugins/chat-bot-web/folder over FTP or with your host’s file manager. - Install and activate this plugin.
Your settings are preserved: both versions store them under the same option key.
Do not use the «Delete» button in the WordPress plugins screen to remove the old plugin. That runs its uninstall routine, which erases the saved settings and you would have to enter them again. Deactivating and removing the folder by hand is safe.
-
Does it work with WooCommerce?
-
Yes. The widget appears on any front-end page, including product, cart and checkout pages. If you would rather it did not appear somewhere, exclude it under Excluded paths or Excluded post types.
What it does not do today is sync your product catalog into the bot’s knowledge base. If you want the bot to answer questions about products, load that information from your BotPar panel.
-
Does «auto-identify logged-in users» actually work?
-
Yes. When enabled, and if the visitor is logged in to your WordPress site, the plugin passes their email and name to the chat: the contact shows up identified in your panel (the agent sees it) and the pre-chat form is skipped. If the widget asks for cookie consent and the visitor has not consented, no auto-identification happens.
-
Is the plugin available in my language?
-
The interface ships in English and Spanish. Other languages can be contributed through translate.wordpress.org.
Reseñas
No hay valoraciones para este plugin.
Colaboradores y desarrolladores
«BotPar» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
«BotPar» está traducido en 2 idiomas. Gracias a los traductores por sus contribuciones.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.2.2
- Fixed the links to the BotPar privacy policy and terms of service in the suggested privacy policy text (Settings Privacy Policy Guide). If you already copied that text into your privacy policy, update both links.
1.2.1
- Fixed the links to the BotPar terms of service and privacy policy.
- Translations are now delivered through translate.wordpress.org instead of being bundled with the plugin.
- Tested up to WordPress 7.1.
1.2.0
- Security (important): pages carrying a logged-in user’s identity are no longer cached. Previously a caching plugin could store one user’s HTML and serve it to another, leaving the chat identified with the wrong person’s details. If you use «auto-identify logged-in users» together with a caching plugin, update.
- New Test connection button in Settings BotPar: it queries the backend with your key and your domain and tells you exactly what is wrong (rotated key, domain missing from the allowlist, or a host firewall blocking outbound requests).
- The status indicator used to be meaningless: it showed a green check as soon as a key was saved, even an expired one. It now reflects the result of an actual check.
- Plugin status now appears under Tools Site Health: version, backend, the domain validated against the allowlist, and the result of the last connection test. If you contact support, copying that section is enough. Site Health also warns you when the widget is not loading.
- New BotPar block for the editor: find it in the inserter and place it wherever you want the chat, no shortcode needed.
- New controls for where the widget appears: the
[botpar]shortcode to place it only on the pages you choose, exclusion by post type, and options to hide it on mobile or from logged-in users. «Hide on mobile» works with CSS rather than server-side device detection, so it does not break under caching plugins. - The plugin now contributes suggested privacy policy text for your site (Settings Privacy Guide): what the chat collects, what it is used for, who receives it, and how to request access or deletion. It includes a statement covering the name and email sent when auto-identification is enabled.
- New debug mode (optional, under Settings BotPar): records in the PHP error log why the widget was or was not shown on each page. It ships disabled and never logs visitors’ personal data.
- The «API base» field now requires
https://. - Clean uninstall on multisite: orphan options used to be left behind on the other sites of the network.
- Removed the «Hide the widget in /wp-admin» option: it did nothing. The widget was never shown in the dashboard.
1.1.0
- Rebranded to BotPar (botpar.com). Default hosts:
widget.botpar.com(loader) andapp.botpar.com(API). - Full auto-identify: with «auto-identify logged-in users» enabled, the WordPress user’s email and name are recorded on the conversation automatically (the agent sees them and the pre-chat form is skipped). Cookie consent from the widget is respected.
1.0.2
- Fix: the snippet now always includes
data-api-base. Without it the loader requested the config from the widget host and got a 404 plus a CORS error.
1.0.1
- Fix: the default loader now points at the correct widget host. In 1.0.0 it tried to load from the panel host and received HTML.
- The «API base» field no longer derives the loader URL (it is only used for
data-api-base).
1.0.0
- Initial release.
- Snippet injection via
wp_footer. - Visibility toggles (admin, path exclusions).
- Auto-identify for logged-in users.