Improves the launcher button logic (supports image-only launcher and smarter defaults).<\/p>","1.2.1":"
Adds a configurable rate limit setting (default 20\/hour).<\/p>","1.2.0":"
First stable release.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3396302,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3396302,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3396302,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3396302,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.2.0","1.2.1","1.2.2"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Admin settings screen<\/strong> \u2013 Configure Workflow ID, Domain Public Key, and chat theme.","2":"Agent embedded on a live site<\/strong> \u2013 The ChatKit widget opened on a WordPress page."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2353,5707,250736,230,194533],"plugin_category":[41,56],"plugin_contributors":[250737],"plugin_business_model":[],"class_list":["post-260518","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chat","plugin_tags-chatkit","plugin_tags-embed","plugin_tags-openai","plugin_category-communication","plugin_category-social-and-sharing","plugin_contributors-ishchai","plugin_committers-ishchai"],"banners":{"banner":"https:\/\/ps.w.org\/bitbloom-chatbot-for-chatkit\/assets\/banner-772x250.png?rev=3396302","banner_2x":"https:\/\/ps.w.org\/bitbloom-chatbot-for-chatkit\/assets\/banner-1544x500.png?rev=3396302","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/bitbloom-chatbot-for-chatkit\/assets\/icon-128x128.png?rev=3396302","icon_2x":"https:\/\/ps.w.org\/bitbloom-chatbot-for-chatkit\/assets\/icon-256x256.png?rev=3396302","generated":false},"screenshots":[],"raw_content":"\n BitBloom Chatbot for Chatkit<\/strong> lets you embed a published Agent Builder workflow into WordPress using OpenAI\u2019s ChatKit UI.\nFeatures a floating launcher, optional shortcode, theme controls (light\/dark, accent color, radius, density, font), and server-side session creation with REST nonces (no API key in the browser).<\/p>\n\n Highlights<\/strong>\n- Floating ChatKit launcher or inline embed via shortcode.\n- One-time setup: paste your Workflow ID<\/em> and Domain Public Key<\/em>.\n- Theme controls: color scheme, accent, radius, density, font.\n- Secure: session created on the server; REST calls nonce-protected.\n- Rate limiting: configurable per-IP hourly limit for session requests (default 20\/hour).\n- Privacy-friendly: user ID is a salted hash (no IP stored or sent by the plugin).<\/p>\n\n What you need from OpenAI<\/strong>\n1. A published<\/strong> Agent Builder workflow (copy its Workflow ID).\n2. Your Domain allowlist<\/strong> and Domain Public Key<\/strong> (Security \u2192 Domain allowlist).\n3. Active billing\/credits in your OpenAI account.<\/p>\n\n Floating Launcher (auto)<\/strong>\n- Once configured, the floating button appears on the front-end. Clicking it opens ChatKit bound to your published workflow.<\/p>\n\n Shortcode (inline chat)<\/strong>\nAdd to any post\/page:\n[bitbloom_chatbot_for_chatkit]<\/p>\n\n Security<\/strong>\n- The plugin uses This plugin loads the ChatKit web component from OpenAI\u2019s CDN and creates short-lived client sessions with OpenAI in order to render the chat UI.<\/p>\n\n \u2022 Service: OpenAI ChatKit (web component & sessions API)\n\u2022 What for: Render the chat widget and let the agent run your workflow.\n\u2022 Endpoints:\n - CDN script: https:\/\/cdn.platform.openai.com\/deployments\/chatkit\/chatkit.js\n - Sessions API: https:\/\/api.openai.com\/v1\/chatkit\/sessions\n\u2022 What is sent and when:\n - On page load, the browser downloads the ChatKit web component from the CDN.\n - When the user opens the chat, WordPress calls the Sessions API server-to-server to mint a short-lived client_secret. The request includes:\n * Your configured workflow ID\n * A non-identifying, hashed \u201cuser\u201d string derived from the site salt and the user agent (no PII)\n\u2022 Privacy & Terms:\n - OpenAI Terms: https:\/\/openai.com\/policies\/terms-of-use\n - OpenAI Privacy Policy: https:\/\/openai.com\/policies\/privacy-policy<\/p>\n\n\n For a full video walkthrough of the installation and setup process:\nhttps:\/\/youtu.be\/Kd0WxODDdYc<\/p>\n\n Download the ZIP and upload it via Plugins \u2192 Add New \u2192 Upload Plugin<\/strong>, \nor install it directly from the WordPress Plugin Directory.<\/p><\/li>\n Activate BitBloom Chatbot for Chatkit<\/strong>.<\/p><\/li>\n Add your OpenAI API key to wp-config.php:<\/p>\n\n define('OPENAI_API_KEY', 'sk-proj-xxxxxxxxxxxxxxxx');<\/p>\n\n This key must NOT be placed in the plugin settings screen for security reasons.<\/p><\/li>\n Go to BitBloom Chatbot for Chatkit<\/strong> in the WordPress admin menu and configure:<\/p><\/li>\n<\/ol>\n\n Workflow ID<\/strong> Domain Public Key<\/strong> (Optional) Customize theme settings:<\/p>\n\n (Optional) Enable Auto-inject<\/strong> to display the floating chat launcher on all pages.<\/p><\/li>\n (Optional) To embed the chat inline inside a single page or post, use the shortcode:<\/p>\n\n [bitbloom_chatbot_for_chatkit]<\/p><\/li>\n (Optional) Adjust Rate limit<\/strong> (per IP \/ hour). Default is 20\/hour.<\/p><\/li>\n<\/ol>\n\n\n The most common causes are:\n- The workflow is not published<\/strong> in OpenAI\u2019s Agent Builder.\n- The site domain is missing from the Domain allowlist<\/strong>.\n- Incorrect or missing Domain Public Key<\/strong>.\n- No available OpenAI credits<\/strong> in your account.<\/p><\/dd>\n Add it to your wp-config.php file:\ndefine('OPENAI_API_KEY', 'sk-proj-xxxxxxxx');\nDo not place the API key in the browser or inside the plugin settings.<\/p><\/dd>\n No. The plugin does not store any conversation data on your server. No. The API key remains server-side. Yes. Use the shortcode:\n[bitbloom_chatbot_for_chatkit]<\/p><\/dd>\n Yes. You can change the color scheme (light\/dark), accent color, radius, density, and font.<\/p><\/dd>\n Yes. By default, the plugin limits session requests to 20 per hour per IP.\nYou can change this in the plugin settings (Rate limit per IP \/ hour) to any value between 1 and 99999.<\/p><\/dd>\n Usually one of the following:\n- Missing or invalid Workflow ID<\/strong>\n- Incorrect Domain Public Key<\/strong>\n- The WordPress site is blocking REST requests\n- A security plugin is blocking nonces or AJAX<\/p><\/dd>\n Yes. The launcher and UI are safe to cache, but the REST endpoints should remain uncached. Yes. The shortcode supports multiple instances when placed on different pages.<\/p><\/dd>\n Yes, but each subsite must configure its own Workflow ID and Domain Public Key.<\/p><\/dd>\n The plugin does not store personal data, but the site owner is responsible for ensuring:\n- A proper privacy notice\n- Compliance with data handling when using OpenAI services<\/p><\/dd>\n\n<\/dl>\n\n\nUsage<\/h3>\n\n
wp_rest<\/code> nonces for the session endpoint and never exposes your OpenAI API key in the browser.<\/p>\n\nPrivacy<\/h3>\n\n
\n
bitbloom-chatbot-for-chatkit_options<\/code> is deleted.<\/li>\n<\/ul>\n\nExternal services<\/h3>\n\n
\n
\n
\n (Found in OpenAI \u2192 Agent Builder \u2192 Publish \u2192 Get Code)<\/p><\/li>\n
\n (Found in OpenAI \u2192 Agent Builder \u2192 Security \u2192 Domain allowlist)<\/p><\/li>\n<\/ul>\n\n\n
\n
\n
The chat opens but doesn\u2019t reply. What should I check?<\/h3><\/dt>\n
Where do I put my OpenAI API key?<\/h3><\/dt>\n
Does the plugin store chat history or user messages?<\/h3><\/dt>\n
\nAll communication is handled directly through the session created when the chat loads.<\/p><\/dd>\nDoes the plugin send my API key to the browser?<\/h3><\/dt>\n
\nAll browser requests use a WordPress REST route protected by a nonce.<\/p><\/dd>\nCan I embed the chat inside a page instead of using the floating launcher?<\/h3><\/dt>\n
Can I customize the look of the chat?<\/h3><\/dt>\n
Is there a usage\/rate limit in the plugin?<\/h3><\/dt>\n
The chat window shows an error when loading. What causes this?<\/h3><\/dt>\n
Does the plugin support caching plugins?<\/h3><\/dt>\n
\nIf you use aggressive caching (e.g., LiteSpeed, Cloudflare APO), exclude:\n- \/wp-json\/bitbloom-chatbot-for-chatkit\/*<\/p><\/dd>\nCan I use multiple workflows on the same site?<\/h3><\/dt>\n
Does the plugin work on multisite?<\/h3><\/dt>\n
Is this plugin GDPR-compliant?<\/h3><\/dt>\n
1.2.2<\/h4>\n\n
\n
\n
1.2.1<\/h4>\n\n
\n
1.2.0<\/h4>\n\n
\n