Title: BitBloom Chatbot for Chatkit Author: BitBloom Published: Ноябрь 15, 2025-ж. Last modified: Декабрь 30, 2025-ж. --- Плагиндерди издөө ![](https://ps.w.org/bitbloom-chatbot-for-chatkit/assets/banner-772x250.png?rev= 3396302) ![](https://ps.w.org/bitbloom-chatbot-for-chatkit/assets/icon-256x256.png?rev=3396302) # BitBloom Chatbot for Chatkit Автору [BitBloom](https://profiles.wordpress.org/ishchai/) [Жүктөө](https://downloads.wordpress.org/plugin/bitbloom-chatbot-for-chatkit.1.2.2.zip) * [Кенен маалымат](https://ky.wordpress.org/plugins/bitbloom-chatbot-for-chatkit/#description) * [Сын-пикирлер](https://ky.wordpress.org/plugins/bitbloom-chatbot-for-chatkit/#reviews) * [Орнотуу](https://ky.wordpress.org/plugins/bitbloom-chatbot-for-chatkit/#installation) * [Development](https://ky.wordpress.org/plugins/bitbloom-chatbot-for-chatkit/#developers) [Колдоо](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/) ## Сүрөттөө **BitBloom Chatbot for Chatkit** lets you embed a published Agent Builder workflow into WordPress using OpenAI’s ChatKit UI. Features 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). **Highlights** – Floating ChatKit launcher or inline embed via shortcode. – One- time setup: paste your _Workflow ID_ and _Domain Public Key_. – Theme controls: color scheme, accent, radius, density, font. – Secure: session created on the server; REST calls nonce-protected. – Rate limiting: configurable per-IP hourly limit for session requests (default 20/hour). – Privacy-friendly: user ID is a salted hash( no IP stored or sent by the plugin). **What you need from OpenAI** 1. A **published** Agent Builder workflow (copy its Workflow ID). 2. Your **Domain allowlist** and **Domain Public Key** (Security Domain allowlist). 3. Active billing/credits in your OpenAI account. ### Usage **Floating Launcher (auto)** – Once configured, the floating button appears on the front-end. Clicking it opens ChatKit bound to your published workflow. **Shortcode (inline chat)** Add to any post/page: [bitbloom_chatbot_for_chatkit] **Security** – The plugin uses `wp_rest` nonces for the session endpoint and never exposes your OpenAI API key in the browser. ### Privacy * The plugin computes an anonymized **user identifier** using a salt + user agent hash and **does not send IP**. * The plugin does **not** collect analytics or telemetry. * Data exchanged with OpenAI is limited to what’s required to run your configured workflow (message text, workflow ID, domain public key, and the anonymized user hash). * On uninstall, the option `bitbloom-chatbot-for-chatkit_options` is deleted. ### External services This plugin loads the ChatKit web component from OpenAI’s CDN and creates short- lived client sessions with OpenAI in order to render the chat UI. • Service: OpenAI ChatKit (web component & sessions API) • What for: Render the chat widget and let the agent run your workflow. • Endpoints: – CDN script: https:// cdn.platform.openai.com/deployments/chatkit/chatkit.js – Sessions API: https://api. openai.com/v1/chatkit/sessions • What is sent and when: – On page load, the browser downloads the ChatKit web component from the CDN. – When the user opens the chat, WordPress calls the Sessions API server-to-server to mint a short-lived client_secret. The request includes: * Your configured workflow ID * A non-identifying, hashed “ user” string derived from the site salt and the user agent (no PII) • Privacy & Terms: – OpenAI Terms: https://openai.com/policies/terms-of-use – OpenAI Privacy Policy: https://openai.com/policies/privacy-policy ## Орнотуу For a full video walkthrough of the installation and setup process: https://youtu. be/Kd0WxODDdYc 1. Download the ZIP and upload it via **Plugins Add New Upload Plugin**, or install it directly from the WordPress Plugin Directory. 2. Activate **BitBloom Chatbot for Chatkit**. 3. Add your OpenAI API key to wp-config.php: 4. define(‘OPENAI_API_KEY’, ‘sk-proj-xxxxxxxxxxxxxxxx’); 5. This key must NOT be placed in the plugin settings screen for security reasons. 6. Go to **BitBloom Chatbot for Chatkit** in the WordPress admin menu and configure: * **Workflow ID** (Found in OpenAI Agent Builder Publish Get Code) * **Domain Public Key** (Found in OpenAI Agent Builder Security Domain allowlist) 1. (Optional) Customize theme settings: 2. * Color scheme (light/dark) * Accent color * Corner radius * Density * Font 3. (Optional) Enable **Auto-inject** to display the floating chat launcher on all pages. 4. (Optional) To embed the chat inline inside a single page or post, use the shortcode: 5. [bitbloom_chatbot_for_chatkit] 6. (Optional) Adjust **Rate limit** (per IP / hour). Default is 20/hour. ## FAQ.KG ### The chat opens but doesn’t reply. What should I check? The most common causes are: – The workflow is not **published** in OpenAI’s Agent Builder. – The site domain is missing from the **Domain allowlist**. – Incorrect or missing **Domain Public Key**. – No available **OpenAI credits** in your account. ### Where do I put my OpenAI API key? Add it to your wp-config.php file: define(‘OPENAI_API_KEY’, ‘sk-proj-xxxxxxxx’); Do not place the API key in the browser or inside the plugin settings. ### Does the plugin store chat history or user messages? No. The plugin does not store any conversation data on your server. All communication is handled directly through the session created when the chat loads. ### Does the plugin send my API key to the browser? No. The API key remains server-side. All browser requests use a WordPress REST route protected by a nonce. ### Can I embed the chat inside a page instead of using the floating launcher? Yes. Use the shortcode: [bitbloom_chatbot_for_chatkit] ### Can I customize the look of the chat? Yes. You can change the color scheme (light/dark), accent color, radius, density, and font. ### Is there a usage/rate limit in the plugin? Yes. By default, the plugin limits session requests to 20 per hour per IP. You can change this in the plugin settings (Rate limit per IP / hour) to any value between 1 and 99999. ### The chat window shows an error when loading. What causes this? Usually one of the following: – Missing or invalid **Workflow ID** – Incorrect ** Domain Public Key** – The WordPress site is blocking REST requests – A security plugin is blocking nonces or AJAX ### Does the plugin support caching plugins? Yes. The launcher and UI are safe to cache, but the REST endpoints should remain uncached. If you use aggressive caching (e.g., LiteSpeed, Cloudflare APO), exclude:–/ wp-json/bitbloom-chatbot-for-chatkit/* ### Can I use multiple workflows on the same site? Yes. The shortcode supports multiple instances when placed on different pages. ### Does the plugin work on multisite? Yes, but each subsite must configure its own Workflow ID and Domain Public Key. ### Is this plugin GDPR-compliant? The plugin does not store personal data, but the site owner is responsible for ensuring: – A proper privacy notice – Compliance with data handling when using OpenAI services ## Сын-пикирлер ![](https://secure.gravatar.com/avatar/71eed7b0148232ee5a9559c2b3ae75ac606b7f7622d10e9daf412b4074163993? s=60&d=retro&r=g) ### 󠀁[Great and use full plugin](https://wordpress.org/support/topic/great-and-use-full-plugin/)󠁿 [stevendove](https://profiles.wordpress.org/stevendove/) Декабрь 28, 2025-ж. Hi everyone should try this plugin as it integrates OpenAI with wordpress, with no problems an very easy, I’ve tried multiple plugin an this one is the best I’ve installed, since it provide easy installation, easy configuration and easy to use. If anyone want to test it download it [ Read all 0 reviews ](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/reviews/) ## Contributors & Developers “BitBloom Chatbot for Chatkit” is open source software. The following people have contributed to this plugin. Мүчөлөрү * [ BitBloom ](https://profiles.wordpress.org/ishchai/) [Translate “BitBloom Chatbot for Chatkit” into your language.](https://translate.wordpress.org/projects/wp-plugins/bitbloom-chatbot-for-chatkit) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/bitbloom-chatbot-for-chatkit/), check out the [SVN repository](https://plugins.svn.wordpress.org/bitbloom-chatbot-for-chatkit/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/bitbloom-chatbot-for-chatkit/) by [RSS](https://plugins.trac.wordpress.org/log/bitbloom-chatbot-for-chatkit/?limit=100&mode=stop_on_copy&format=rss). ## Өзгөртүүлөр #### 1.2.2 * Improved launcher button rendering rules for avatar + text: - Default label appears only when both text and avatar are missing - Supports image-only launcher (no label) #### 1.2.1 * Added an admin setting to configure the per-IP hourly rate limit for session requests (default: 20/hour). #### 1.2.0 * Initial public release under the name “BitBloom ChatKit Embed”. ## Мета * Нуска **1.2.2** * Акыркы жаңыртуу **4 ай мурун** * Активдүү орнотуулар **20+** * WordPress нускасы ** 6.2 же андан жогору ** * Tested up to **6.9.4** * PHP нускасы ** 7.4 же андан жогору ** * Тил * [English (US)](https://wordpress.org/plugins/bitbloom-chatbot-for-chatkit/) * Тег: * [AI](https://ky.wordpress.org/plugins/tags/ai/)[chat](https://ky.wordpress.org/plugins/tags/chat/) [embed](https://ky.wordpress.org/plugins/tags/embed/)[openai](https://ky.wordpress.org/plugins/tags/openai/) * [Advanced View](https://ky.wordpress.org/plugins/bitbloom-chatbot-for-chatkit/advanced/) ## Рейтинг 5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/reviews/) ## Мүчөлөрү * [ BitBloom ](https://profiles.wordpress.org/ishchai/) ## Колдоо Комментарийлер барбы? Жардам керекпи? [Колдоо форумун көрүү](https://wordpress.org/support/plugin/bitbloom-chatbot-for-chatkit/)