Hazelchat

Hazelchat puts an AI chat agent on your WordPress site. It answers visitors’ questions from the pages and documents you approve, shows the source under every answer, and offers an enquiry form when someone wants to talk to you. When your content has no answer, it says so instead of guessing.

You choose what it reads and check its answers in Hazelchat before anything goes live.

Get started

1. Create a free Hazelchat account and add your website. Pick the pages it should answer from and try a few questions.
2. Install this plugin. Under Settings > Hazelchat, paste the installation code from Hazelchat and switch loading on.
3. In Hazelchat, click Publish and switch on.

The full setup guide, with cookie banners and caching plugins, is at hazelchat.co/wordpress.

The free plan covers one website and 50 answers a month. Paid plans add more answers, enquiry emails and more websites: pricing.

What the plugin does

• A field for your installation code or public widget key, with strict validation. Only the 64-character key is kept.
• An explicit switch to load the widget on public pages.
• Works with your cookie banner: Complianz holds the chat back until visitors agree, with nothing to set up. Real Cookie Banner, Borlabs Cookie and other banners follow a service named Hazelchat.
• A link back to Hazelchat to check installation and test your published agent.
• On a WooCommerce shop: the chat’s product cards can add to the visitor’s cart on the page, through WooCommerce’s own Store API.
• Optional order tracking for WooCommerce, off until you connect it: see which paid orders include something a visitor added to the cart from the chat.

Activation alone does not load the hosted service, and order tracking stays off until you type a code from Hazelchat. Links from the plugin and this page to Hazelchat carry campaign tags (utm_source=wordpress) so Hazelchat can count signups that start here; nothing is sent until you click one. No account password, administrative token or AI provider key belongs in WordPress settings. The public widget key grants no administrative access.

Answers use your reviewed, published sources. Source-only mode shows retrieved excerpts; AI-evidence mode writes answers from retrieved evidence. This plugin does not implement an AI engine, guarantee correctness or guarantee sales.

External services

This plugin connects to Hazelchat, a hosted service at https://app.hazelchat.co. A Hazelchat account is required; free and paid plans are available. Billing, content management and agent configuration take place on Hazelchat, not in WordPress. Pricing: https://hazelchat.co/pricing/

After an administrator supplies a valid public widget key, accepts the service connection and enables loading, visitors’ browsers download https://app.hazelchat.co/widget.js. The script displays a chat frame from the same service. Browser network requests expose ordinary connection information, such as the visitor’s IP address, to the service. When visitors use the chat, their questions, conversation data and any submitted enquiry details (name, email and message) are sent to Hazelchat. Configured AI-evidence mode sends questions and retrieved source passages to its model provider; source-only mode does not use a model. Retention and data requests are managed in Hazelchat. The plugin itself does not read or send WordPress users, posts or private pages, and sends no activation telemetry.

On a WooCommerce shop, the script tag also tells the chat where WooCommerce’s Store API and cart page are on your site. When a visitor clicks Add to cart on a product card in the chat, their browser adds the product to their cart on your site through WooCommerce’s own Store API; nothing of the cart is sent to Hazelchat. Hazelchat reads your published products from the same public Store API, as any visitor’s browser could. On a product page the tag also carries that product’s id; with each question a visitor sends, the chat sends the page’s path and that id to Hazelchat, which uses them to answer about that page and keeps only which of your products it was.

Order tracking (optional, off by default). Only after you switch it on in Hazelchat and type the code it shows into Settings > Hazelchat does this site make server-to-server requests to Hazelchat:

• When you save the code: one request to https://app.hazelchat.co/api/integrations/woocommerce/connect with the code and your site’s address. Hazelchat answers with a signing secret, which is stored in this site’s database (not autoloaded) and removed on Disconnect or when you delete the plugin.
• When an order that includes something a visitor added to the cart from the chat is paid, cancelled or refunded: one signed request to https://app.hazelchat.co/api/integrations/woocommerce/orders, sent in the background by WooCommerce’s Action Scheduler. It contains the order’s id and number, its status, its total after refunds, its currency, and for each line added from the chat the product and variation id, the quantity, the line total and the random chat reference. It never contains the customer’s name, email, phone, addresses, payment or shipping method, coupons, notes or any other line. Orders without a line added from the chat cause no request at all.

The chat reference is a random code that Hazelchat adds to the chat’s Add to cart; WooCommerce keeps it with that cart line and the order line (hidden in the order screen). Reports stop when you disconnect, turn widget loading off, deactivate or delete the plugin.

With Complianz active, the plugin lists Hazelchat as a service in Complianz, which then holds the widget script back until the visitor agrees. Hazelchat is filed under preferences where your banner asks for them, otherwise marketing; a banner that asks for nothing beyond functional cookies gets no entry. The widget itself follows a service named Hazelchat in Real Cookie Banner, Borlabs Cookie, Usercentrics, CCM19 and consentmanager, and Cookiebot’s preferences when the wait box is ticked. It reads the consent in the visitor’s browser and sends nothing about it to Hazelchat. The optional wait box (under More) still allows the small launcher script to download; it prevents the chat frame, chat API requests and session-storage access until the banner agrees or dispatches hazelchat-consent with detail: true. Withdrawing consent removes the widget but does not erase records already held by Hazelchat.

Service terms: https://hazelchat.co/terms/
Privacy notice: https://hazelchat.co/privacy/
Data processing agreement: https://hazelchat.co/dpa/

Credits

Bricolage Grotesque and Parkinsans (the outlined Hazelchat wordmark) are licensed under the SIL Open Font License 1.1. Their license files are bundled with the local assets. No external fonts are loaded.