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.<\/li>\n<\/ul>\n\nActivation 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.<\/p>\n\n
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.<\/p>\n\n
External services<\/h3>\n\n
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\/<\/p>\n\n
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.<\/p>\n\n
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.<\/p>\n\n
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:<\/p>\n\n
\n- 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.<\/li>\n
- 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.<\/li>\n<\/ul>\n\n
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.<\/p>\n\n
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.<\/p>\n\n
Service terms: https:\/\/hazelchat.co\/terms\/\nPrivacy notice: https:\/\/hazelchat.co\/privacy\/\nData processing agreement: https:\/\/hazelchat.co\/dpa\/<\/p>\n\n
Credits<\/h3>\n\n
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.<\/p>\n\n\n
\n- In WordPress, go to Plugins > Add New Plugin, search for Hazelchat, install and activate it.<\/li>\n
- Create a free Hazelchat account<\/a> (or log in), add your content, check the details and try your agent. Under Website > Installation, add the website's domain.<\/li>\n
- Copy the installation code. The plugin keeps only its 64-character data-agent value, the public widget key.<\/li>\n
- Open WordPress Settings > Hazelchat. Paste the installation code or the key, accept the hosted-service connection, enable loading, and save. With a cookie banner, see \"Does it work with my cookie banner?\" below.<\/li>\n
- Remove any older manually pasted Hazelchat script and clear your page cache.<\/li>\n
- In Hazelchat, click Publish and switch on (Switch on Hazelchat if your published agent is unchanged). Installation is checked before the agent goes live. Refresh your website, then complete Test on your website.<\/li>\n<\/ol>\n\n\n
\nDoes this publish my agent or verify my website automatically?<\/h3><\/dt>\nNo. Complete publishing, domain verification, enablement and the real website test in Hazelchat. The plugin only installs the public widget script.<\/p><\/dd>\n
Does it work with page builders and WooCommerce?<\/h3><\/dt>\nIt adds a footer script using WordPress's normal script API. Themes must call wp_footer(). With WooCommerce, Hazelchat can show your published products in answers and add them to the visitor's cart through WooCommerce's Store API; connect your products in Hazelchat under Products. It never reads carts or customer data. Order tracking is optional and reports only orders that include something added from the chat (see External services). Individual builder, commerce and optimization-plugin combinations require testing.<\/p><\/dd>\n
What does order tracking show?<\/h3><\/dt>\nIn Hazelchat, Analytics shows \"Orders after a chat\": orders that include something added to the cart from the chat, as your shop reported them, with their order number so you can check each one in WooCommerce. A click is not an order, and an order after a chat does not prove the chat caused it.<\/p><\/dd>\n
Why is my widget missing?<\/h3><\/dt>\nCheck the public key, both enable switches, your published agent and allowed verified domain. Clear page caches. Exclude app.hazelchat.co\/widget.js from script combining, rewriting and delayed execution: the launcher needs its original script tag and data-agent attribute. A Content Security Policy must allow https:\/\/app.hazelchat.co in script-src and frame-src. A consent-gated installation waits for the visitor's consent in your cookie banner. WordPress admin, feeds, JSON requests and draft previews do not load the widget.<\/p><\/dd>\n
Does it work with my cookie banner?<\/h3><\/dt>\nWith Complianz there is nothing to do. In Real Cookie Banner, add a service named Hazelchat. In Borlabs Cookie, add a service named Hazelchat with the ID hazelchat and tick \"Wait for my cookie banner\" under Settings > Hazelchat. The chat loads once visitors agree to that service and disappears when they withdraw. The list of banners is at https:\/\/hazelchat.co\/integrations\/cookie-banners\/.<\/p>\n\n
For another banner, tick the box under More and have the banner run this once visitors agree, and again with detail: false when they withdraw:<\/p>\n\n
window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true }));<\/p>\n\n
Run it after the widget script loads, including when consent was given on an earlier visit. This plugin does not install a cookie banner and makes no claim of legal compliance.<\/p><\/dd>\n
What happens on deactivation or deletion?<\/h3><\/dt>\nDeactivation stops adding the script to newly generated pages and keeps settings for reactivation. Deletion removes the plugin's WordPress settings, including on each site in a multisite network. Clear page caches after disabling, deactivating, deleting or changing the key; cached pages and already-open browser tabs can retain the script. Pause the agent in Hazelchat to stop hosted requests immediately. Neither action deletes your Hazelchat account, sources or conversations or cancels a subscription.<\/p><\/dd>\n
Can I use it on WordPress.com?<\/h3><\/dt>\nOnly if your WordPress.com plan permits installing plugins. This plugin targets self-hosted WordPress and does not bypass hosting restrictions.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.2.0<\/h4>\n\n\n- Cookie banners: Hazelchat registers itself with Complianz, and the chat follows a service named Hazelchat in Real Cookie Banner, Borlabs Cookie and other common banners, with no code to add.<\/li>\n
- Settings: one sentence for the banner on your site; the wait box and the code for other banners are under More.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- WooCommerce: Add to cart from the chat's product cards, on the page, through WooCommerce's Store API.<\/li>\n
- Optional order tracking: after you type a code from Hazelchat, orders that include something added to the cart from the chat are reported to Hazelchat, signed and in the background. Off by default; see External services.<\/li>\n
- Uninstall also removes the order tracking connection.<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Settings: a \"Create a free account\" and \"Log in\" link while no key is saved.<\/li>\n
- Paste the whole installation code: the plugin keeps only its public widget key.<\/li>\n
- Links to Hazelchat carry campaign tags so signups from the plugin can be counted.<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- First version: validated public key, explicit loading, service disclosure, optional consent gate and site-local settings cleanup.<\/li>\n<\/ul>","raw_excerpt":"An AI chat agent that answers visitors from your own pages, shows its sources and collects enquiries. Free plan, no card needed.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/379210","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=379210"}],"author":[{"embeddable":true,"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/hazelchat"}],"wp:attachment":[{"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=379210"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=379210"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=379210"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=379210"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=379210"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/kaa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=379210"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}