Title: NHB SupportBot
Author: Hakan Bilginer
Published: <strong>June 26, 2026</strong>
Last modified: June 26, 2026

---

Search plugins

![](https://ps.w.org/nhb-supportbot/assets/banner-772x250.png?rev=3586693)

![](https://ps.w.org/nhb-supportbot/assets/icon-256x256.png?rev=3586693)

# NHB SupportBot

 By [Hakan Bilginer](https://profiles.wordpress.org/hakanb/)

[Download](https://downloads.wordpress.org/plugin/nhb-supportbot.1.1.7.zip)

 * [Details](https://wordpress.org/plugins/nhb-supportbot/#description)
 * [Reviews](https://wordpress.org/plugins/nhb-supportbot/#reviews)
 *  [Installation](https://wordpress.org/plugins/nhb-supportbot/#installation)
 * [Development](https://wordpress.org/plugins/nhb-supportbot/#developers)

 [Support](https://wordpress.org/support/plugin/nhb-supportbot/)

## Description

SupportBot adds a lightweight chat widget to WooCommerce stores so customers can
get common support answers without waiting for manual replies.

It can help customers check order information, update shipping and billing addresses,
ask product-related questions, use quick reply buttons to get information on frequently
asked questions and contact a human through configured contact options.

SupportBot also includes an order notes communication feature built on WooCommerce’s
native order notes system. Customers can add a question, request, or follow-up note
about their order directly from the chat widget. Store admins can then reply from
the standard WooCommerce order notes area.

When a customer adds a note, the store admin is notified by email and SupportBot’s
notifications tab. When an admin replies with an order note, the customer can also
be notified by email and a chat message. This creates a simple order-specific support
thread, so both the customer and store team can follow up on order questions, delivery
updates, special requests and support issues without needing a separate ticket system.

Main features:

 * Floating frontend chat widget
 * WooCommerce order status lookup
 * Product question handling
 * Product search
 * Custom quick reply buttons
 * Return and shipping information replies
 * Optional human contact button
 * Order-specific customer/admin messaging via WooCommerce native order notes
 * Admin notifications for new customer notes
 * Logged-in customer notifications for admin replies
 * Chat logging with admin log viewer and automatic retention
 * Secure shipping and billing address update flow with email verification
 * Admin settings page for store owners
 * Customizable welcome and fallback messages
 * Translation-ready strings

SupportBot is designed for WooCommerce stores that want simple customer self-service
without adding a heavy live chat system.

SupportBot is developed by NHBSoft. Product information is available at https://
nhbsoft.com/product/supportbot-chat/.

SupportBot includes the Freemius SDK for optional opt-in usage tracking and access
to information about the separately distributed NHB SupportBot Pro plugin. Every
feature included in this WordPress.org package is fully available without connecting
a Freemius account.

Freemius Terms of Service: https://freemius.com/terms/

Freemius Privacy Policy: https://freemius.com/privacy/

### Requirements

 * WordPress 5.8 or higher
 * PHP 7.4 or higher
 * WooCommerce 7.0 or higher

### Basic Setup Guide

#### 1. Setup

Open SupportBot in the WordPress admin menu. In the Setup section, enable the chat
bot and choose who can see it. “Admins only (test mode)” is the safest starting 
point while you configure and preview the chatbot on the storefront. When the setup
is ready, switch visibility to logged-in users or everyone. Review the “Delete plugin
data on uninstall” option and leave it disabled if you may reinstall the plugin 
later or need to keep chat history.

#### 2. Pre-set buttons and replies

Review the welcome message, fallback answer, order status button, shipping information,
return policy, customer note setting, address change options and human contact options.

For most stores, a good first setup is:

 * Enable Order status.
 * Enable Shipping info.
 * Enable Return policy.
 * Enable Speak to human if you have a monitored contact channel.
 * Enable customer notes if admins are ready to reply from WooCommerce order notes.
 * Enable shipping address changes.
 * Keep billing address changes disabled unless your store needs them.

#### 3. Appearance

Choose the chat position.

#### 4. Custom buttons

Use custom buttons for store-specific answers such as product customization, store
policies, size guides or contact instructions. Custom buttons can be attached under
another custom button to create simple flows.

#### 5. Test before going live

Before using SupportBot on a live store:

 * Test the chat as a guest.
 * Test the chat as a logged-in customer.
 * Check an order status with an order number and matching email.
 * Add a customer note and reply as admin.
 * Confirm admin and customer note notifications work.
 * Test address update verification email delivery.
 * Review the privacy notice and chat logging policy.

## Screenshots

[⌊Chat widget on the storefront.⌉⌊Chat widget on the storefront.⌉[

Chat widget on the storefront.

[⌊Order status result.⌉⌊Order status result.⌉[

Order status result.

[⌊Order status actions.⌉⌊Order status actions.⌉[

Order status actions.

[⌊Settings page.⌉⌊Settings page.⌉[

Settings page.

[⌊Notifications page.⌉⌊Notifications page.⌉[

Notifications page.

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/nhb-supportbot` directory, 
    or install the plugin through the WordPress Plugins screen.
 2. Activate the plugin through the Plugins screen in WordPress.
 3. Make sure WooCommerce is installed and active.
 4. Go to SupportBot in the WordPress admin menu.
 5. Enable the chat widget and configure the available support options.

## FAQ

### Does SupportBot require WooCommerce?

Yes. SupportBot is built for WooCommerce stores and requires WooCommerce to be installed
and active.

### Does SupportBot use AI or send customer data to an external AI service?

No external AI service is required by the current plugin code. Replies are handled
through the plugin settings and WooCommerce store data.

### Can customers check order status?

Yes. Customers can check order information through the chat flow. Guest customers
are asked to verify the order email address.

### Can guests see previous orders?

No. Previous orders are only available to logged-in customers. Guests can check 
one order at a time by entering the order number and matching email address.

### Can customers update their order address?

If enabled by the store owner, customers can update their shipping and billing address
through the chat flow. The plugin uses email verification before saving the change.
Address changes are allowed once per address type, within 24 hours of placing the
order, and only while the order is Processing.

### Can shipping and billing address updates be controlled separately?

Yes. Store owners can allow shipping address changes, billing address changes, or
both.

### Can address changes be limited by order status?

Yes. Address changes are allowed only while an order is Processing.

### Why is the address update verification email not arriving?

SupportBot asks WordPress and WooCommerce to send the verification email. If the
log says the email was sent but it never reaches the mailbox, the issue is usually
email deliverability. Use a trusted SMTP or transactional email service, configure
SPF/DKIM/DMARC for the sender domain, and avoid using temporary domains for production
email.

### Can I customize the chat replies?

Yes. The plugin includes settings for common replies and custom quick reply buttons.

### Why do some replies stay in the old language after changing the site language?

Saved admin settings override translated defaults. Use the “Dialog text defaults”
reset option in the SupportBot settings if you want saved dialog replies to use 
the current site language defaults. Custom buttons are store-created content and
should be translated manually.

### Can I create custom button flows?

Yes. A custom button can be attached under another custom button, allowing simple
nested support flows.

### Why are custom buttons limited to 20?

The 20-button maximum is a universal stability safeguard for this plugin. It bounds
the size of the saved option and the work required to build and update parent-button
selectors in the admin screen. The same maximum applies to every installation and
is not changed by an account, license, payment, or upgrade.

### What happens if I delete a parent custom button?

Its child buttons are moved back to the main menu instead of being deleted.

### Can custom buttons use the same names as built-in buttons?

No. Custom button names must be unique and cannot match built-in SupportBot buttons
such as Order status, Shipping info, Return policy, or Speak to human.

### Can custom replies use HTML?

Yes. Pre-set and custom replies can include basic HTML formatting. Use simple formatting
and avoid adding scripts, forms, or sensitive data.

### How does the order notes feature work?

SupportBot uses WooCommerce’s native order notes. Customers can add a note about
their order through the chat widget and admins can reply from the WooCommerce order
screen. Email notifications can be sent when a new note is added, helping both sides
follow up on order-related support issues.

### Can note adding be limited by order status?

Yes. Notes can be added for Pending payment, Processing, and On hold orders.

### Where do admins see new note notifications?

Unread customer note notifications appear in the SupportBot Notifications tab. The
main SupportBot admin menu can also show a badge count.

### How are customers notified when an admin replies?

When an admin adds a customer-visible order note, SupportBot can notify the customer
by email and through the chat interface. Logged-in customers may see a chat icon
badge and a reminder to check the note through the Order status button.

### Are chat conversations logged?

Yes. SupportBot stores chat logs so admins can review support interactions. Store
owners should keep the privacy notice enabled and mention chat logging in their 
privacy policy where required.

### How long are chat logs kept?

SupportBot automatically deletes chat log rows older than 60 days in small scheduled
batches. Admins can also delete selected conversations or clear all logs manually.

### Can chat logs contain personal data?

Yes. Customers may type order details, addresses, or other personal data. Store 
owners should limit admin access and keep only the logs they need.

### Why do SupportBot setting changes sometimes appear late on the storefront?

Page caching, browser caching, and optimization plugins can delay visible changes.
Clear the site cache and browser cache if changes do not appear. SupportBot also
refreshes pre-set and custom buttons through AJAX, but aggressive caching can still
delay full page output.

### What should I do if the database becomes slow?

SupportBot stores chat logs in its own table and automatically prunes logs older
than 60 days in small batches. If the site still slows down, check the logs table
size, hosting limits, object cache availability, and any slow query log provided
by the host.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“NHB SupportBot” is open source software. The following people have contributed 
to this plugin.

Contributors

 *   [ Hakan Bilginer ](https://profiles.wordpress.org/hakanb/)

[Translate “NHB SupportBot” into your language.](https://translate.wordpress.org/projects/wp-plugins/nhb-supportbot)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/nhb-supportbot/), check
out the [SVN repository](https://plugins.svn.wordpress.org/nhb-supportbot/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/nhb-supportbot/)
by [RSS](https://plugins.trac.wordpress.org/log/nhb-supportbot/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1.7

 * Set a package-wide safety maximum of 20 custom buttons to bound option size and
   admin rendering work.
 * Clarified that the separately distributed Pro plugin is not required to use any
   functionality included in this package.

#### 1.1.6

 * Removed advanced local setting code from the WordPress.org package while keeping
   the built-in address and note safety rules.
 * Updated bundled documentation and translations to match the package behavior.

#### 1.1.5

 * Improved address verification emails with translated address labels and clearer
   formatting.
 * Updated plugin and release metadata for NHBSoft/Freemius deployment.

#### 1.1.4

 * Improved release readiness for Freemius and WordPress.org deployment.
 * Improved order status layout, product thumbnails, translations and admin settings
   organization.

#### 1.1.0

 * Added WooCommerce support chat widget.
 * Added order status lookup flow.
 * Added product question handling.
 * Added custom quick reply buttons.
 * Added optional customer note and address update flows.
 * Added admin settings page.

## Meta

 *  Version **1.1.7**
 *  Last updated **18 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [automation](https://wordpress.org/plugins/tags/automation/)[bot](https://wordpress.org/plugins/tags/bot/)
   [chatbot](https://wordpress.org/plugins/tags/chatbot/)[support](https://wordpress.org/plugins/tags/support/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/nhb-supportbot/advanced/)

## Ratings

No reviews have been submitted yet.

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

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

## Contributors

 *   [ Hakan Bilginer ](https://profiles.wordpress.org/hakanb/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/nhb-supportbot/)