Title: Aqoiy – AI &amp; Human Customer Support Chatbot
Author: SoftwareHS
Published: <strong>7 de mayo de 2026</strong>
Last modified: 30 de octubre de 2026

---

Buscar plugins

![](https://ps.w.org/aqoiy-ai-customer-support-chatbot/assets/banner-772x250.png?
rev=3712160)

![](https://ps.w.org/aqoiy-ai-customer-support-chatbot/assets/icon-256x256.png?rev
=3712160)

# Aqoiy – AI & Human Customer Support Chatbot

 Por [SoftwareHS](https://profiles.wordpress.org/hssoftware/)

[Descargar](https://downloads.wordpress.org/plugin/aqoiy-ai-customer-support-chatbot.1.0.13.zip)

 * [Detalles](https://es.wordpress.org/plugins/aqoiy-ai-customer-support-chatbot/#description)
 * [Valoraciones](https://es.wordpress.org/plugins/aqoiy-ai-customer-support-chatbot/#reviews)
 *  [Instalación](https://es.wordpress.org/plugins/aqoiy-ai-customer-support-chatbot/#installation)
 * [Desarrollo](https://es.wordpress.org/plugins/aqoiy-ai-customer-support-chatbot/#developers)

 [Soporte](https://wordpress.org/support/plugin/aqoiy-ai-customer-support-chatbot/)

## Descripción

Aqoiy is an AI-powered customer support chatbot that integrates deeply with WooCommerce.
It uses advanced AI to answer questions, look up live orders, check product stock,
process return requests, and seamlessly hand off conversations to human agents when
needed.

**Key Features:**

 * **AI-Powered Responses** — Uses advanced AI to answer customer questions based
   on your knowledge base and store data.
 * **WooCommerce Integration** — Search products, check stock, and look up orders
   in real time.
 * **Human Agent Handoff** — Automatically escalate to live agents when the AI can’t
   help.
 * **Knowledge Base** — Add custom articles, FAQs, and policies for the AI to reference.
 * **Customizable Widget** — Match your brand with custom colors and titles.
 * **Sentiment Analysis** — Detect unhappy customers and auto-escalate.
 * **Business Hours** — Configure availability and offline messages.
 * **Analytics Dashboard** — Track conversations, response times, and customer satisfaction.
 * **Multi-language Support** — Auto-detect and respond in the customer’s language.
 * **Light & Dark Admin Theme** — Choose the admin panel appearance that suits you.

**Powered by Firebase** — Real-time messaging, secure authentication, and scalable
infrastructure.

### External Services

This plugin connects to two external services. Both connections only happen after
the store owner has configured the plugin (created an Aqoiy account, or pasted a
Google Gemini API key). No data leaves the site before that.

#### 1. Aqoiy Backend API

**Service:** Aqoiy platform backend, operated by Aqoiy (Thrivethrum LLC).
 **Endpoint
host:** `https://us-central1-aqoiy-server-v2.cloudfunctions.net/api` **Purpose:**
Stores plugin configuration, relays chat traffic between the customer-facing widget
and human agents, runs AI replies through the managed pipeline, records analytics,
and authenticates the store account.

The plugin issues 26 distinct calls to this host. Each call is triggered by an explicit
user action or admin event — never on every page load. They are grouped below by
purpose:

**a. Account & site authorisation** (sent only when the admin clicks Connect / Register/
Login on the settings screen, or when WordPress detects the active site URL has 
changed)

 * `POST /auth/store/register` — sends the chosen email, password and store URL 
   to create an Aqoiy account.
 * `POST /auth/store/login-with-password` — sends email and password to obtain an
   API key.
 * `GET /plugin/verify` — validates the saved API key on activation.
 * `PUT /plugin/site-detection` — sends the detected site URL, platform (WordPress/
   WooCommerce) and the list of detected catalog or booking plugins (for example`
   woocommerce`, `wp_travel_engine`) so the backend can authorise this domain and
   choose the assistant’s tools.

**b. Configuration sync** (sent when the admin saves the Settings, AI Settings, 
Tools, Widget, or WooCommerce credentials screens)

 * `GET /plugin/config` — fetches the current backend configuration to display in
   the admin UI.
 * `PUT /plugin/config` (3 call sites) — sends widget colours/welcome message, the
   toolsConfig flags (`search_products`, `check_stock`, `get_order`, `submit_return`,`
   human_handoff`, `search_content`), the chosen storeMode, and — if WooCommerce
   is connected — the store URL plus the WooCommerce REST API consumer key/secret
   so the backend can call WooCommerce directly when a customer asks about an order.

**c. Knowledge base sync** (sent when the admin adds, edits, or deletes a KB entry,
or runs the «Sync» button)

 * `PUT /plugin/knowledge-base` — sends the user-authored KB entries (titles, content,
   URLs, tags) so the AI can quote them in answers.

**d. Conversation traffic** (sent only while a real visitor is using the chat widget
on the storefront; nothing is sent if no one is chatting)

 * `POST /plugin/message` (2 call sites) — forwards the visitor’s message and the
   recent message history.
 * `POST /plugin/ai-reply` (2 call sites) — requests the AI reply for the current
   session.
 * `POST /plugin/handoff` — marks the session as needing a human agent. Sends the
   session id and a short reason.
 * `POST /plugin/poll` — short-polls the backend for any agent reply.
 * `POST /plugin/session-end` — notifies the backend that the visitor closed the
   chat.
 * `POST /plugin/csat` — sends the post-chat satisfaction rating (1–5) plus optional
   free-text feedback.

**e. Admin dashboards** (sent only while the admin is viewing the corresponding 
screen)

 * `GET /plugin/analytics` — fetches conversation counts, response times, and CSAT
   averages for the Analytics tab.
 * `GET /plugin/usage` — fetches the current month’s AI message usage and plan limit.
 * `GET|PUT|DELETE /plugin/sessions` (3 call sites) — lists/filters/clears recorded
   sessions for the Sessions tab.
 * `GET /plugin/session/{id}` — fetches a single session transcript when the admin
   clicks a row.

Visitor messages typed into the chat widget are transmitted to this service. The
widget collects the visitor name and email only if the visitor types them (or if
a logged-in WordPress user opens the chat — in which case their display name and
account email are read from `wp_get_current_user()` and forwarded so the agent can
identify them).

Service provider: Aqoiy (Thrivethrum LLC) — https://aqoiy.com
 Terms of Service:
https://aqoiy.com/terms Privacy Policy: https://aqoiy.com/privacy

#### 2. Google Gemini API (optional, BYO-key path)

**Service:** Google Gemini Generative Language API.
 **Endpoint host:** `https://
generativelanguage.googleapis.com` **Purpose:** Generates AI replies when the store
owner has pasted a personal Gemini API key into the AI Settings screen. If no Gemini
key is configured, this path is never used — all AI replies go through the Aqoiy
backend instead.

 * `POST https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent`—
   sends the recent message history and any system instructions configured in the
   AI Settings tab; receives the model’s reply. Triggered only when the storefront
   widget receives a customer message and the BYO-key path is active.

The Gemini API key is supplied by the store owner and is sent as a query parameter
on each request, per Google’s API contract. No customer message is sent to Google
before a real visitor types in the chat widget.

Service provider: Google LLC.
 Google APIs Terms of Service: https://developers.
google.com/terms Google Privacy Policy: https://policies.google.com/privacy

WooCommerce is a trademark of Automattic Inc. Aqoiy is not affiliated with or endorsed
by Automattic.

## Capturas

[⌊Setup wizard — choose your platform (WordPress or WooCommerce) to get started.⌉⌊
Setup wizard — choose your platform (WordPress or WooCommerce) to get started.⌉[

Setup wizard — choose your platform (WordPress or WooCommerce) to get started.

[⌊Settings page — manage your account, view usage, and preview the live chat widget.⌉⌊
Settings page — manage your account, view usage, and preview the live chat widget
.⌉[

Settings page — manage your account, view usage, and preview the live chat widget.

[⌊Analytics dashboard — track sessions, peak chat hours, and top customer questions.⌉⌊
Analytics dashboard — track sessions, peak chat hours, and top customer questions
.⌉[

Analytics dashboard — track sessions, peak chat hours, and top customer questions.

## Instalación

 1. Upload the `aqoiy-chatbot` folder to `/wp-content/plugins/`.
 2. Activate the plugin through the **Plugins** menu in WordPress.
 3. Go to **Aqoiy Chatbot > Settings** and create your account or enter your API key.
 4. Configure your widget colors, AI settings, and WooCommerce credentials.
 5. The chat widget will appear on your site automatically.

## FAQ

### Does this require WooCommerce?

No. The chatbot works on any WordPress site. WooCommerce integration (product search,
order lookup, stock check) is optional and activates automatically when WooCommerce
is installed.

### What AI model does it use?

Aqoiy uses Google Gemini AI models. You can configure the model in the AI Settings
tab.

### Is my data secure?

All data is stored securely on Firebase (Google Cloud). Communication uses HTTPS
encryption. API keys are validated on every request.

### How do I connect human agents?

Install the Aqoiy Agent mobile app (iOS/Android) or use the web dashboard at app.
aqoiy.com. Agents receive real-time notifications when customers request human help.

### What are the plan limits?

 * **Free** — 500 AI messages/month
 * **Standard** — 5,000 AI messages/month
 * **Pro** — Unlimited AI messages
 * **Business** — Unlimited everything (contact us)

## Reseñas

No hay valoraciones para este plugin.

## Colaboradores y desarrolladores

«Aqoiy – AI & Human Customer Support Chatbot» es un software de código abierto. 
Las siguientes personas han colaborado con este plugin.

Colaboradores

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

[Traduce «Aqoiy – AI & Human Customer Support Chatbot» a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/aqoiy-ai-customer-support-chatbot)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/aqoiy-ai-customer-support-chatbot/),
echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/aqoiy-ai-customer-support-chatbot/)
o suscríbete al [registro de desarrollo](https://plugins.trac.wordpress.org/log/aqoiy-ai-customer-support-chatbot/)
por [RSS](https://plugins.trac.wordpress.org/log/aqoiy-ai-customer-support-chatbot/?limit=100&mode=stop_on_copy&format=rss).

## Registro de cambios

#### 1.0.13

*Fix: the 1.0.12 download from WordPress.org was missing the plugin’s JavaScript
and images, so sign-in and the chat widget did not work on new installs. This release
contains all files
 *Administrators now see a clear notice if plugin files are missing,
and the chat widget is not shown on an incomplete installation *Sites that combine
WooCommerce with a booking plugin (for example WP Travel Engine trips) now report
every integration, so the assistant can answer about both products and bookings *
Already-connected sites send this list automatically after the update (no new sign-
in or scan needed), and again whenever a catalog or booking plugin is added or removed*
WP Travel Engine: new `/aqoiy/v1/trip-pricing` REST endpoint (requires the site’s
Aqoiy API key) returns published package prices, traveler categories, sale prices
and group-discount tiers so the assistant can give price estimates calculated the
same way as the WP Travel Engine cart. Read-only; no bookings, customers or orders
are read or created

#### 1.0.12

*Security: links in chat messages can no longer inject HTML attributes
 *Security:
the API key check uses a constant-time comparison *Declared compatibility with WooCommerce
High-Performance Order Storage and Cart/Checkout blocks *Plan features follow your
current Aqoiy plan, checked with Aqoiy every few minutes: Analytics, business hours,
email marketing providers and widget languages show a clear locked state with an
Upgrade button when your plan does not include them, instead of empty charts or 
settings that cannot be saved *Settings save tells you if Aqoiy did not accept the
update; saving on the Free plan no longer fails because of plan-only settings *Knowledge
base shows how many entries your plan allows and refuses new entries past the limit
with a clear message *Chat sessions belong to one browser tab: minimising keeps 
the conversation, refreshing or browsing the site keeps it, the close button (X)
ends it, and a new tab, a later visit or a restarted browser starts a new chat. 
Past conversations stay in Aqoiy for the store *Opening Aqoiy before the site is
connected goes straight to the setup in Settings *Conversations shows your store’s
conversations from Aqoiy (the same ones as app.aqoiy.com), within your plan’s conversation
history, and says so when they cannot be loaded *An optional, dismissible request
for an honest WordPress.org review after 7 days of use *Tested with WordPress 7.1

#### 1.0.11

*Redesigned chat widget UI — dark navy header, cleaner message bubbles
 *Replaced
icon avatars with custom PNG images (bot, human agent, handoff states) *Added notification
sound on preview bubble *Widget size setting now functional (Compact/Standard/Comfortable)*
Removed Primary/Secondary color pickers from admin settings *Removed Avatar/Toggle
icon pickers from admin settings *Updated admin panel logo

#### 1.0.10

 * Updated plugin name to better reflect AI and human agent handoff capability.
 * Generalized AI model references in description for flexibility.

#### 1.0.9

 * Removed the «Powered by Aqoiy» badge option from the chat widget footer per WordPress
   Plugin Directory guidelines. Attribution no longer appears on any user-facing
   interface.

#### 1.0.8

 * Documentation: rewrote the `== External Services ==` section in readme.txt to
   enumerate every backend endpoint the plugin contacts, what data is sent, and 
   when. Added a separate entry for the optional direct Google Gemini API path (
   BYO-key) and corrected the prior statement that no direct Google connection is
   made.
 * Security/hardening: the inline CSS variable block emitted by `Aqoiy_Chatbot::
   enqueue_widget()` (`--aqoiy-primary` / `--aqoiy-secondary`) now re-runs `sanitize_hex_color()`
   on the saved colour values immediately before they are interpolated, so the output
   is escape-late even if a stored option is corrupted by a future code path.
 * Naming: renamed the custom `do_action( 'cache_flush' )` broadcast in the settings
   save path to `do_action( 'aqoiy_cache_flush' )` so the hook is properly prefixed.
 * SQL hardening: every direct `$wpdb` query in `class-aqoiy-db.php`, `class-aqoiy-
   api.php`, `class-aqoiy-admin.php` and `uninstall.php` is now wrapped in `$wpdb-
   >prepare()` using the `%i` identifier placeholder for table names. `Requires 
   at least` bumped to 6.2 (when `%i` was introduced).

#### 1.0.7

 * Removed Origin/Referer-only authorisation path from the storefront REST permission
   callback (`verify_widget_session`). The callback now requires either a matching
   HttpOnly `aqoiy_sid` cookie or a valid HMAC `sessionToken` — both unforgeable
   by off-origin scripted callers. Origin/Referer headers, while useful, can be 
   set freely by non-browser clients and are no longer accepted as proof.
 * Added a public `/aqoiy/v1/session-init` REST endpoint (`permission_callback =
   > __return_true`) that mints a fresh sessionId + HMAC token and sets the HttpOnly
   cookie. The widget calls it lazily on first interaction only when the page-baked
   credentials are missing (e.g. served by an aggressive page cache). Resolves stale-
   credential issues on cached pages.

#### 1.0.6

 * Storefront chat now works reliably across page-cache, host-header-stripping and
   cross-subdomain setups: the REST permission callback accepts any of three independent
   authorisation paths — HttpOnly `aqoiy_sid` cookie binding, HMAC sessionToken,
   or browser-enforced same-origin Origin/Referer. The HMAC token alone is no longer
   required.
 * Added `X-Aqoiy-Session` to CORS allow-headers.

#### 1.0.5

 * Fixed login session not persisting after the 1.0.4 sanitisation hardening: internal
   credential saves are now routed through a dedicated trusted helper so they bypass
   the strict register_setting() callback while still being fully field-by-field
   sanitised at the call site.

#### 1.0.4

 * Hardened storefront REST endpoints (chat / poll / csat / session-end) with a 
   per-session HMAC authorisation token, replacing the previous public `__return_true`
   permission callback.
 * Switched `register_setting()` to the array form with an explicit `sanitize_callback`,
   and made `sanitize_settings()` refuse to overwrite stored options when the page-
   context flag is missing.
 * No user-facing changes; existing storefront chat, agent handoff and CSAT flows
   continue to work after update.

#### 1.0.2

 * Added site authorization enforcement
 * Improved security for multi-site accounts
 * Fixed unauthorized site error handling
 * Added X-Site-Url header for all API requests

#### 1.0.1

 * Initial release improvements

#### 1.0.0

 * Initial release
 * Customizable widget (colors, icons, sizes)
 * Light/dark admin theme
 * Sentiment analysis and auto-escalation

## Meta

 *  Versión **1.0.13**
 *  Última actualización **hace 2 semanas**
 *  Instalaciones activas **Menos de 10**
 *  Versión de WordPress ** 6.2 o superior **
 *  Probado hasta **7.1.4**
 *  Versión de PHP ** 7.4 o superior **
 *  Idioma
 * [English (US)](https://wordpress.org/plugins/aqoiy-ai-customer-support-chatbot/)
 * Etiquetas:
 * [AI](https://es.wordpress.org/plugins/tags/ai/)[chatbot](https://es.wordpress.org/plugins/tags/chatbot/)
   [customer support](https://es.wordpress.org/plugins/tags/customer-support/)[live chat](https://es.wordpress.org/plugins/tags/live-chat/)
   [woocommerce](https://es.wordpress.org/plugins/tags/woocommerce/)
 *  [Vista avanzada](https://es.wordpress.org/plugins/aqoiy-ai-customer-support-chatbot/advanced/)

## Valoraciones

Aún no se han enviado valoraciones.

[Tu valoración](https://wordpress.org/support/plugin/aqoiy-ai-customer-support-chatbot/reviews/#new-post)

[Ver todas las reseñas](https://wordpress.org/support/plugin/aqoiy-ai-customer-support-chatbot/reviews/)

## Colaboradores

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

## Soporte

¿Tienes algo que decir? ¿Necesitas ayuda?

 [Ver el foro de soporte](https://wordpress.org/support/plugin/aqoiy-ai-customer-support-chatbot/)