Title: Airgentic AI Chat Overlay
Author: airgentic
Published: <strong>16 نوامبر 2025</strong>
Last modified: 24 سپتامبر 2026

---

جستجوی افزونه‌ها

![](https://ps.w.org/airgentic-ai-chat-overlay/assets/banner-772x250.png?rev=3396796)

این افزونه **با ۳ نگارش عمدهٔ اخیر وردپرس آزمایش نشده است**. ممکن است دیگر نگهداری
یا پشتیبانی نشود و هنگام استفاده با نگارش‌های تازه‌تر وردپرس مشکل سازگاری داشته 
باشد.

![](https://ps.w.org/airgentic-ai-chat-overlay/assets/icon-256x256.png?rev=3396796)

# Airgentic AI Chat Overlay

 توسط [airgentic](https://profiles.wordpress.org/airgentic/)

[دانلود](https://downloads.wordpress.org/plugin/airgentic-ai-chat-overlay.1.4.0.zip)

 * [جزئیات](https://fa.wordpress.org/plugins/airgentic-ai-chat-overlay/#description)
 * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/airgentic-ai-chat-overlay/#reviews)
 *  [نصب](https://fa.wordpress.org/plugins/airgentic-ai-chat-overlay/#installation)
 * [توسعه](https://fa.wordpress.org/plugins/airgentic-ai-chat-overlay/#developers)

 [پشتیبانی](https://wordpress.org/support/plugin/airgentic-ai-chat-overlay/)

## توضیحات

Airgentic is an AI-powered chat and site search service that helps visitors find
information and get cited answers.

This plugin loads the Airgentic script on your site and lets you choose how search
and chat appear.

#### Features

 * **Hover widget** – Chat launcher on every page after you enter your Account ID
   and Service ID
 * **Testing Mode** – New installs show Airgentic only to logged-in WordPress users
   until you go live
 * **Percentage rollout** – Optionally show the floating chat widget to a subset
   of visitors
 * **Service Hub** – Full-width chat on selected pages via `[airgentic_service_hub]`
 * **Inline Site Search** – A dedicated search results page using `[airgentic_search]`
 * **Overlay search** – Optional popup search bound to an existing search field
 * **WordPress search forms** – Optional rewrite of the Search block, Search widget,
   and theme search form
 * **No coding required** – Configure everything under Settings  Airgentic

#### How It Works

 1. Install and activate the plugin
 2. Enter your Airgentic Account ID and Service ID (from your Airgentic dashboard)
 3. Enable the widget on the front-end
 4. Stay logged in and preview the live site (Testing Mode is on for new installs)
 5. Turn Testing Mode off when you are ready for visitors
 6. Optionally add `[airgentic_service_hub]` on pages that should show the full chat
    window
 7. Optionally choose Inline search, create a Search page, and let the plugin point
    WordPress search forms at it

The plugin loads the Airgentic script on front-end pages (logged-in users only while
Testing Mode is on). Service Hub and Site Search only appear where you place a shortcode(
or matching HTML).

#### Use Cases

 * Website search with AI answers
 * Customer support and FAQ automation
 * Lead generation and qualification
 * Product information and recommendations

#### Support

For help and support, visit [www.airgentic.com](https://www.airgentic.com)

### External Services

This plugin connects to the Airgentic service to provide AI-powered chat and search
for your visitors.

#### What is Airgentic?

Airgentic is a third-party AI service that powers the chat overlay and search provided
by this plugin. The service is hosted at chat.airgentic.com and is required for 
the plugin to function.

#### What data is sent?

When visitors interact with the Airgentic widget, the following data is transmitted
to chat.airgentic.com:

 * User chat queries and search terms
 * Page URL where the widget is loaded
 * Browser timezone
 * IP address

This plugin does not collect or transmit cookies of its own. Airgentic may set a
first-party conversation cookie on your domain when persist-chat is enabled in the
Airgentic dashboard.

#### When is data sent?

Data is sent to the Airgentic service when a visitor:

 * Opens the chat or search widget
 * Types in an Airgentic-enhanced search field (autocomplete)
 * Submits a search or a chat question
 * Clicks an example question in the Service Hub

Data is only transmitted when visitors interact with the widget.

#### Legal Information

 * Terms of Service: https://www.airgentic.com/terms-of-service
 * Privacy Policy: https://www.airgentic.com/privacy-policy

By using this plugin, you agree to transmit visitor data to Airgentic as described
above. Please review Airgentic’s terms and privacy policy.

### Additional Information

#### Privacy & Data

The Airgentic plugin connects to external services hosted at chat.airgentic.com 
to provide chat and search. Please review Airgentic’s privacy policy for how data
is handled.

#### Requirements

 * WordPress 5.8 or higher
 * PHP 7.4 or higher
 * An active Airgentic account

#### Support & Documentation

 * Website: [https://www.airgentic.com](https://www.airgentic.com)
 * WordPress install guide: [https://www.airgentic.com/integrations/wordpress](https://www.airgentic.com/integrations/wordpress)
 * Site Search: [https://help.airgentic.com/help/site-search-website-integration](https://help.airgentic.com/help/site-search-website-integration)

## عکس‌های صفحه

[⌊Airgentic AI Customer Service⌉⌊Airgentic AI Customer Service⌉[

Airgentic AI Customer Service

[⌊Airgentic Search results⌉⌊Airgentic Search results⌉[

Airgentic Search results

[⌊Airgentic's Generative Engine Optimisation Advisor for making web pages more visible
to LLMs⌉⌊Airgentic's Generative Engine Optimisation Advisor for making web pages
more visible to LLMs⌉[

Airgentic’s Generative Engine Optimisation Advisor for making web pages more visible
to LLMs

## نصب

#### Automatic Installation

 1. Log in to your WordPress admin
 2. Go to **Plugins  Add New**
 3. Search for “Airgentic”
 4. Click **Install Now**, then **Activate**
 5. Go to **Settings  Airgentic**

#### Manual Installation

 1. Download the plugin ZIP
 2. Go to **Plugins  Add New  Upload Plugin**
 3. Choose the ZIP and click **Install Now**
 4. Activate the plugin
 5. Go to **Settings  Airgentic**

#### Configuration

 1. Go to **Settings  Airgentic**
 2. Enter your **Account ID** and **Service ID** (required)
 3. Check **Enable on Front-end**
 4. For Site Search, choose a **Search mode**:
 5.  * **Inline search** (recommended): click **Create Search page** (or add `[airgentic_search]`
       to a page), keep the form rewrite options checked, and save
     * **Overlay search**: enter the HTML id or class of your search input in **Non-
       WordPress search input**
     * **Disabled**: chat only
 6. Click **Save Settings**
 7. Preview while logged in (Testing Mode is on for new installs), then turn **Testing
    Mode** off for visitors
 8. Optional: set **Show to % of visitors** (for example 20) to roll the floating chat
    widget out to a subset of browsers. Leave blank for everyone.

The plugin does not create pages on activation. The Search page is created only 
if you click **Create Search page**.

## سوالات متداول

### Where do I find my Account ID and Service ID?

They are in your Airgentic admin dashboard. If you do not have an account yet, visit
[www.airgentic.com](https://www.airgentic.com).

### Does this plugin work with any WordPress theme?

Yes. The hover widget is independent of the theme. Inline search works with the 
WordPress Search block, Search widget, and standard theme search form. Custom header
HTML can be bound by entering the input id or class.

### Will this plugin slow down my website?

The Airgentic script is loaded with the `defer` attribute so it does not block page
rendering.

### Can I customize the appearance of the chat or search UI?

Appearance is configured in the Airgentic admin dashboard, not in this plugin.

### How do I add the Service Hub to a page?

Add `[airgentic_service_hub]` to the page. It outputs `<div id="airgentic"></div
>`. You can also add that HTML in a theme template.

### How do I add Site Search?

 1. Set **Search mode** to **Inline search**
 2. Click **Create Search page**, or create a page and add `[airgentic_search]`
 3. Leave **Rewrite WordPress search forms** checked so header search submits to that
    page as `?query=`

Ask Airgentic support to confirm inline search is enabled for your service.

### What if my search field is custom HTML, not a WordPress search form?

Leave **Non-WordPress search input** and **Non-WordPress search button** blank. 
A WordPress search form is the Search block, the Search widget, or any theme form
with an input named `s`, and the plugin finds those itself. With **Rewrite WordPress
search forms** checked, a question typed there opens Ask and is answered straight
away.

Fill in **Non-WordPress search input** only when the box is custom HTML with no 
input named `s`. Enter the text field’s HTML id, or a class name with a leading 
dot (for example `.header-search`). Use the text field, not the icon that opens 
it. For inline mode this enables autocomplete on that field; for overlay mode it
opens the search popup. **Non-WordPress search button** is only for a button that
does not submit that form.

### How do I preview Airgentic before visitors see it?

New installs start in **Testing Mode**. Log in to WordPress and browse the live 
site. Only logged-in users see Airgentic, and they see it at 100% (the visitor percentage
is ignored). Turn Testing Mode off when you are ready for visitors. Existing sites
keep Testing Mode off on upgrade.

### Can I show Airgentic to only some visitors?

Yes. After Testing Mode is off, set **Show to % of visitors** under Settings  Airgentic(
for example 20). The same browser keeps the same outcome. Dedicated search and Service
Hub pages always load. Append `?airgentic=1` or `?airgentic=0` to a URL to force
on or off while testing.

### Does upgrading to 1.2.0 change my current overlay search?

No. If you already filled a search input ID in 1.1.0, Search mode stays on Overlay
until you change it.

### Can I control which pages show the Service Hub or search UI?

Yes. Those UIs only render where you place `[airgentic_service_hub]` or `[airgentic_search]`.

### Is there a free trial?

See [www.airgentic.com](https://www.airgentic.com) for pricing and trial options.

## نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

## توسعه دهندگان و همکاران

“Airgentic AI Chat Overlay” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت
کرده‌اند.

مشارکت کنندگان

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

[ترجمه “Airgentic AI Chat Overlay” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/airgentic-ai-chat-overlay)

### علاقه‌ مند به توسعه هستید؟

[کد را مرور کنید](https://plugins.trac.wordpress.org/browser/airgentic-ai-chat-overlay/)،
[مخزن SVN](https://plugins.svn.wordpress.org/airgentic-ai-chat-overlay/) را بررسی
کنید، یا از طریق [RSS](https://plugins.trac.wordpress.org/log/airgentic-ai-chat-overlay/?limit=100&mode=stop_on_copy&format=rss)
در [گزارش توسعه](https://plugins.trac.wordpress.org/log/airgentic-ai-chat-overlay/)
مشترک شوید.

## گزارش تغییرات

#### 1.4.0

 * Rewrite WordPress search forms now also covers theme header forms that WordPress
   does not render through `get_search_form` or the Search block. They submit `query`
   to the search page directly, so questions typed there are answered without a 
   second Enter and get autocomplete
 * Fixed the `?s=` redirect dropping a trailing question mark and HTML-escaping `&`
   in the search text
 * The two optional search fields are now labelled as non-WordPress only. Leave 
   them blank for a WordPress search form

#### 1.3.1

 * Added **Testing Mode** so new installs show Airgentic only to logged-in WordPress
   users
 * Show to % of visitors is ignored while Testing Mode is on
 * Existing sites keep Testing Mode off on upgrade

#### 1.3.0

 * Added **Show to % of visitors** to roll out the floating chat widget to a subset
   of browsers
 * Emits `data-traffic-percent` on the Airgentic script tag when a percentage below
   100 is set

#### 1.2.0

 * Added inline Site Search via the `[airgentic_search]` shortcode
 * Added Search mode: disabled, inline (recommended), or overlay
 * Added optional Create Search page action (not run on activation)
 * Optionally rewrite the WordPress Search block, Search widget, and theme search
   form to submit `query` to your search page
 * Optionally redirect WordPress `?s=` searches to the Airgentic search page
 * Search input and button fields now accept a class name as well as an id
 * Existing 1.1.0 overlay search settings are preserved on upgrade

#### 1.1.0

 * **Breaking Change**: Widget container is no longer automatically added to pages
 * You must now manually add the widget using the `[airgentic_service_hub]` shortcode
   or `<div id="airgentic"></div>` HTML
 * This gives you full control over which pages display the widget and where it 
   appears
 * Updated admin settings documentation to reflect the new two-step setup process

#### 1.0.0

 * Initial public release
 * Automatic widget loading on all pages
 * Configurable Account ID and Service ID
 * Optional search form integration
 * Service Hub shortcode
 * Admin settings interface

## اطلاعات

 *  نگارش **1.4.0**
 *  آخرین به‌روزرسانی **3 هفته پیش**
 *  نصب‌های فعال **کمتر از 10**
 *  نگارش وردپرس ** 5.8 یا بالاتر **
 *  آزمایش‌شده تا **6.8.11**
 *  نگارش PHP ** 7.4 یا بالاتر **
 *  زبان
 * [English (US)](https://wordpress.org/plugins/airgentic-ai-chat-overlay/)
 * برچسب
 * [AI](https://fa.wordpress.org/plugins/tags/ai/)[chat](https://fa.wordpress.org/plugins/tags/chat/)
   [chatbot](https://fa.wordpress.org/plugins/tags/chatbot/)[customer service](https://fa.wordpress.org/plugins/tags/customer-service/)
   [search](https://fa.wordpress.org/plugins/tags/search/)
 *  [نمایش پیشرفته](https://fa.wordpress.org/plugins/airgentic-ai-chat-overlay/advanced/)

## امتیازها

هنوز هیچ نقدی ارسال نشده است.

[بررسی شما](https://wordpress.org/support/plugin/airgentic-ai-chat-overlay/reviews/#new-post)

[مشاهدهٔ همهٔ بررسی‌ها](https://wordpress.org/support/plugin/airgentic-ai-chat-overlay/reviews/)

## مشارکت کنندگان

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

## پشتیبانی

چیزی برای گفتن دارید؟ نیاز به کمک دارید؟

 [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/airgentic-ai-chat-overlay/)