Title: Migkapa Agent Chat
Author: migkapa
Published: <strong>2026-يىلى 8-يانۋار</strong>
Last modified: 2026-يىلى 9-يانۋار

---

قىستۇرما ئىزدە

![](https://ps.w.org/migkapa-agent-chat/assets/banner-772x250.png?rev=3434857)

![](https://ps.w.org/migkapa-agent-chat/assets/icon-256x256.png?rev=3434857)

# Migkapa Agent Chat

 يازغۇچى [migkapa](https://profiles.wordpress.org/migkapa/)

[چۈشۈر](https://downloads.wordpress.org/plugin/migkapa-agent-chat.0.2.1.zip)

 * [تەپسىلاتلار](https://ug.wordpress.org/plugins/migkapa-agent-chat/#description)
 * [باھالاشلار](https://ug.wordpress.org/plugins/migkapa-agent-chat/#reviews)
 *  [ئورنىتىش](https://ug.wordpress.org/plugins/migkapa-agent-chat/#installation)
 * [ئىجادىيەت](https://ug.wordpress.org/plugins/migkapa-agent-chat/#developers)

 [قوللاش](https://wordpress.org/support/plugin/migkapa-agent-chat/)

## چۈشەندۈرۈش

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.

**Features:**

 * Gutenberg block for easy placement
 * Shortcode support: `[migkapa_agent_chat]`
 * Optional floating chat widget (site-wide)
 * Customizable appearance (colors, size, position)
 * Secure server-side API key handling

This plugin creates chat sessions **server-side** using your OpenAI API key and 
workflow ID, then returns a `client_secret` to the browser. Your OpenAI API key 
is never exposed to visitors.

### Requirements

 * An OpenAI account with API access
 * An Agent Builder workflow (see setup instructions below)
 * An OpenAI API key with Agent Builder permissions
 * Your website domain added to OpenAI’s domain allowlist (see installation instructions)

### External Services

This plugin connects to OpenAI’s servers to provide AI chat functionality.

**OpenAI API** (https://api.openai.com)

 * Purpose: Creates chat sessions and processes chat messages
 * Data sent: API key (server-side only), workflow ID, chat messages, session metadata
 * [Terms of Use](https://openai.com/policies/terms-of-use)
 * [Privacy Policy](https://openai.com/policies/privacy-policy)

**OpenAI CDN** (https://cdn.platform.openai.com)

 * Purpose: Loads the chat web component script
 * Data sent: Standard HTTP request headers
 * [Terms of Use](https://openai.com/policies/terms-of-use)
 * [Privacy Policy](https://openai.com/policies/privacy-policy)

You should disclose this external data transmission in your site’s privacy policy.

### Shortcode

    ```
    [migkapa_agent_chat height="600" width="320" workflow="wf_..." classname="my-class"]
    ```

 * `workflow` is optional; if omitted, the global Workflow ID from settings is used.

## ئېكران كەسمىسى

 * [[
 * Floating chat widget on your website – clean, minimal design that doesn’t distract
   from your content
 * [[
 * Starter prompts help visitors begin conversations with suggested questions
 * [[
 * Active conversation with the AI assistant showing real-time responses
 * [[
 * Admin settings – Configure floating widget position, size, custom icon, mobile
   visibility, and auto-open delay
 * [[
 * Admin settings – Customize the start screen greeting, prompts, and theme appearance
 * [[
 * Admin settings – Usage documentation with shortcode examples and live widget 
   preview

## بۆلەك

بۇ قىستۇرما 1 بۆلەك تەمىنلەيدۇ.

 *   Migkapa Agent Chat Embed an OpenAI ChatKit widget connected to an Agent Builder
   workflow.

## ئورنىتىش

**Step 1: Install the Plugin**

 1. Upload the `migkapa-agent-chat` folder to `/wp-content/plugins/`, or install directly
    from the WordPress plugin directory
 2. Activate the plugin through the «Plugins» menu

**Step 2: Get Your OpenAI Credentials**

 1. Create an OpenAI account at [platform.openai.com](https://platform.openai.com) 
    if you don’t have one
 2. Set up billing at [platform.openai.com/account/billing](https://platform.openai.com/account/billing)
 3. Create an API key at [platform.openai.com/api-keys](https://platform.openai.com/api-keys)
 4. Go to Agent Builder and create a workflow (or use an existing one)
 5. Copy the Workflow ID (starts with `wf_`) from your workflow settings

**Step 3: Add Your Domain to OpenAI’s Allowlist (Required)**

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.

 1. Go to [platform.openai.com/settings/organization/security/domain-allowlist](https://platform.openai.com/settings/organization/security/domain-allowlist)
 2. Log in to your OpenAI account if prompted
 3. Click «Add domain»
 4. Enter your website domain exactly as it appears in your browser’s address bar (
    e.g., `example.com`)
 5. Click Save

**Important tips:**

 * Add both `example.com` AND `www.example.com` if your site is accessible via both
 * For staging/development sites, add those domains too (e.g., `staging.example.
   com`)
 * The domain must match exactly – if you use `www.example.com`, add that specific
   version
 * Changes take effect immediately – no need to wait

**Step 4: Configure the Plugin**

 1. Go to **Settings > Migkapa Agent Chat** in your WordPress admin
 2. Enter your OpenAI API key
 3. Enter your Workflow ID
 4. Click «Save Settings» – the plugin will validate your credentials

**Step 5: Add the Chat Widget to Your Site**

 * **Block Editor:** Add the «Migkapa Agent Chat» block to any page or post
 * **Shortcode:** Use `[migkapa_agent_chat]` in the classic editor or widgets
 * **Floating Widget:** Enable in Settings > Migkapa Agent Chat for a site-wide 
   chat bubble

## FAQ

### What is OpenAI Agent Builder?

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 [platform.openai.com](https://platform.openai.com) and look
for «Agent Builder» or «Agents» in the navigation.

### How do I get an OpenAI API key?

 1. Go to [platform.openai.com/api-keys](https://platform.openai.com/api-keys)
 2. Click «Create new secret key»
 3. Give it a name (e.g., «WordPress Migkapa Agent Chat»)
 4. Copy the key immediately (it won’t be shown again)
 5. Ensure your account has billing set up and credits available

### How do I create a workflow and get the Workflow ID?

 1. Go to [platform.openai.com](https://platform.openai.com)
 2. Navigate to **Agent Builder** (or «Agents» in the sidebar)
 3. Click **Create** to start a new workflow
 4. Configure your agent:
 5.  * Set a name and instructions
     * Optionally add knowledge sources (files, websites)
     * Choose a model (GPT-4o recommended)
 6. Click **Deploy** or **Publish** when ready
 7. Find the **Workflow ID** in the workflow settings or URL – it starts with `wf_`

### Does this store my OpenAI API key in the database?

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.

### Can I use multiple workflows on different pages?

Yes. Set a default workflow in Settings, then override it per-block or per-shortcode
using the `workflow` parameter:

    ```
    [migkapa_agent_chat workflow="wf_different_workflow_id"]
    ```

### Can I change the chat script URL?

Yes. Developers can use the `migkapa_agent_chat_script_src` filter to override the
script URL.

### I see «Domain verification failed» error. How do I fix it?

This error means your domain is not on OpenAI’s allowlist. Here’s how to fix it:

 1. Check your browser’s address bar to see your exact domain (e.g., `www.example.com`
    or `example.com`)
 2. Go to [platform.openai.com/settings/organization/security/domain-allowlist](https://platform.openai.com/settings/organization/security/domain-allowlist)
 3. Log in if prompted
 4. Click «Add domain»
 5. Enter your domain **exactly** as shown in your address bar
 6. Save the changes

**Common issues:**

 * You added `example.com` but your site uses `www.example.com` (or vice versa) –
   add both versions
 * You’re testing on localhost or a staging domain – add those domains too
 * Typo in the domain name – double-check the spelling

The fix takes effect immediately – just refresh your page.

### The chat widget is not loading. What should I check?

 1. **Check domain allowlist first** – 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)
 2. Verify your API key is correct in Settings > Migkapa Agent Chat
 3. Confirm your Workflow ID starts with `wf_`
 4. Check that your OpenAI account has available credits
 5. Look for other errors in your browser’s developer console (F12)
 6. Ensure the workflow is deployed/published in Agent Builder

## باھالاشلار

بۇ قىستۇرمىغا تېخى باھا يېزىلمىدى.

## تۆھپىكار ۋە ئىجادكار

«Migkapa Agent Chat» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا تۆھپە
قوشقان.

تۆھپىكار

 *   [ migkapa ](https://profiles.wordpress.org/migkapa/)

[«Migkapa Agent Chat» نى تىلىڭىزغا تەرجىمە قىلىڭ](https://translate.wordpress.org/projects/wp-plugins/migkapa-agent-chat)

### ئىجادىيەتكە قىزىقامسىز؟

[كودقا كۆز يۈگۈرتۈپ](https://plugins.trac.wordpress.org/browser/migkapa-agent-chat/)،
[SVN خەزىنە](https://plugins.svn.wordpress.org/migkapa-agent-chat/) تەكشۈرۈپ ياكى
[RSS](https://plugins.trac.wordpress.org/log/migkapa-agent-chat/?limit=100&mode=stop_on_copy&format=rss)
ئارقىلىق [ئىجادىيەت خاتىرىسى](https://plugins.trac.wordpress.org/log/migkapa-agent-chat/)
گە مۇشتەرى بولغىلى بولىدۇ.

## ئۆزگىرىش خاتىرىسى

#### 0.2.1

 * Added screenshots to WordPress.org plugin page

#### 0.2.0

 * Added live widget preview in admin settings page
 * Added custom chat button icon upload
 * Added «Hide on mobile» toggle for floating widget
 * Added auto-open delay setting (widget opens automatically after X seconds)
 * Added custom CSS textarea for advanced styling
 * Added click-outside-to-close behavior for floating widget
 * Added shortcode documentation and usage guide in settings
 * Improved admin UI with two-column layout

#### 0.1.1

 * Improved domain allowlist instructions in settings page – now shows your actual
   domain
 * Added helpful tips about www vs non-www domains
 * Enhanced FAQ and installation instructions for domain setup
 * Fixed deployment workflow

#### 0.1.0

 * Initial release.

## Meta

 *  Version **0.2.1**
 *  ئاخىرقى يېڭىلانغان ۋاقىت **3 ئاي بۇرۇن**
 *  ئاكتىپ ئورنىتىش سانى **10 دىن ئاز**
 *  WordPress نەشرى ** 6.2 ياكى يۇقىرى **
 *  **6.9.4** دا سىنالغان
 *  PHP نەشرى ** 7.4 ياكى يۇقىرى **
 *  تىل
 * [English (US)](https://wordpress.org/plugins/migkapa-agent-chat/)
 * بەلگە
 * [AI](https://ug.wordpress.org/plugins/tags/ai/)[block](https://ug.wordpress.org/plugins/tags/block/)
   [chat](https://ug.wordpress.org/plugins/tags/chat/)[chatbot](https://ug.wordpress.org/plugins/tags/chatbot/)
   [gutenberg](https://ug.wordpress.org/plugins/tags/gutenberg/)
 *  [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/migkapa-agent-chat/advanced/)

## دەرىجە

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/migkapa-agent-chat/reviews/#new-post)

[بارلىق ئىنكاسنى كۆرسەت](https://wordpress.org/support/plugin/migkapa-agent-chat/reviews/)

## تۆھپىكار

 *   [ migkapa ](https://profiles.wordpress.org/migkapa/)

## قوللاش

چۈشەندۈرۈشىڭىز بارمۇ؟ ياردەم لازىممۇ؟

 [قوللاش مۇنبىرىنى كۆرسەت](https://wordpress.org/support/plugin/migkapa-agent-chat/)