Athenian Alexa Integration
Overview
Product overview
Most commerce teams that want an Alexa experience run into the same problem: WooCommerce already contains the product, customer, and order truth, but Alexa needs a secure voice-ready backend, account linking, API endpoints, deployment guidance, and purchase-safe workflows. That usually leads to custom middleware, duplicated business logic, or fragile proof-of-concept integrations that are expensive to maintain.
Athenian Amazon Alexa Integration solves that by letting WordPress itself become the Alexa integration layer. The plug-in provides a built-in OAuth 2.0 provider for Alexa account linking, a REST bridge for catalog and account data, guided admin configuration for Amazon and AWS setup, and a starter skill kit that includes the interaction model, Lambda handler, and environment template. The result is a faster path to voice commerce that still keeps WooCommerce as the source of truth.
Use cases
- Voice commerce
- Alexa shopping
- Order lookup
- Product discovery
Developer
Developer starting point
This baseline documents the Alexa integration architecture. It does not claim that Alexa account linking, a provider request, a live voice session, a WooCommerce order, or payment completion has been exercised.
Integration story
WooCommerce
WooCommerce remains the source of truth for products, pricing, stock status, customers, and orders. The plug-in reads from live WooCommerce data and creates WooCommerce orders rather than introducing a parallel commerce system.
Amazon Alexa
The plug-in is purpose-built for custom Alexa skills. It provides the account-linking flow, the storefront and account endpoints the skill needs, and the starter assets required to stand up the Alexa experience faster.
AWS Lambda
The included starter kit assumes an Alexa-compatible Lambda runtime and helps connect the Alexa skill to the WordPress REST layer. This keeps the skill thin while WordPress handles catalog and customer logic.
WordPress admin operations
The admin UI acts as the control plane for the integration. That is where merchants and operators configure OAuth, storefront behavior, skill metadata, purchase permissions, and Amazon deployment references.
Install
- Reviewed source folder: athenian-amazon-alexa-integration
- Plugin version reviewed: 0.5.0
- Local source inventory: 16 files (temporary, test, and Git metadata excluded).
- GitHub baseline: https://github.com/Athenian-Brands/athenian-amazon-alexa-integration at main / 37d842ed7343c15d529c5217b06e71420a99a75d.
- WordPress, WooCommerce, Alexa, AWS/Lambda, and configured OAuth credentials.
- External voice requests, account linking, product data, customer access, order creation, and payment completion require separate authenticated verification.
Configuration
- Working positioning — see the linked technical reference excerpt.
- Executive summary — see the linked technical reference excerpt.
- Core marketing message — see the linked technical reference excerpt.
- The problem this plug-in solves — see the linked technical reference excerpt.
- What this plug-in does — see the linked technical reference excerpt.
- Integration story — see the linked technical reference excerpt.
- Why this matters commercially — see the linked technical reference excerpt.
- Key differentiators — see the linked technical reference excerpt.
- Suggested messaging pillars — see the linked technical reference excerpt.
- Short-form copy options — see the linked technical reference excerpt.
- Sales narrative — see the linked technical reference excerpt.
- Best-fit use cases — see the linked technical reference excerpt.
- Positioning statement — see the linked technical reference excerpt.
- Platform-focused primary functionality copy — see the linked technical reference excerpt.
Usage
- Shortcodes detected in local PHP source: 0
- Static action/filter hooks detected in local PHP source: 7
- REST route registrations detected in local PHP source: 13
Shortcodes
- No static add_shortcode registrations were detected by the baseline scanner.
REST Endpoints
- /account — includes/class-ath-alexa-rest.php
- /oauth/authorize — includes/class-ath-alexa-oauth.php
- /oauth/revoke — includes/class-ath-alexa-oauth.php
- /oauth/token — includes/class-ath-alexa-oauth.php
- /order-status — includes/class-ath-alexa-rest.php
- /orders — includes/class-ath-alexa-rest.php
- /product — includes/class-ath-alexa-rest.php
- /purchase — includes/class-ath-alexa-rest.php
- /recommendations — includes/class-ath-alexa-rest.php
- /reorder — includes/class-ath-alexa-rest.php
- /search — includes/class-ath-alexa-rest.php
- /storefront — includes/class-ath-alexa-rest.php
- /whoami — includes/class-ath-alexa-rest.php
Hooks
- admin_enqueue_scripts — includes/class-ath-alexa-admin.php
- admin_menu — includes/class-ath-alexa-admin.php
- admin_post_ath_alexa_download_kit — includes/class-ath-alexa-admin.php
- admin_post_ath_alexa_save — includes/class-ath-alexa-admin.php
- plugins_loaded — athenian-amazon-alexa-integration.php
- rest_api_init — includes/class-ath-alexa-oauth.php
- rest_api_init — includes/class-ath-alexa-rest.php
Data Model
- Integration story — described in the local technical reference.
API Reference
- Local source digest: 752ed7f8ba654f94487137170b110cb73b7dc49f01229b334509ff9d58e20807
- Repository URL: https://github.com/Athenian-Brands/athenian-amazon-alexa-integration
- Repository reference: main
- Repository commit: 37d842ed7343c15d529c5217b06e71420a99a75d
Source files include: README.md, assets/admin.css, assets/admin.js, athenian-amazon-alexa-integration-icon.png, athenian-amazon-alexa-integration.php, athenian-amazon-alexa-integration.zip, docs/athenian-amazon-alexa-integration-marketing-document.md, docs/athenian-platform-marketing.md, docs/athenian-platform-technical.md, docs/technical-marketing.md, includes/class-ath-alexa-admin.php, includes/class-ath-alexa-db.php, includes/class-ath-alexa-oauth.php, includes/class-ath-alexa-rest.php, includes/class-ath-alexa-util.php, temp-test-patch.txt
Troubleshooting
This baseline documents the Alexa integration architecture. It does not claim that Alexa account linking, a provider request, a live voice session, a WooCommerce order, or payment completion has been exercised.
- Confirm the deployed plugin version, active dependencies, and current repository tree before using implementation details as a release contract.
Treat payment, carrier, vendor, shipment, inventory, account, credential, tax, AI, and external-provider behavior as integration-dependent until exercised in the target environment.
FAQ
What is this page intended to establish?
A versioned, product-linked starting point for iterative developer documentation. It combines the local implementation reference with a detected-code inventory and a committed GitHub baseline.
Is the linked repository baseline verified?
Yes. The repository URL, ref, and commit recorded on this page were verified from the clean GitHub baseline prepared for this documentation pass. That does not by itself prove fleet deployment parity.
What remains for release-grade documentation?
Reconcile the recorded source baseline with the deployed plugin version, then exercise the relevant authenticated, store, provider, payment, tax, carrier, or generated-artifact paths in the target environment.