¶ SmartBuy AIA
SmartBuy Assistant is a modular AI-powered assistant for e-commerce platforms. It helps users discover relevant products based on open-text queries and can generate full product bundles or cart configurations. The assistant is fully configurable via the admin interface, supports detailed analytics, and can be easily integrated into any frontend environment.
¶ 🔧 1. General Configuration
| Field | Type | Description |
|---|---|---|
buttonColor |
color |
Color of the launcher button in HEX format. |
bgColor |
color |
Background color of the assistant interface. |
position |
select |
Position of the assistant on the screen: bottom-right, bottom-left. |
allowedDomains |
dynamic_fields |
List of permitted domains (comma-separated). |
JavaScriptConnectCode |
textarea_js_code |
Auto-generated integration script to be embedded in the site’s HTML. |
The visual and positioning parameters are applied dynamically in the integration script.
¶ 🔐 2. AI API Tokens Configuration
| Field | Type | Description |
|---|---|---|
AIModelName |
select |
AI model type: gpt-4o-mini, o1-mini, o3-mini. |
modelToken |
password |
Secret token for accessing the selected AI model. |
modelAPIUrl |
text |
(Optional) Custom API endpoint for AI responses. |
additionalPrompt |
textarea |
Additional context or prompt injected into all AI queries. |
¶ 🧩 3. Magento 2 Integration
SmartBuy offers a full integration with Magento 2 via REST API, including support for configurable products, attributes, categories, and token-based access.
| Field | Type | Description |
|---|---|---|
magentoProductsDomainURL |
text |
API endpoint for products: {BASE_URL}/rest/V1/products |
magentoChildProductsDomainURL |
text |
API endpoint for child items of configurable products. |
magentoProductVisibility |
select |
Visibility level: 0 (Disabled) to 4 (Catalog & Search). |
magentoCategoryDomainURL |
text |
API endpoint for categories: {BASE_URL}/rest/V1/categories |
magentoProductURLExtension |
text |
URL suffix for products (e.g., .html). |
magentoAdditionalAttributes |
dynamic_fields |
Comma-separated list of additional attributes to include in product queries. |
magentoAttributesDomainURL |
text |
API endpoint for attributes: {BASE_URL}/rest/V1/products/attributes |
magentoAdditionalAttributesOfConfigurableProducts |
dynamic_fields |
Attributes for child items of configurable products. |
magentoAccessToken |
password |
Magento API access token. |
magentoChunks |
text |
Maximum number of token chunks per batch request. |
magentoJavaScriptConnectCode |
textarea_js_code |
Auto-generated JavaScript integration snippet. |
SmartBuy can also be integrated with non-Magento systems. You can connect product catalogs via other REST APIs, GraphQL endpoints, or even flat data formats like CSV. Custom parsers or API bridges can be implemented for integration into headless, proprietary, or CMS-based stores.
¶ 📊 4. Analytics System
SmartBuy tracks detailed usage statistics to help merchants understand product performance, assistant effectiveness, and user behavior.
¶ Tracked Metrics:
Weekly token usage (per day)
User device types (Desktop, Mobile, Tablet)
Language of interaction
Monthly stats:
Total token usage
Token usage with/without successful product recommendations
Last 10 product recommendations (with query context and timestamp)
Analytics is accessible via the SmartBuy Admin Dashboard and updated in real-time.
¶ 🚀 5. Integration Instructions
To deploy the SmartBuy Assistant on your website:
Complete the configuration via the admin dashboard.
Copy the auto-generated JavaScript snippet from the “JavaScript Connect Code” field:
<script src="https://aia.gomage.com/js/SmartBuyM2.js?clientUid=...&apiPoint=...&buttonColor=...&bgColor=...&position=..." charset="utf-8"></script>
Paste the script into the <head> or just before </body> of your website’s HTML.
Once deployed, SmartBuy will automatically initialize and be ready to assist customers.
¶ 🧾 System Requirements
Magento 2.4+ (or any platform that supports REST API or GraphQL for product data)
Active AI model access (e.g., OpenAI)
Administrator access to the AiA configuration dashboard