{"id":401689,"date":"2026-11-18T14:56:21","date_gmt":"2026-11-18T14:56:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/hooky-live-chat-ai-agent\/"},"modified":"2026-11-18T14:55:54","modified_gmt":"2026-11-18T14:55:54","slug":"hooky-live-chat-ai-agent","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/hooky-live-chat-ai-agent\/","author":23602342,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.2","stable_tag":"1.0.2","tested":"7.1.5","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Hooky \u2013 Live Chat & AI Agent","header_author":"TheAppsFactory","header_description":"Adds the Hooky live chat bubble to every public page. Create your Hooky account from the settings page, answer visitors from the Hooky app or the web, and let the Hooky AI agent read your WooCommerce catalog.","last_updated":"2026-11-18 14:55:54","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/heyhooky.com\/en\/integrations\/wordpress\/","header_author_uri":"https:\/\/heyhooky.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":48,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"theappsfactory","date":"2026-11-18 14:55:54","revision":3809561}},"upgrade_notice":{"1.0.2":"<p>Translations now come from translate.wordpress.org.<\/p>","1.0.1":"<p>Translations follow the WordPress.org slug; clearer setup for existing Hooky accounts.<\/p>","1.0.0":"<p>First release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3809561,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3809561,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3809561,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3809561,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3809561,"resolution":"1","location":"assets","locale":"","width":1360,"height":1022},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3809561,"resolution":"2","location":"assets","locale":"","width":1360,"height":1000},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3809561,"resolution":"3","location":"assets","locale":"","width":1600,"height":1000}},"screenshots":{"1":"Settings \u203a Hooky with no account linked: create the account in one click, or paste an existing key.","2":"Settings \u203a Hooky once linked: the bubble is live, link to the Hooky dashboard.","3":"Answering visitors from the Hooky app on iPhone."}},"plugin_section":[],"plugin_tags":[5707,2364,2369,2379,286],"plugin_category":[41,45],"plugin_contributors":[293640],"plugin_business_model":[],"class_list":["post-401689","plugin","type-plugin","status-publish","hentry","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-customer-support","plugin_tags-live-chat","plugin_tags-woocommerce","plugin_category-communication","plugin_category-ecommerce","plugin_contributors-theappsfactory","plugin_committers-theappsfactory"],"banners":{"banner":"https:\/\/ps.w.org\/hooky-live-chat-ai-agent\/assets\/banner-772x250.png?rev=3809561","banner_2x":"https:\/\/ps.w.org\/hooky-live-chat-ai-agent\/assets\/banner-1544x500.png?rev=3809561","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/hooky-live-chat-ai-agent\/assets\/icon-128x128.png?rev=3809561","icon_2x":"https:\/\/ps.w.org\/hooky-live-chat-ai-agent\/assets\/icon-256x256.png?rev=3809561","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/hooky-live-chat-ai-agent\/assets\/screenshot-1.png?rev=3809561","caption":"Settings \u203a Hooky with no account linked: create the account in one click, or paste an existing key."},{"src":"https:\/\/ps.w.org\/hooky-live-chat-ai-agent\/assets\/screenshot-2.png?rev=3809561","caption":"Settings \u203a Hooky once linked: the bubble is live, link to the Hooky dashboard."},{"src":"https:\/\/ps.w.org\/hooky-live-chat-ai-agent\/assets\/screenshot-3.png?rev=3809561","caption":"Answering visitors from the Hooky app on iPhone."}],"raw_content":"<!--section=description-->\n<p>A visitor who hesitates asks their question while looking at the page. With Hooky, they type it into a chat bubble at the bottom of the screen, and you get a notification on your phone.<\/p>\n\n<p>This plugin connects your WordPress site to <a href=\"https:\/\/heyhooky.com\/en\/\">Hooky<\/a>, a live chat service. Everything happens in your WordPress admin:<\/p>\n\n<ul>\n<li><strong>Set up in one click.<\/strong> In Settings \u203a Hooky, check your email, tick the consent box and click \"Create my Hooky account\". Hooky creates your free account and registers your site; the bubble shows up right away. You then activate the account from the email you receive (link valid 7 days).<\/li>\n<li><strong>Already have a Hooky account?<\/strong> Paste the key of your site (24 letters and digits) and save.<\/li>\n<li><strong>Reply from anywhere.<\/strong> iPhone, iPad, Mac and Android apps, plus the web dashboard. Visitors can attach a photo, and if they leave their email, your reply follows them by email.<\/li>\n<li><strong>Automatic translation.<\/strong> Messages arrive in your language, your replies go out in theirs.<\/li>\n<li><strong>An AI agent that knows your site<\/strong> (Hooky paid plans). Give the agent the address of your site in Hooky: it reads your pages and answers visitors, then hands over to you when it does not know.<\/li>\n<li><strong>WooCommerce catalog, nothing to set up.<\/strong> On a WooCommerce store, the AI agent reads your products (name, price, stock, link, picture, summary) from the public WooCommerce Store API and answers with product cards. Compatible with High-Performance Order Storage and the Cart &amp; Checkout blocks; the plugin never touches orders or the cart.<\/li>\n<li><strong>Lightweight.<\/strong> One asynchronous script on public pages only, isolated in a Shadow DOM: it does not change your theme. Nothing loads in the admin, and nothing is added to your pages until a site is linked.<\/li>\n<\/ul>\n\n<p>The plugin is free and has no locked features. The Hooky service is free for one site; its paid plans (more sites, team, AI agent) are subscribed on heyhooky.com, never inside WordPress.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to Hooky, a live chat service run by TheAppsFactory (France). It is needed to show the chat bubble and to create your Hooky account.<\/p>\n\n<p><strong>1. Account creation (api.heyhooky.com)<\/strong>, only when an administrator ticks the consent box and clicks \"Create my Hooky account\" in Settings \u203a Hooky. The plugin sends one request, <code>POST https:\/\/api.heyhooky.com\/v1\/agent\/signup<\/code>, with:<\/p>\n\n<ul>\n<li>the email address typed in the form (prefilled with the administrator's);<\/li>\n<li>the address of the site (<code>home_url<\/code>) and its name (Settings \u203a General \u203a Site Title);<\/li>\n<li>the administrator's language (for example <code>fr_FR<\/code>), so the activation email is in that language;<\/li>\n<li>a user agent with the plugin, WordPress and WooCommerce versions (for example <code>HookyWordPress\/1.0.1 (WordPress 7.1; WooCommerce 10.0)<\/code>).<\/li>\n<\/ul>\n\n<p>Hooky returns the public key of the new site, which the plugin saves, and sends an activation email to that address. The plugin makes no other request from your server: nothing is sent on activation, on page views, or when you paste an existing key.<\/p>\n\n<p><strong>2. The chat bubble (heyhooky.com)<\/strong>, once a site is linked. Every public page loads the script <code>https:\/\/heyhooky.com\/widget.js<\/code> with the public key of your site. The visitor's browser then talks to <code>https:\/\/api.heyhooky.com<\/code>: it loads the bubble's settings, and sends the messages, photos, name and email the visitor chooses to type, plus the address of the page and the browser language; Hooky also records that the bubble was shown on your domain and clicks on product cards of the AI agent. No cookie is set; the bubble keeps the visitor's conversation token in the browser's local storage.<\/p>\n\n<p><strong>3. The AI agent (optional, Hooky paid plans).<\/strong> When you give the agent the address of your site in Hooky, Hooky's crawler (<code>HookyBot\/1.0<\/code>) reads your public pages and, on WooCommerce, your public product list (<code>\/wp-json\/wc\/store\/v1\/products<\/code>). This happens from Hooky's servers, not from the plugin.<\/p>\n\n<ul>\n<li>Terms of use: https:\/\/heyhooky.com\/en\/terms\/ (French: https:\/\/heyhooky.com\/cgu\/)<\/li>\n<li>Privacy policy: https:\/\/heyhooky.com\/en\/privacy\/ (French: https:\/\/heyhooky.com\/confidentialite\/)<\/li>\n<\/ul>\n\n<p>As the site owner, mention the chat in your own privacy policy: Hooky processes your visitors' messages on your behalf.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>In WordPress, go to Plugins \u203a Add New, search for \"Hooky\", then Install and Activate. (Or upload the zip in Plugins \u203a Add New \u203a Upload Plugin.)<\/li>\n<li>Go to Settings \u203a Hooky.<\/li>\n<li>No Hooky account yet: check your email, tick the box to accept Hooky's terms and privacy policy, and click \"Create my Hooky account\". The bubble is live. Open the email you receive to activate your account (link valid 7 days).<\/li>\n<li>Already have an account: in Hooky, add your site under Sites, open \"Install the bubble\", copy the <code>data-site-key<\/code> value and paste it in \"I already have a Hooky account\" \u203a Link this site.<\/li>\n<li>Answer your visitors from the Hooky app or from https:\/\/heyhooky.com\/espace\/.<\/li>\n<\/ol>\n\n<p>If you use a caching plugin, clear its cache so the bubble appears on cached pages.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20it%20free%3F\"><h3>Is it free?<\/h3><\/dt>\n<dd><p>Yes. The plugin is free and complete. The Hooky service is free for one site; paid plans add more sites, a team and the AI agent. They are handled on heyhooky.com.<\/p><\/dd>\n<dt id=\"can%20i%20create%20the%20account%20from%20wordpress%3F\"><h3>Can I create the account from WordPress?<\/h3><\/dt>\n<dd><p>Yes, in Settings \u203a Hooky. The site is registered with the domain of your WordPress site. Hooky needs a real domain name: on <code>localhost<\/code> or an IP address, create the account on heyhooky.com and paste the site key instead.<\/p><\/dd>\n<dt id=\"i%20did%20not%20receive%20the%20activation%20email.\"><h3>I did not receive the activation email.<\/h3><\/dt>\n<dd><p>Check your spam folder. The link is valid 7 days; an account never activated is deleted with its messages. If you already have a Hooky account, the activation page lets you add this site to it.<\/p><\/dd>\n<dt id=\"does%20the%20ai%20agent%20read%20my%20woocommerce%20products%3F\"><h3>Does the AI agent read my WooCommerce products?<\/h3><\/dt>\n<dd><p>Yes, through the public WooCommerce Store API of your site (up to 1,000 products). This needs pretty permalinks and WordPress at the root of the domain. If a security plugin blocks the REST API for visitors, or your site is in a sub-folder, export your products (WooCommerce \u203a Products \u203a Export) and attach the CSV file in Hooky (Sites \u203a your site \u203a AI agent \u203a Product file).<\/p><\/dd>\n<dt id=\"where%20does%20the%20bubble%20show%3F\"><h3>Where does the bubble show?<\/h3><\/dt>\n<dd><p>On every public page, checkout included, once a site is linked. Developers can hide it on some pages with the <code>hooky_show_bubble<\/code> filter (return <code>false<\/code>).<\/p><\/dd>\n<dt id=\"how%20do%20i%20change%20the%20colour%20or%20position%20of%20the%20bubble%3F\"><h3>How do I change the colour or position of the bubble?<\/h3><\/dt>\n<dd><p>In Hooky: Sites \u203a your site. The bubble reads its settings on each page load; nothing changes in WordPress.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20i%20deactivate%20or%20delete%20the%20plugin%3F\"><h3>What happens when I deactivate or delete the plugin?<\/h3><\/dt>\n<dd><p>Deactivating removes the bubble. Deleting the plugin also removes its settings from the database. Your Hooky account and its conversations are kept on Hooky; delete them from the Hooky dashboard if you wish.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20multisite%3F\"><h3>Does it work with multisite?<\/h3><\/dt>\n<dd><p>Yes: each site of the network links its own Hooky site.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>New settings page: the three steps to get started, a preview of the bubble, clearer forms.<\/li>\n<li>A clear message when Hooky limits sign-up attempts.<\/li>\n<li>Translations are delivered by translate.wordpress.org: no translation files bundled, no manual text domain loading.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Text domain and folder follow the WordPress.org slug (hooky-live-chat-ai-agent).<\/li>\n<li>The settings page points to the existing-account option, and explains that the activation email can add this site to an existing Hooky account.<\/li>\n<li>Nonce checks are explicit in every form handler. Tested up to WordPress 7.1.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release: chat bubble on public pages, Hooky account creation from the admin (with consent), existing key linking, WooCommerce catalog read by the AI agent through the Store API, clean uninstall. English and French.<\/li>\n<\/ul>","raw_excerpt":"Live chat bubble on every page, answered from your phone. Create your Hooky account from WordPress; the AI agent reads your WooCommerce catalog.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/401689","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=401689"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/theappsfactory"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=401689"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=401689"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=401689"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=401689"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=401689"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=401689"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}