Description
Hey Support is a hosted AI chatbot built for small and mid-size businesses. Train it on your website, docs, and FAQs in minutes. It answers customer questions, qualifies leads, and escalates to a human when it should.
This plugin embeds the widget on any WordPress site in two clicks:
- Paste your chatbot ID under Settings > Hey Support.
- Save. The widget appears on every page.
This plugin requires a Hey Support account. Hey Support is a paid third-party service with a free tier; the chatbot cannot work without it, because replies are generated on Hey Support’s servers. Sign up at https://hey.support and see the “External services” section below for exactly what is sent and when.
WooCommerce-aware
If WooCommerce is active, the plugin automatically forwards store and customer context into each conversation:
- Store URL and currency
- Customer ID and email (when the shopper is logged in)
- Last order ID and status (when the shopper is logged in)
- Current cart total and item count
The chatbot can use these fields to answer order questions, recover abandoned carts, or recommend products without you wiring anything up.
Cart figures are read at runtime from WooCommerce’s own Store API rather than being written into the page, so they stay correct on cached sites and on any theme.
Other features
- Shortcode
[hey_support]for per-page placement and overrides. - Gutenberg block. Drop the chatbot onto a specific page from the block editor.
- Show on / hide on rules: all pages, posts only, pages only, or shortcode-only.
- Per-page exclusions by post ID.
- Live cart updates. Cart totals in the chat follow along without a page reload.
What you’ll need
A Hey Support workspace at https://hey.support, and the public chatbot ID of the chatbot you want to embed. That ID is the only thing the widget needs.
A workspace API token is optional. It powers the Verify token and Refresh chatbot list buttons on the settings screen, which use the Hey Support public API. That API is available on the Scale plan and up; on every other plan, paste the chatbot ID by hand.
External services
This plugin connects to Hey Support (https://hey.support), the hosted service
that powers the AI chatbot. This connection is required – the chatbot cannot
function without it, since replies are generated server-side by Hey Support.
The plugin communicates with Hey Support in the following ways:
- Chatbot widget: the widget script is loaded from
https://hey.support/api/chat/embed.js on every page where the widget is shown.
Because this is a third-party script running in each visitor’s browser, Hey
Support receives standard request metadata such as the visitor’s IP address,
user agent, and the URL of the page the widget loaded on, even if the visitor
never opens the chat. Once a visitor does chat, their messages and the
conversation context are sent to Hey Support so the chatbot can generate
replies. - WooCommerce context (only when WooCommerce is active): the plugin forwards the
store URL and currency, the current cart total and item count, and – only when
the shopper is logged in – the customer ID, customer email, and last order ID
and status, so the chatbot can answer order- and cart-related questions. - Admin actions: when you click “Verify token” or refresh the chatbot list in
the plugin settings, your workspace API token is sent to Hey Support’s
/v1/me and /v1/chatbots endpoints to authenticate and list your chatbots.
Data is sent to Hey Support when the widget loads, when a visitor interacts with
the chatbot, or when you perform the admin actions above.
This service is provided by Hey Support. By using this plugin you agree to
Hey Support’s policies:
- Terms of Service: https://hey.support/terms
- Privacy Policy: https://hey.support/privacy
Blocks
This plugin provides 1 block.
- Hey Support Embed the Hey Support AI chatbot widget on this page.
Installation
- Upload the
hey-support-ai-chatbotfolder to/wp-content/plugins/, or install through the WordPress Plugins screen. - Activate the plugin.
- Go to Settings > Hey Support.
- Paste your chatbot ID.
- Save changes. The widget appears on the front-end immediately.
FAQ
-
Do I need WooCommerce?
-
No. The plugin works on any WordPress site. WooCommerce features activate only when WooCommerce is installed.
-
Where is my data sent?
-
Conversations and the WooCommerce context described in the “External services” section are sent to and processed by Hey Support (https://hey.support), stored in the workspace tied to your account. The chatbot widget itself is loaded from https://hey.support/api/chat/embed.js over HTTPS. See the “External services” section for full details.
-
Is my API token exposed on the page?
-
No. The embed carries only your public chatbot ID. The token is used server-side by the Verify and Refresh buttons, is never printed into your pages, and is never shown back to you after saving.
-
Those two buttons call the Hey Support public API, which is available on the Scale plan and up. On other plans they will report that API access is not on your plan. Nothing is broken: paste your chatbot ID into the field directly and the widget works exactly the same.
-
How do I show the widget on only specific pages?
-
In Settings > Hey Support, set “Show widget on” to “Only where [hey_support] shortcode or block is used”, then drop the
[hey_support]shortcode (or the Hey Support block) on the pages where you want it. -
Can I override the chatbot per page?
-
Yes. The shortcode and Gutenberg block both accept a chatbot ID override:
[hey_support chatbot_id="abc123"]The shortcode can also force auto-open on or off for a single page, overriding the site-wide setting in both directions:
[hey_support auto_open="false"] -
Does the cart total update live?
-
Yes. The plugin reads the cart from WooCommerce’s Store API and refreshes on WooCommerce’s standard cart events (
added_to_cart,removed_from_cart,wc_fragments_refreshed,updated_cart_totals), so totals stay accurate without a page reload. -
Is there a free tier?
-
Yes. Sign up at https://hey.support and start on the Free plan. Paid plans are one flat monthly price, never per message.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Hey Support: AI Chatbot” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Hey Support: AI Chatbot” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.
- Settings screen: chatbot ID, optional workspace API token, enable-on rules, per-post exclusions, auto-open.
- Site-wide auto-injection of the Hey Support widget loader in
wp_footer. [hey_support]shortcode for per-page placement, chatbot overrides, and forcing auto-open on or off.- Server-rendered Gutenberg block with chatbot ID and auto-open controls.
- Conditional WooCommerce extension forwarding store, customer, and cart context, with live cart updates read from the WooCommerce Store API.
- Verify-token and refresh-chatbot-list helpers for workspaces on plans that include public API access.