Athenian AI Voice Assistant
product details.
Athenian AI Voice Assistant adds AI voice interaction support for WordPress and WooCommerce, helping customers search, ask questions, complete guided tasks, and connect to store workflows. It helps teams make product discovery, support, booking, reorder, and service interactions accessible through voice-enabled experiences while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian AI Voice Assistant is a lightweight WordPress and WooCommerce voice-agent foundation for routing inbound call transcriptions into OpenAI, enriching the request with site and commerce context, and returning concise phone-friendly responses for customer-service or operations workflows.
The plugin exposes a WordPress REST endpoint that can receive transcribed caller messages from Twilio or another telephony layer. It normalizes the caller phone number, attempts to resolve recent WooCommerce order context, allows OpenAI to call local tools such as site search or recent-order lookup, and returns a final response designed to be spoken back through a phone system.
The current version is best positioned as a production-oriented routing and orchestration foundation rather than a completed live call-center product. It does not yet implement live audio streaming, speech-to-text, or text-to-speech directly. Instead, it establishes the contract needed for future Twilio Media Streams, OpenAI audio APIs, call-center routing, phone support automation, and broader Athenian Platform communications workflows.
Within the Athenian Platform, AI Voice Assistant fits as the bridge between phone-based customer interactions and operational intelligence already living inside WordPress and WooCommerce.
How Athenian AI Voice Assistant fits the Athenian Platform
Platform role: Athenian AI Voice Assistant is a focused capability in the AI, Automation & Intelligent Commerce layer. Its primary scope covers AI Assistants & Recommendations and Voice Commerce & Conversational Access while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian AI Voice Assistant is designed to work inside a WordPress and WooCommerce operating environment where storefront, customer, order, identity, payment, fulfillment, automation, and reporting context can remain connected across relevant modules instead of being trapped in isolated add-ons.
From module to operating platform: Athenian Brands organizes the ecosystem in four connected layers: Platform Kernel and Platform Core foundations; focused capability plugins; implementation and integration services; and operating brands such as PrintGhost.ai, Athenian Marketplace, Athenian Academy, and Athenian Unÿa that apply the same patterns to real business workflows.
AI Voice Routing
Route Transcribed Phone Messages Into WordPress, WooCommerce, and OpenAI
Athenian AI Voice Assistant provides a REST-based routing layer for
phone-support workflows, allowing transcribed caller messages to be
enriched with site context, WooCommerce order data, and OpenAI tool-calling
before a concise spoken response is returned.
| Voice Workflow Layer | Operational Value |
|---|---|
| Inbound AI Route | Receives transcribed caller utterances through /wp-json/aava/v1/ai-route. |
| Webhook Protection | Supports an optional shared secret through X-AAVA-Token or a token query parameter. |
| OpenAI Conversation Flow | Builds messages from the system prompt, caller metadata, and caller utterance, then requests a phone-friendly AI response. |
| Tool Calling | Allows OpenAI to request local WordPress/WooCommerce tools, append the tool result, and generate a final answer grounded in local data. |
- Registers the REST namespace
aava/v1and main endpoint/wp-json/aava/v1/ai-route. - Accepts payload fields such as
from,utterance, andsession_id. - Returns response fields such as
reply_text,tool_results, andcaller_context. - Uses classes such as
AAVA_Router,AAVA_OpenAI_Client,AAVA_Toolbox, andAAVA_Pluginfor routing, AI, and local tool orchestration.
WooCommerce Voice Context
Help Phone Assistants Answer Order, Product, and Site Questions With Local Context
The plugin can normalize caller phone numbers, match recent WooCommerce
orders by billing phone, format compact order context for AI, and expose
local tools for site search and recent-order lookup during a voice-support
conversation.
Normalize phone numbers and resolve recent WooCommerce orders
Let the AI search posts, pages, and products for relevant answers
Include order status, totals, line items, and tracking metadata when available
| Context Tool | How It Helps |
|---|---|
| Phone Normalization | Strips non-digits and removes a leading US country code when matching caller numbers to stored billing phone data. |
| Recent Orders Tool | Looks up recent WooCommerce orders associated with the caller’s normalized billing phone number. |
| Site Content Tool | Searches WordPress posts, pages, and products for relevant content that can inform the final spoken response. |
| Tracking Metadata | Checks common shipment tracking meta keys and allows developers to add more keys through a filter. |
- Defines AI tools such as
search_site_contentandlookup_recent_orders. - Uses WooCommerce APIs such as
wc_get_orders()rather than direct order-table SQL. - Supports tracking meta keys such as
_tracking_number,_wc_shipment_tracking_items, andtracking_number. - Provides filters such as
aava_caller_contextandaava_tracking_meta_keysfor custom customer, CRM, shipment, or fulfillment context.
Voice Platform Foundation
Build a Flexible Voice-Agent Layer for Twilio, OpenAI Audio, and Athenian Communications
AAVA is intentionally focused on the routing, AI orchestration, settings,
and tool-execution layer first. It includes admin configuration, optional
shared AI-core reuse, and placeholder STT/TTS provider registries that can
be expanded into full voice-provider integrations.
| Platform Layer | Operational Purpose |
|---|---|
| Admin Settings | Adds Settings → AI Voice Assistant for OpenAI API key, model, system prompt, and inbound shared-secret configuration. |
| Athenian AI Core Reuse | Can reuse AWC_AI_Core when available, allowing AI Voice Assistant to share API key, model, and OpenAI behavior with Athenian AI Chat. |
| Standalone OpenAI Fallback | Falls back to plugin settings and direct OpenAI Chat Completions requests when the shared Athenian AI core is not present. |
| STT/TTS Registry | Provides placeholder provider registration for future speech-to-text and text-to-speech integrations. |
Foundation first:
the current version does not yet include live audio streaming, full Twilio
TwiML call handling, speech-to-text, text-to-speech, transcript storage,
custom database tables, or frontend UI. It is best presented as a compact
voice-agent routing and AI orchestration layer with a clear roadmap.
- Stores plugin configuration in
aava_settings, includingopenai_api_key,openai_model,system_prompt, andshared_secret. - Registers media-provider extension points such as
AAVA_Media_Manager::register_stt_provider()andAAVA_Media_Manager::register_tts_provider(). - Uses
manage_optionsfor settings access and sanitizes inbound REST values such as caller phone, utterance, and session ID. - Builds toward Twilio signature verification, request logging, rate limiting, Secure API Key Manager integration, conversation memory, privacy controls, TwiML formatting, live STT/TTS providers, call transcripts, escalation workflows, Order Resolution, Returns Manager, Shipment Manager, and AI Chat integration.