Description
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
- Install and activate the plugin
- Enter your Airgentic Account ID and Service ID (from your Airgentic dashboard)
- Enable the widget on the front-end
- Stay logged in and preview the live site (Testing Mode is on for new installs)
- Turn Testing Mode off when you are ready for visitors
- Optionally add
[airgentic_service_hub]on pages that should show the full chat window - 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
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
- WordPress install guide: https://www.airgentic.com/integrations/wordpress
- Site Search: https://help.airgentic.com/help/site-search-website-integration
Screenshots



Installation
Automatic Installation
- Log in to your WordPress admin
- Go to Plugins Add New
- Search for “Airgentic”
- Click Install Now, then Activate
- Go to Settings Airgentic
Manual Installation
- Download the plugin ZIP
- Go to Plugins Add New Upload Plugin
- Choose the ZIP and click Install Now
- Activate the plugin
- Go to Settings Airgentic
Configuration
- Go to Settings Airgentic
- Enter your Account ID and Service ID (required)
- Check Enable on Front-end
- For Site Search, choose a Search mode:
- 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
- Disabled: chat only
- Inline search (recommended): click Create Search page (or add
- Click Save Settings
- Preview while logged in (Testing Mode is on for new installs), then turn Testing Mode off for visitors
- 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.
FAQ-e
-
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.
-
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
deferattribute 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?
-
- Set Search mode to Inline search
- Click Create Search page, or create a page and add
[airgentic_search] - 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 the WordPress Search block?
-
Enter the input’s HTML id, or a class name with a leading dot (for example
.header-search), in Search input ID or class. For inline mode this enables autocomplete on that field; for overlay mode it opens the search popup. -
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=1or?airgentic=0to 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 for pricing and trial options.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Airgentic AI Chat Overlay” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Airgentic AI Chat Overlay” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
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-percenton 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
queryto 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
