{"id":379210,"date":"2026-10-04T08:46:48","date_gmt":"2026-10-04T08:46:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/hazelchat\/"},"modified":"2026-10-15T17:41:37","modified_gmt":"2026-10-15T17:41:37","slug":"hazelchat","status":"publish","type":"plugin","link":"https:\/\/el.wordpress.org\/plugins\/hazelchat\/","author":23577857,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.1","stable_tag":"1.0.1","tested":"7.1.3","requires":"6.3","requires_php":"7.4","requires_plugins":null,"header_name":"Hazelchat","header_author":"Hazelchat","header_description":"Add your Hazelchat website agent to WordPress. Answer from reviewed sources and offer visitors a next step.","assets_banners_color":"f6f2ea","last_updated":"2026-10-15 17:41:37","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/hazelchat.co","rating":0,"author_block_rating":0,"active_installs":0,"downloads":306,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"hazelchat","date":"2026-10-04 08:46:31","revision":3727193},"1.0.1":{"tag":"1.0.1","author":"hazelchat","date":"2026-10-15 17:41:37","revision":3749053}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3727193,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3727193,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3727193,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3727193,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3749053,"resolution":"1","location":"assets","locale":"","width":1280,"height":1100},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3749053,"resolution":"2","location":"assets","locale":"","width":1440,"height":900}},"screenshots":{"1":"Settings &gt; Hazelchat on a new installation: create a free account or log in, then paste your installation code, accept the service connection and switch on loading. Shown with an empty test installation.","2":"The Hazelchat chat on a WordPress page, answering from approved content and showing its source. Shown in source-only mode, which quotes the content; fictional test site."}},"plugin_section":[],"plugin_tags":[191735,5707,2364,2369,332],"plugin_category":[41,45],"plugin_contributors":[284285],"plugin_business_model":[],"class_list":["post-379210","plugin","type-plugin","status-publish","hentry","plugin_tags-ai-chatbot","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-customer-support","plugin_tags-sales","plugin_category-communication","plugin_category-ecommerce","plugin_contributors-hazelchat","plugin_committers-hazelchat"],"banners":{"banner":"https:\/\/ps.w.org\/hazelchat\/assets\/banner-772x250.png?rev=3727193","banner_2x":"https:\/\/ps.w.org\/hazelchat\/assets\/banner-1544x500.png?rev=3727193","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/hazelchat\/assets\/icon-128x128.png?rev=3727193","icon_2x":"https:\/\/ps.w.org\/hazelchat\/assets\/icon-256x256.png?rev=3727193","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/hazelchat\/assets\/screenshot-1.png?rev=3749053","caption":"Settings &gt; Hazelchat on a new installation: create a free account or log in, then paste your installation code, accept the service connection and switch on loading. Shown with an empty test installation."},{"src":"https:\/\/ps.w.org\/hazelchat\/assets\/screenshot-2.png?rev=3749053","caption":"The Hazelchat chat on a WordPress page, answering from approved content and showing its source. Shown in source-only mode, which quotes the content; fictional test site."}],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<p>You choose what it reads and check its answers in Hazelchat before anything goes live.<\/p>\n\n<h4>Get started<\/h4>\n\n<ol>\n<li><a href=\"https:\/\/app.hazelchat.co\/signup?utm_source=wordpress&amp;utm_medium=listing&amp;utm_campaign=readme\">Create a free Hazelchat account<\/a> and add your website. Pick the pages it should answer from and try a few questions.<\/li>\n<li>Install this plugin. Under Settings &gt; Hazelchat, paste the installation code from Hazelchat and switch loading on.<\/li>\n<li>In Hazelchat, click Publish and switch on.<\/li>\n<\/ol>\n\n<p>The free plan covers one website and 50 answers a month. Paid plans add more answers, enquiry emails and more websites: <a href=\"https:\/\/hazelchat.co\/pricing\/\">pricing<\/a>.<\/p>\n\n<h4>What the plugin does<\/h4>\n\n<ul>\n<li>A field for your installation code or public widget key, with strict validation. Only the 64-character key is kept.<\/li>\n<li>An explicit switch to load the widget on public pages.<\/li>\n<li>An optional connection gate for your visitor consent manager.<\/li>\n<li>A link back to Hazelchat to check installation and test your published agent.<\/li>\n<\/ul>\n\n<p>Activation alone does not load the hosted service. 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<p>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<h3>External service<\/h3>\n\n<p>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<p>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, orders or private pages, and performs no server-to-server service requests or activation telemetry.<\/p>\n\n<p>The optional visitor-consent setting still allows the small launcher script to download; it prevents creation of the chat frame, chat API requests and session-storage access until your consent manager dispatches hazelchat-consent with detail: true. A consent manager must be connected separately. To block all external downloads before consent, configure your consent manager to block the launcher script as well. Turning consent off removes the widget but does not erase records already held by Hazelchat.<\/p>\n\n<p>Service terms: https:\/\/hazelchat.co\/terms\/\nPrivacy notice: https:\/\/hazelchat.co\/privacy\/\nData processing agreement: https:\/\/hazelchat.co\/dpa\/<\/p>\n\n<h3>Credits<\/h3>\n\n<p>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<!--section=installation-->\n<ol>\n<li>In WordPress, go to Plugins &gt; Add New Plugin, search for Hazelchat, install and activate it.<\/li>\n<li><a href=\"https:\/\/app.hazelchat.co\/signup?utm_source=wordpress&amp;utm_medium=listing&amp;utm_campaign=install\">Create a free Hazelchat account<\/a> (or log in), add your content, check the details and try your agent. Under Website &gt; Installation, add the website's domain.<\/li>\n<li>Copy the installation code. The plugin keeps only its 64-character data-agent value, the public widget key.<\/li>\n<li>Open WordPress Settings &gt; Hazelchat. Paste the installation code or the key, accept the hosted-service connection, enable loading, and save. Connect your consent manager first if using the optional gate.<\/li>\n<li>Remove any older manually pasted Hazelchat script and clear your page cache.<\/li>\n<li>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<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20publish%20my%20agent%20or%20verify%20my%20website%20automatically%3F\"><h3>Does this publish my agent or verify my website automatically?<\/h3><\/dt>\n<dd><p>No. Complete publishing, domain verification, enablement and the real website test in Hazelchat. The plugin only installs the public widget script.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20page%20builders%20and%20woocommerce%3F\"><h3>Does it work with page builders and WooCommerce?<\/h3><\/dt>\n<dd><p>It adds a footer script using WordPress's normal script API. Themes must call wp_footer(). It does not import private WooCommerce data, retrieve orders or manage carts. Individual builder, commerce and optimization-plugin combinations require testing.<\/p><\/dd>\n<dt id=\"why%20is%20my%20widget%20missing%3F\"><h3>Why is my widget missing?<\/h3><\/dt>\n<dd><p>Check 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 needs the consent event after the script loads. WordPress admin, feeds, JSON requests and draft previews do not load the widget.<\/p><\/dd>\n<dt id=\"how%20do%20i%20connect%20my%20consent%20manager%3F\"><h3>How do I connect my consent manager?<\/h3><\/dt>\n<dd><p>After consent is granted, run:<\/p>\n\n<p>window.dispatchEvent(new CustomEvent('hazelchat-consent', { detail: true }));<\/p>\n\n<p>On revocation, dispatch the same event with detail: false. Dispatch after the widget script loads, including when consent was already granted on a previous visit. This plugin does not install or configure a consent manager and makes no claim of legal compliance.<\/p><\/dd>\n<dt id=\"what%20happens%20on%20deactivation%20or%20deletion%3F\"><h3>What happens on deactivation or deletion?<\/h3><\/dt>\n<dd><p>Deactivation 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<dt id=\"can%20i%20use%20it%20on%20wordpress.com%3F\"><h3>Can I use it on WordPress.com?<\/h3><\/dt>\n<dd><p>Only 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<!--section=changelog-->\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Settings: a \"Create a free account\" and \"Log in\" link while no key is saved.<\/li>\n<li>Paste the whole installation code: the plugin keeps only its public widget key.<\/li>\n<li>Links to Hazelchat carry campaign tags so signups from the plugin can be counted.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>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:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/379210","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=379210"}],"author":[{"embeddable":true,"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/hazelchat"}],"wp:attachment":[{"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=379210"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=379210"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=379210"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=379210"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=379210"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/el.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=379210"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}