{"id":290428,"date":"2026-03-23T12:22:32","date_gmt":"2026-03-23T12:22:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/flexible-chat\/"},"modified":"2026-03-23T12:21:57","modified_gmt":"2026-03-23T12:21:57","slug":"flexible-chat","status":"publish","type":"plugin","link":"https:\/\/scn.wordpress.org\/plugins\/flexible-chat\/","author":14143337,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.0","stable_tag":"1.0.0","tested":"6.9.4","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"Flexible Chat","header_author":"WP Desk","header_description":"Bridge between WordPress and the n8n chat.","assets_banners_color":"","last_updated":"2026-03-23 12:21:57","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/wpdesk.net\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":54,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"wpdesk","date":"2026-03-23 12:21:57"}},"upgrade_notice":{"1.0.0":"<p>Welcome to Flexible Chat! Configure your webhook URL in the settings to get started.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"General Settings \u2013 Configure your webhook URL and conversation topics.","2":"Appearance Customization \u2013 Change colors, typography, and window dimensions.","3":"Text Customization \u2013 Set your chat title, placeholder, and initial bot welcome messages.","4":"Advanced Configuration \u2013 Enable streaming, file uploads, persistent history, and custom metadata.","5":"The chat widget active on the frontend, featuring welcome messages and topic selection.","6":"Real-time chat interface showing user messages and streaming bot responses."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[90336,5707,2364,2379,243637],"plugin_category":[41],"plugin_contributors":[83562],"plugin_business_model":[],"class_list":["post-290428","plugin","type-plugin","status-publish","hentry","plugin_tags-ai-chat","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-live-chat","plugin_tags-n8n","plugin_category-communication","plugin_contributors-wpdesk","plugin_committers-wpdesk"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/flexible-chat.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>\u2605\u2605\u2605\u2605\u2605<\/p>\n\n<h3>The best way to connect AI chatbots to WordPress and WooCommerce<\/h3>\n\n<p>Do you want to add an AI assistant, customer support bot, or automated chat to your WooCommerce store or WordPress site?\nThe <strong>Flexible Chat<\/strong> plugin lets you:<\/p>\n\n<p>\u2013 Seamlessly connect any n8n HTTP webhook endpoint to a beautiful frontend chat interface.\n\u2013 Engage users with real-time streaming responses (like ChatGPT).\n\u2013 Route conversations effectively by asking visitors to select a topic before chatting.\n\u2013 Fully customize the chat appearance, colors, texts, and behavior without any coding.<\/p>\n\n<h3>Key features<\/h3>\n\n<p>\u2013 <strong>Seamless Webhook Integration:<\/strong> Connects instantly to your n8n workflows via a simple webhook URL.\n\u2013 <strong>Streaming Responses:<\/strong> Show bot responses in real-time as they are being generated for a faster, more engaging user experience.\n\u2013 <strong>Topic Routing:<\/strong> Suggest conversation topics (e.g., \"Sales\", \"Support\") and send the selected topic to your backend to route the chat to the right AI agent.\n\u2013 <strong>File Uploads:<\/strong> Allow users to share files and images, with strict MIME type security restrictions.\n\u2013 <strong>Message Feedback:<\/strong> Enable \ud83d\udc4d \/ \ud83d\udc4e buttons under bot responses so users can rate the AI's answers.\n\u2013 <strong>Persistent Chat History:<\/strong> Remember conversation history across sessions so users don't lose context when navigating your site.\n\u2013 <strong>Custom Metadata:<\/strong> Send advanced context data to n8n with every message (e.g., user ID, current page, or subscription plan) using a custom JSON payload.\n\u2013 <strong>Compliance Notice:<\/strong> Add an AI disclosure or privacy reminder right below the chat input.<\/p>\n\n<h3>Advanced Customization<\/h3>\n\n<p>\u2013 <strong>Brand Colors &amp; Typography:<\/strong> Built-in color pickers for primary colors, backgrounds, and text, with automatic contrast adjustments. Adjust font sizes and border radius to match your theme.\n\u2013 <strong>Custom Texts &amp; Welcome Messages:<\/strong> Tailor the window header, subtitles, input placeholders, and initial bot greeting messages.\n\u2013 <strong>Window &amp; Toggle Sizing:<\/strong> Adjust the exact width and height of the open chat window, and choose between small, normal, or large floating toggle buttons.\n\u2013 <strong>Developer Friendly:<\/strong> Fully restyle the widget using CSS custom properties (variables) or deterministic class hooks. Features a DI-driven architecture and Vite dev-server support for local HMR.<\/p>\n\n<h3>\ud83d\udee0 Easy setup \u2013 no coding required<\/h3>\n\n<ol>\n<li>Install and activate the plugin.<\/li>\n<li>Go to <strong>Settings \u2192 Flexible Chat Settings<\/strong>.<\/li>\n<li>Paste your n8n Webhook URL in the General tab.<\/li>\n<li>Customize your colors, texts, and welcome messages.<\/li>\n<li>Save changes \u2013 and your chat widget is live!<\/li>\n<\/ol>\n\n<h3>\ud83d\udcda Documentation &amp; Support<\/h3>\n\n<p>If you have questions or need assistance, please use the <a href=\"https:\/\/wordpress.org\/support\/plugin\/flexible-chat\/\"><strong>official plugin forums<\/strong><\/a> at WP.org.<\/p>\n\n<h3>Why choose Flexible Chat?<\/h3>\n\n<p>\u2013 100% free core features.\n\u2013 Built and maintained by the trusted WP Desk team.\n\u2013 Highly optimized, lightweight React-based frontend.\n\u2013 Compatible with the latest WordPress and WooCommerce versions.\n\u2013 Actively developed and secure.<\/p>\n\n<h3>\ud83d\udd12 Data use policy<\/h3>\n\n<p>Learn more about our <a href=\"https:\/\/wpdesk.net\/use-of-data-policy\/\">Use of Data Policy by WP Desk Plugins<\/a><\/p>\n\n<p>Download it for free today and bring powerful automation directly to your WordPress frontend!<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20an%20n8n%20account%20to%20use%20this%20plugin%3F\"><h3>Do I need an n8n account to use this plugin?<\/h3><\/dt>\n<dd><p>Yes. This plugin provides the frontend customer chat interface for WordPress, but it requires an active n8n instance (Cloud or Self-Hosted) with a configured webhook workflow to process the messages and reply.<\/p><\/dd>\n<dt id=\"does%20it%20support%20real-time%20streaming%20like%20chatgpt%3F\"><h3>Does it support real-time streaming like ChatGPT?<\/h3><\/dt>\n<dd><p>Yes! You can enable \"Streaming Responses\" in the Advanced settings tab. Your n8n workflow and AI nodes must also be configured to output streaming responses for this to work.<\/p><\/dd>\n<dt id=\"can%20i%20change%20the%20chat%20bubble%20colors%20to%20match%20my%20brand%3F\"><h3>Can I change the chat bubble colors to match my brand?<\/h3><\/dt>\n<dd><p>Absolutely. The Appearance tab in the plugin settings allows you to use color pickers to customize the primary color, bot message background, user message background, and text colors.<\/p><\/dd>\n<dt id=\"can%20i%20pass%20user%20data%20%28like%20email%20or%20user%20id%29%20to%20my%20workflow%3F\"><h3>Can I pass user data (like email or user ID) to my workflow?<\/h3><\/dt>\n<dd><p>Yes. Using the \"Custom Metadata\" feature in the Advanced settings, you can define a JSON payload that gets sent to your webhook with every chat request. This is perfect for passing user context, referring pages, or business data.<\/p><\/dd>\n<dt id=\"is%20it%20possible%20to%20ask%20the%20user%20what%20they%20want%20to%20talk%20about%20first%3F\"><h3>Is it possible to ask the user what they want to talk about first?<\/h3><\/dt>\n<dd><p>Yes! You can configure \"Suggested Topics\" (e.g., Technical Support, Billing, Sales). Users will be required to click a topic pill before the chat begins, and this selection is sent to your webhook for smart routing.<\/p><\/dd>\n<dt id=\"are%20coding%20skills%20needed%20to%20use%20the%20plugin%3F\"><h3>Are coding skills needed to use the plugin?<\/h3><\/dt>\n<dd><p>Not at all! You can set up and customize the entire chat widget directly from the WordPress admin panel.<\/p><\/dd>\n<dt id=\"where%20do%20i%20report%20security%20bugs%20found%20in%20this%20plugin%3F\"><h3>Where do I report security bugs found in this plugin?<\/h3><\/dt>\n<dd><p>Please report security bugs found in the source code of the Flexible Chat plugin through the <a href=\"https:\/\/patchstack.com\/database\/vdp\/wpdesk\">Patchstack Vulnerability Disclosure Program<\/a>. The Patchstack team will assist you with verification, CVE assignment, and notify our developers.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial public release of Flexible Chat.<\/li>\n<li>Added support for real-time streaming responses.<\/li>\n<li>Added customizable UI (colors, typography, dimensions).<\/li>\n<li>Added topic routing and persistent chat history.<\/li>\n<li>Added file upload and message feedback (upvote\/downvote) support.<\/li>\n<\/ul>","raw_excerpt":"Meet Flexible Chat. A lightweight, fully customizable bridge between your WordPress site and your n8n AI workflows.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/290428","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=290428"}],"author":[{"embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/wpdesk"}],"wp:attachment":[{"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=290428"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=290428"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=290428"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=290428"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=290428"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/scn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=290428"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}