Hey Support: AI Chatbot

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:

  1. Paste your chatbot ID under Settings > Hey Support.
  2. 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

  1. Upload the hey-support-ai-chatbot folder to /wp-content/plugins/, or install through the WordPress Plugins screen.
  2. Activate the plugin.
  3. Go to Settings > Hey Support.
  4. Paste your chatbot ID.
  5. 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.

Why don’t the Verify token and Refresh chatbot list buttons work?

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

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.