{"id":271187,"date":"2026-01-08T03:49:29","date_gmt":"2026-01-08T03:49:29","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/chatkit\/"},"modified":"2026-01-09T01:07:40","modified_gmt":"2026-01-09T01:07:40","slug":"migkapa-agent-chat","status":"publish","type":"plugin","link":"https:\/\/cn.wordpress.org\/plugins\/migkapa-agent-chat\/","author":21172580,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.2.1","stable_tag":"0.2.1","tested":"6.9.4","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"Migkapa Agent Chat","header_author":"migkapa","header_description":"Embed OpenAI ChatKit (Agent Builder) chat widgets via a Gutenberg block, shortcode, or floating widget. Unofficial third-party plugin - not affiliated with OpenAI.","assets_banners_color":"ebccb7","last_updated":"2026-01-09 01:07:40","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/github.com\/migkapa","rating":0,"author_block_rating":0,"active_installs":0,"downloads":187,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.0":{"tag":"0.1.0","author":"migkapa","date":"2026-01-08 03:49:22"},"0.1.1":{"tag":"0.1.1","author":"migkapa","date":"2026-01-08 04:28:18"},"0.2.0":{"tag":"0.2.0","author":"migkapa","date":"2026-01-09 01:00:01"},"0.2.1":{"tag":"0.2.1","author":"migkapa","date":"2026-01-09 01:07:40"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3434857,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3434857,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3434857,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3434857,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"migkapa-agent-chat\/widget":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"migkapa-agent-chat\/widget","title":"Migkapa Agent Chat","category":"widgets","icon":"format-chat","description":"Embed an OpenAI ChatKit widget connected to an Agent Builder workflow.","textdomain":"migkapa-agent-chat","attributes":{"height":{"type":"number","default":600},"width":{"type":"number","default":320},"workflowId":{"type":"string","default":""},"className":{"type":"string","default":""}},"supports":{"html":false},"editorScript":"file:.\/build\/index.js","editorStyle":"file:.\/build\/index.css","style":"file:.\/build\/style-index.css","render":"file:.\/render.php"}},"tagged_versions":["0.1.0","0.1.1","0.2.0","0.2.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3435562,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3435562,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3435562,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3435562,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3435562,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3435562,"resolution":"6","location":"assets","locale":""}},"screenshots":{"1":"Floating chat widget on your website - clean, minimal design that doesn't distract from your content","2":"Starter prompts help visitors begin conversations with suggested questions","3":"Active conversation with the AI assistant showing real-time responses","4":"Admin settings - Configure floating widget position, size, custom icon, mobile visibility, and auto-open delay","5":"Admin settings - Customize the start screen greeting, prompts, and theme appearance","6":"Admin settings - Usage documentation with shortcode examples and live widget preview"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2353,1220,5707,2364,148076],"plugin_category":[41],"plugin_contributors":[224369],"plugin_business_model":[],"class_list":["post-271187","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-block","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-gutenberg","plugin_category-communication","plugin_contributors-migkapa","plugin_committers-migkapa"],"banners":{"banner":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/banner-772x250.png?rev=3434857","banner_2x":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/banner-1544x500.png?rev=3434857","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/icon-128x128.png?rev=3434857","icon_2x":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/icon-256x256.png?rev=3434857","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/screenshot-1.png?rev=3435562","caption":"Floating chat widget on your website - clean, minimal design that doesn't distract from your content"},{"src":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/screenshot-2.png?rev=3435562","caption":"Starter prompts help visitors begin conversations with suggested questions"},{"src":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/screenshot-3.png?rev=3435562","caption":"Active conversation with the AI assistant showing real-time responses"},{"src":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/screenshot-4.png?rev=3435562","caption":"Admin settings - Configure floating widget position, size, custom icon, mobile visibility, and auto-open delay"},{"src":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/screenshot-5.png?rev=3435562","caption":"Admin settings - Customize the start screen greeting, prompts, and theme appearance"},{"src":"https:\/\/ps.w.org\/migkapa-agent-chat\/assets\/screenshot-6.png?rev=3435562","caption":"Admin settings - Usage documentation with shortcode examples and live widget preview"}],"raw_content":"<!--section=description-->\n<p>Embed AI chat widgets powered by OpenAI Agent Builder on your WordPress site. Connect to workflows you create in OpenAI's Agent Builder platform, allowing you to add AI-powered chat assistants to any page.<\/p>\n\n<p><strong>Features:<\/strong><\/p>\n\n<ul>\n<li>Gutenberg block for easy placement<\/li>\n<li>Shortcode support: <code>[migkapa_agent_chat]<\/code><\/li>\n<li>Optional floating chat widget (site-wide)<\/li>\n<li>Customizable appearance (colors, size, position)<\/li>\n<li>Secure server-side API key handling<\/li>\n<\/ul>\n\n<p>This plugin creates chat sessions <strong>server-side<\/strong> using your OpenAI API key and workflow ID, then returns a <code>client_secret<\/code> to the browser. Your OpenAI API key is never exposed to visitors.<\/p>\n\n<h3>Requirements<\/h3>\n\n<ul>\n<li>An OpenAI account with API access<\/li>\n<li>An Agent Builder workflow (see setup instructions below)<\/li>\n<li>An OpenAI API key with Agent Builder permissions<\/li>\n<li>Your website domain added to OpenAI's domain allowlist (see installation instructions)<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<p>This plugin connects to OpenAI's servers to provide AI chat functionality.<\/p>\n\n<p><strong>OpenAI API<\/strong> (https:\/\/api.openai.com)<\/p>\n\n<ul>\n<li>Purpose: Creates chat sessions and processes chat messages<\/li>\n<li>Data sent: API key (server-side only), workflow ID, chat messages, session metadata<\/li>\n<li><a href=\"https:\/\/openai.com\/policies\/terms-of-use\">Terms of Use<\/a><\/li>\n<li><a href=\"https:\/\/openai.com\/policies\/privacy-policy\">Privacy Policy<\/a><\/li>\n<\/ul>\n\n<p><strong>OpenAI CDN<\/strong> (https:\/\/cdn.platform.openai.com)<\/p>\n\n<ul>\n<li>Purpose: Loads the chat web component script<\/li>\n<li>Data sent: Standard HTTP request headers<\/li>\n<li><a href=\"https:\/\/openai.com\/policies\/terms-of-use\">Terms of Use<\/a><\/li>\n<li><a href=\"https:\/\/openai.com\/policies\/privacy-policy\">Privacy Policy<\/a><\/li>\n<\/ul>\n\n<p>You should disclose this external data transmission in your site's privacy policy.<\/p>\n\n<h3>Shortcode<\/h3>\n\n<pre><code>[migkapa_agent_chat height=\"600\" width=\"320\" workflow=\"wf_...\" classname=\"my-class\"]\n<\/code><\/pre>\n\n<ul>\n<li><code>workflow<\/code> is optional; if omitted, the global Workflow ID from settings is used.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<p><strong>Step 1: Install the Plugin<\/strong><\/p>\n\n<ol>\n<li>Upload the <code>migkapa-agent-chat<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install directly from the WordPress plugin directory<\/li>\n<li>Activate the plugin through the \"Plugins\" menu<\/li>\n<\/ol>\n\n<p><strong>Step 2: Get Your OpenAI Credentials<\/strong><\/p>\n\n<ol>\n<li>Create an OpenAI account at <a href=\"https:\/\/platform.openai.com\">platform.openai.com<\/a> if you don't have one<\/li>\n<li>Set up billing at <a href=\"https:\/\/platform.openai.com\/account\/billing\">platform.openai.com\/account\/billing<\/a><\/li>\n<li>Create an API key at <a href=\"https:\/\/platform.openai.com\/api-keys\">platform.openai.com\/api-keys<\/a><\/li>\n<li>Go to Agent Builder and create a workflow (or use an existing one)<\/li>\n<li>Copy the Workflow ID (starts with <code>wf_<\/code>) from your workflow settings<\/li>\n<\/ol>\n\n<p><strong>Step 3: Add Your Domain to OpenAI's Allowlist (Required)<\/strong><\/p>\n\n<p>This is a critical step! OpenAI requires you to register your website domain before the chat widget will work. Without this, visitors will see a \"Domain verification failed\" error.<\/p>\n\n<ol>\n<li>Go to <a href=\"https:\/\/platform.openai.com\/settings\/organization\/security\/domain-allowlist\">platform.openai.com\/settings\/organization\/security\/domain-allowlist<\/a><\/li>\n<li>Log in to your OpenAI account if prompted<\/li>\n<li>Click \"Add domain\"<\/li>\n<li>Enter your website domain exactly as it appears in your browser's address bar (e.g., <code>example.com<\/code>)<\/li>\n<li>Click Save<\/li>\n<\/ol>\n\n<p><strong>Important tips:<\/strong><\/p>\n\n<ul>\n<li>Add both <code>example.com<\/code> AND <code>www.example.com<\/code> if your site is accessible via both<\/li>\n<li>For staging\/development sites, add those domains too (e.g., <code>staging.example.com<\/code>)<\/li>\n<li>The domain must match exactly - if you use <code>www.example.com<\/code>, add that specific version<\/li>\n<li>Changes take effect immediately - no need to wait<\/li>\n<\/ul>\n\n<p><strong>Step 4: Configure the Plugin<\/strong><\/p>\n\n<ol>\n<li>Go to <strong>Settings &gt; Migkapa Agent Chat<\/strong> in your WordPress admin<\/li>\n<li>Enter your OpenAI API key<\/li>\n<li>Enter your Workflow ID<\/li>\n<li>Click \"Save Settings\" - the plugin will validate your credentials<\/li>\n<\/ol>\n\n<p><strong>Step 5: Add the Chat Widget to Your Site<\/strong><\/p>\n\n<ul>\n<li><strong>Block Editor:<\/strong> Add the \"Migkapa Agent Chat\" block to any page or post<\/li>\n<li><strong>Shortcode:<\/strong> Use <code>[migkapa_agent_chat]<\/code> in the classic editor or widgets<\/li>\n<li><strong>Floating Widget:<\/strong> Enable in Settings &gt; Migkapa Agent Chat for a site-wide chat bubble<\/li>\n<\/ul>\n\n<!--section=faq-->\n<dl>\n<dt id='what%20is%20openai%20agent%20builder%3F'><h3>What is OpenAI Agent Builder?<\/h3><\/dt>\n<dd><p>Agent Builder is OpenAI's platform for creating custom AI assistants. You can configure your agent's personality, connect it to knowledge bases (files, websites), and define its capabilities. Visit <a href=\"https:\/\/platform.openai.com\">platform.openai.com<\/a> and look for \"Agent Builder\" or \"Agents\" in the navigation.<\/p><\/dd>\n<dt id='how%20do%20i%20get%20an%20openai%20api%20key%3F'><h3>How do I get an OpenAI API key?<\/h3><\/dt>\n<dd><ol>\n<li>Go to <a href=\"https:\/\/platform.openai.com\/api-keys\">platform.openai.com\/api-keys<\/a><\/li>\n<li>Click \"Create new secret key\"<\/li>\n<li>Give it a name (e.g., \"WordPress Migkapa Agent Chat\")<\/li>\n<li>Copy the key immediately (it won't be shown again)<\/li>\n<li>Ensure your account has billing set up and credits available<\/li>\n<\/ol><\/dd>\n<dt id='how%20do%20i%20create%20a%20workflow%20and%20get%20the%20workflow%20id%3F'><h3>How do I create a workflow and get the Workflow ID?<\/h3><\/dt>\n<dd><ol>\n<li>Go to <a href=\"https:\/\/platform.openai.com\">platform.openai.com<\/a><\/li>\n<li>Navigate to <strong>Agent Builder<\/strong> (or \"Agents\" in the sidebar)<\/li>\n<li>Click <strong>Create<\/strong> to start a new workflow<\/li>\n<li>Configure your agent:\n\n<ul>\n<li>Set a name and instructions<\/li>\n<li>Optionally add knowledge sources (files, websites)<\/li>\n<li>Choose a model (GPT-4o recommended)<\/li>\n<\/ul><\/li>\n<li>Click <strong>Deploy<\/strong> or <strong>Publish<\/strong> when ready<\/li>\n<li>Find the <strong>Workflow ID<\/strong> in the workflow settings or URL - it starts with <code>wf_<\/code><\/li>\n<\/ol><\/dd>\n<dt id='does%20this%20store%20my%20openai%20api%20key%20in%20the%20database%3F'><h3>Does this store my OpenAI API key in the database?<\/h3><\/dt>\n<dd><p>Yes. The key is stored in WordPress options so the server can create chat sessions. The key is never sent to browsers or exposed to visitors.<\/p><\/dd>\n<dt id='can%20i%20use%20multiple%20workflows%20on%20different%20pages%3F'><h3>Can I use multiple workflows on different pages?<\/h3><\/dt>\n<dd><p>Yes. Set a default workflow in Settings, then override it per-block or per-shortcode using the <code>workflow<\/code> parameter:<\/p>\n\n<pre><code>[migkapa_agent_chat workflow=\"wf_different_workflow_id\"]\n<\/code><\/pre><\/dd>\n<dt id='can%20i%20change%20the%20chat%20script%20url%3F'><h3>Can I change the chat script URL?<\/h3><\/dt>\n<dd><p>Yes. Developers can use the <code>migkapa_agent_chat_script_src<\/code> filter to override the script URL.<\/p><\/dd>\n<dt id='i%20see%20%22domain%20verification%20failed%22%20error.%20how%20do%20i%20fix%20it%3F'><h3>I see \"Domain verification failed\" error. How do I fix it?<\/h3><\/dt>\n<dd><p>This error means your domain is not on OpenAI's allowlist. Here's how to fix it:<\/p>\n\n<ol>\n<li>Check your browser's address bar to see your exact domain (e.g., <code>www.example.com<\/code> or <code>example.com<\/code>)<\/li>\n<li>Go to <a href=\"https:\/\/platform.openai.com\/settings\/organization\/security\/domain-allowlist\">platform.openai.com\/settings\/organization\/security\/domain-allowlist<\/a><\/li>\n<li>Log in if prompted<\/li>\n<li>Click \"Add domain\"<\/li>\n<li>Enter your domain <strong>exactly<\/strong> as shown in your address bar<\/li>\n<li>Save the changes<\/li>\n<\/ol>\n\n<p><strong>Common issues:<\/strong><\/p>\n\n<ul>\n<li>You added <code>example.com<\/code> but your site uses <code>www.example.com<\/code> (or vice versa) - add both versions<\/li>\n<li>You're testing on localhost or a staging domain - add those domains too<\/li>\n<li>Typo in the domain name - double-check the spelling<\/li>\n<\/ul>\n\n<p>The fix takes effect immediately - just refresh your page.<\/p><\/dd>\n<dt id='the%20chat%20widget%20is%20not%20loading.%20what%20should%20i%20check%3F'><h3>The chat widget is not loading. What should I check?<\/h3><\/dt>\n<dd><ol>\n<li><strong>Check domain allowlist first<\/strong> - Go to your browser console (F12) and look for \"Domain verification failed\" error. If present, add your domain to OpenAI's allowlist (see FAQ above)<\/li>\n<li>Verify your API key is correct in Settings &gt; Migkapa Agent Chat<\/li>\n<li>Confirm your Workflow ID starts with <code>wf_<\/code><\/li>\n<li>Check that your OpenAI account has available credits<\/li>\n<li>Look for other errors in your browser's developer console (F12)<\/li>\n<li>Ensure the workflow is deployed\/published in Agent Builder<\/li>\n<\/ol><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.2.1<\/h4>\n\n<ul>\n<li>Added screenshots to WordPress.org plugin page<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Added live widget preview in admin settings page<\/li>\n<li>Added custom chat button icon upload<\/li>\n<li>Added \"Hide on mobile\" toggle for floating widget<\/li>\n<li>Added auto-open delay setting (widget opens automatically after X seconds)<\/li>\n<li>Added custom CSS textarea for advanced styling<\/li>\n<li>Added click-outside-to-close behavior for floating widget<\/li>\n<li>Added shortcode documentation and usage guide in settings<\/li>\n<li>Improved admin UI with two-column layout<\/li>\n<\/ul>\n\n<h4>0.1.1<\/h4>\n\n<ul>\n<li>Improved domain allowlist instructions in settings page - now shows your actual domain<\/li>\n<li>Added helpful tips about www vs non-www domains<\/li>\n<li>Enhanced FAQ and installation instructions for domain setup<\/li>\n<li>Fixed deployment workflow<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Embed OpenAI Agent Builder workflows into WordPress via a Gutenberg block, shortcode, and optional floating widget.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/271187","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=271187"}],"author":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/migkapa"}],"wp:attachment":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=271187"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=271187"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=271187"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=271187"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=271187"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=271187"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}