{"id":395882,"date":"2026-11-13T15:52:22","date_gmt":"2026-11-13T15:52:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ragently-ai-chat\/"},"modified":"2026-11-13T15:51:51","modified_gmt":"2026-11-13T15:51:51","slug":"ragently-ai-chat","status":"publish","type":"plugin","link":"https:\/\/he.wordpress.org\/plugins\/ragently-ai-chat\/","author":23594082,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.4","requires":"5.0","requires_php":"7.4","requires_plugins":null,"header_name":"Ragently AI Chat","header_author":"Ragently","header_description":"Adds your Ragently AI chat assistant to your WordPress site. Enter your chat key, tick \"Show chat\", done.","last_updated":"2026-11-13 15:51:51","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/ragently.nl\/?utm_source=wordpress_org&utm_medium=plugin&utm_campaign=chat","rating":0,"author_block_rating":0,"active_installs":0,"downloads":85,"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":"ragently","date":"2026-11-13 15:51:51","revision":3800731}},"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[2353,5707,2364,2368,2379],"plugin_category":[41],"plugin_contributors":[288897],"plugin_business_model":[],"class_list":["post-395882","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-customer-service","plugin_tags-live-chat","plugin_category-communication","plugin_contributors-ragently","plugin_committers-ragently"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/ragently-ai-chat.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Ragently AI Chat puts the AI chat assistant you built in Ragently on your WordPress site. Visitors ask questions and get answers based on your own information.<\/p>\n\n<ul>\n<li><strong>Quick setup<\/strong>: enter your chat key, tick \"Show chat\" and save. The chat button appears on your pages.<\/li>\n<li><strong>You decide where it shows<\/strong>: in your Ragently dashboard you list the websites on which your chat may appear. On any other site the chat stays hidden.<\/li>\n<li><strong>WooCommerce<\/strong>: on a WooCommerce shop that is connected to Ragently you can leave the key empty; the chat then loads for your shop automatically.<\/li>\n<li><strong>Works with caching plugins<\/strong>: the script carries the attributes that tell WP Rocket, Cloudflare Rocket Loader and similar plugins not to combine or rewrite it.<\/li>\n<li><strong>Clear status in wp-admin<\/strong>: if the chat will not show (chat switched off, no key, unknown key, chat not published, this site not on your list, outside your subscription, or Ragently unreachable), the plugin says so on the Plugins page, the dashboard and its settings screen.<\/li>\n<\/ul>\n\n<p>The plugin contains no chat logic and no tracking of its own. It only adds the Ragently loader script to your pages.<\/p>\n\n<p>You need a Ragently account with an AI chat. Your chat key is in your Ragently dashboard.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to the Ragently service (https:\/\/ragently.nl\/?utm_source=wordpress_org&amp;utm_medium=plugin&amp;utm_campaign=chat), which provides the AI chat and processes the conversations. Without it the plugin cannot work.<\/p>\n\n<ul>\n<li><strong>Loader and widget (in the visitor's browser).<\/strong> On pages where the chat is shown, the visitor's browser loads the loader script <code>https:\/\/api.ragently.nl\/chat-widget\/loader.js<\/code> and then the chat widget from api.ragently.nl. Like any request, these requests include the visitor's IP address and browser information.<\/li>\n<li><strong>Visitor messages and related requests.<\/strong> All of these go to api.ragently.nl: the messages the visitor types (<code>\/chats<\/code>, <code>\/queue-message<\/code>, <code>\/chat-messages<\/code>), requests to hand the conversation to a staff member (<code>\/human-status<\/code>, <code>\/cancel-human<\/code>), files the visitor attaches (<code>\/chats\/&lt;id&gt;\/attachments<\/code>), a rating or the end of the conversation (<code>\/chat\/rate<\/code>, <code>\/chat\/auto-end<\/code>), a short-lived token and the widget settings (<code>\/widget-token<\/code>, <code>\/widget-config<\/code>), and, on shops connected to Ragently, the customer check and order requests the visitor starts in the chat (<code>\/verify-customer<\/code>, <code>\/shopify\/widget\/draft-order<\/code>). The conversation is stored by Ragently for the site owner.<\/li>\n<li><strong>Random visitor ID.<\/strong> The loader stores a random visitor ID (<code>ragently_uid<\/code>) in the visitor's browser (localStorage), so that a returning visitor keeps the same conversation. It contains no personal data.<\/li>\n<li><strong>Chat session data in the browser.<\/strong> The widget also keeps, in localStorage under keys starting with <code>ragently:<\/code>, the ID and token of the visitor's current chat session, a visitor ID for the conversation (<code>chat_end_user_id<\/code>), the time the conversation started (<code>chat_created_at<\/code>) and its last activity (<code>chat_last_activity<\/code>), and (on shops) the contents of the visitor's chat shopping cart, so that the conversation survives a page reload. No tracking cookies are set.<\/li>\n<li><strong>Live connection.<\/strong> Once a conversation has started, the widget keeps a socket connection (WebSocket) to api.ragently.nl to receive replies, for example when a staff member takes over.<\/li>\n<li><strong>Key check (from your WordPress server).<\/strong> In wp-admin (Plugins page, dashboard and the plugin's settings screen), the plugin checks at most once every five minutes whether this site is covered by your chat. This request sends only your chat key and the site address (home URL) to api.ragently.nl. Without a key, on a WooCommerce shop, it sends only the shop address.<\/li>\n<\/ul>\n\n<p>Ragently terms of service: https:\/\/ragently.nl\/voorwaarden\nRagently privacy policy: https:\/\/ragently.nl\/privacy<\/p>\n\n<!--section=installation-->\n<ol>\n<li>In WordPress, go to Plugins &gt; Add New, search for \"Ragently AI Chat\" and click Install Now, then Activate.<\/li>\n<li>Go to Settings &gt; Ragently AI Chat.<\/li>\n<li>Enter your chat key (from your Ragently dashboard) and tick \"Show chat\". Save.<\/li>\n<li>Make sure this website is on the list of websites of your chat in the Ragently dashboard.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20i%20find%20my%20chat%20key%3F\"><h3>Where do I find my chat key?<\/h3><\/dt>\n<dd><p>In your Ragently dashboard, where you put the chat on your website.<\/p><\/dd>\n<dt id=\"why%20don%27t%20i%20see%20the%20chat%3F\"><h3>Why don't I see the chat?<\/h3><\/dt>\n<dd><p>Look at the Plugins page or the dashboard in wp-admin: the plugin shows a notice that says why. Common causes: \"Show chat\" is off, the key is wrong, the chat is not published yet, or this website is not on the list of websites of your chat in the Ragently dashboard.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20caching%20plugins%20such%20as%20wp%20rocket%3F\"><h3>Does it work with caching plugins such as WP Rocket?<\/h3><\/dt>\n<dd><p>Yes. The script carries the attributes that tell these plugins not to combine or rewrite it.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release: settings screen, the Ragently chat loader on your pages with anti-cache attributes, WooCommerce fallback without a key, and status notices in wp-admin.<\/li>\n<li>English source text, ready for translations via translate.wordpress.org.<\/li>\n<\/ul>","raw_excerpt":"Add your Ragently AI chat assistant to your WordPress site: enter your chat key, tick \"Show chat\", done.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/395882","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=395882"}],"author":[{"embeddable":true,"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ragently"}],"wp:attachment":[{"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=395882"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=395882"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=395882"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=395882"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=395882"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/he.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=395882"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}