Athenian Alexa Integration
product details.
Athenian Alexa Integration turns WooCommerce into a voice-ready backend for custom Alexa skills with account linking, live catalog APIs, and controlled purchase workflows. It helps teams connect voice experiences to products, customer accounts, safe ordering, and platform commerce data while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian Amazon Alexa Integration turns a WordPress and WooCommerce storefront into the secure backend for a custom Alexa commerce skill. It connects live catalog data, customer account context, recent orders, recommendations, reorder flows, and pending purchase workflows to Alexa through a WordPress-native OAuth provider and scoped REST API.
Instead of building separate middleware for account linking, product lookup, customer identity, order status, and voice purchase initiation, the plugin lets WooCommerce remain the source of truth. Alexa can search products, retrieve product details, surface recommendations, read recent order information, start a reorder, or create a pending WooCommerce order for website checkout completion.
The plugin includes a guided Athenian Alexa admin dashboard, OAuth credential management, redirect allow-list controls, optional HMAC request validation, storefront capability toggles, public catalog behavior, voice-purchase settings, and a downloadable Alexa skill starter kit with interaction model JSON, Lambda handler code, package metadata, environment variables, and setup documentation.
Within the Athenian Platform, Amazon Alexa Integration fits as the voice-commerce bridge for WooCommerce product discovery, customer support, account-linked order assistance, reorder workflows, and safe purchase initiation through external voice assistants.
How Athenian Alexa Integration fits the Athenian Platform
Platform role: Athenian Alexa Integration is a focused capability in the AI, Automation & Intelligent Commerce and Integrations, Channels & APIs layer. Its primary scope covers APIs, Webhooks & Automation and Voice Commerce & Conversational Access while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian Alexa Integration 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.
Alexa Account Linking
Use WordPress as the OAuth Backend for a Custom Alexa Commerce Skill
Athenian Amazon Alexa Integration provides the authorization, token,
refresh, and revocation endpoints needed for Alexa Account Linking,
allowing customers to connect their Alexa experience to their WordPress
and WooCommerce account.
| Security Layer | Operational Value |
|---|---|
| OAuth Authorization Flow | Handles Alexa account-linking approval through WordPress login, customer consent, authorization-code generation, and redirect return. |
| Token Management | Exchanges authorization codes for access and refresh tokens, supports refresh flows, and provides token revocation. |
| Scoped REST Access | Protects account, order, reorder, and purchase routes with Bearer tokens and route-specific scope checks. |
| Request Hardening | Supports redirect URI allow-listing and optional X-ATH-SIG HMAC validation for skill-origin REST calls. |
- Registers OAuth routes under
/wp-json/ath-alexa/v1/oauth/authorize,/wp-json/ath-alexa/v1/oauth/token, and/wp-json/ath-alexa/v1/oauth/revoke. - Creates custom tables such as
ath_alexa_oauth_codesandath_alexa_oauth_tokens. - Stores authorization codes, access tokens, and refresh tokens as SHA-256 hashes rather than plaintext values.
- Uses configurable scopes such as
read:account,read:catalog,read:orders, andwrite:orders.
Voice Commerce API
Expose Live WooCommerce Catalog, Account, and Order Workflows to Alexa
The plugin gives Alexa access to scoped WooCommerce storefront endpoints
for product discovery, product detail lookup, personalized or featured
recommendations, account summaries, recent orders, order status, reorder
creation, and safe purchase intent handling.
Search products by query, category, sale state, featured state, stock, and price range
Return linked customer identity, billing, shipping, latest order, and recent orders
Create pending WooCommerce orders for website checkout completion
| Commerce Endpoint | How It Helps |
|---|---|
| Storefront & Catalog | Returns store metadata, product search, product details, recommendations, catalog limits, and public/private capability behavior. |
| Product Payloads | Includes product ID, SKU, slug, type, price, sale state, stock state, rating, images, categories, tags, attributes, variations, and purchase readiness. |
| Order Support | Returns recent orders, latest order status, order totals, currency, payment method labels, and item summaries for account-linked users. |
| Reorder & Purchase Intent | Creates new pending WooCommerce orders from prior order items or a simple purchasable in-stock product while keeping final payment on the website. |
- Registers commerce routes under
/wp-json/ath-alexa/v1. - Supports endpoints such as
/storefront,/search,/product,/recommendations,/account,/orders,/order-status,/reorder, and/purchase. - Can allow public catalog search while keeping customer account, order, reorder, and purchase routes protected by account linking.
- Marks Alexa-created WooCommerce orders with
created_viabehavior and pending status so payment review remains on the website.
Voice Commerce API
Expose Live WooCommerce Catalog, Account, and Order Workflows to Alexa
The plugin gives Alexa access to scoped WooCommerce storefront endpoints
for product discovery, product detail lookup, personalized or featured
recommendations, account summaries, recent orders, order status, reorder
creation, and safe purchase intent handling.
Search products by query, category, sale state, featured state, stock, and price range
Return linked customer identity, billing, shipping, latest order, and recent orders
Create pending WooCommerce orders for website checkout completion
| Commerce Endpoint | How It Helps |
|---|---|
| Storefront & Catalog | Returns store metadata, product search, product details, recommendations, catalog limits, and public/private capability behavior. |
| Product Payloads | Includes product ID, SKU, slug, type, price, sale state, stock state, rating, images, categories, tags, attributes, variations, and purchase readiness. |
| Order Support | Returns recent orders, latest order status, order totals, currency, payment method labels, and item summaries for account-linked users. |
| Reorder & Purchase Intent | Creates new pending WooCommerce orders from prior order items or a simple purchasable in-stock product while keeping final payment on the website. |
- Registers commerce routes under
/wp-json/ath-alexa/v1. - Supports endpoints such as
/storefront,/search,/product,/recommendations,/account,/orders,/order-status,/reorder, and/purchase. - Can allow public catalog search while keeping customer account, order, reorder, and purchase routes protected by account linking.
- Marks Alexa-created WooCommerce orders with
created_viabehavior and pending status so payment review remains on the website.