🛒 Connect Your E-Commerce Store
Link your online store to OmniSocial AI to unlock revenue attribution, AI-generated product posts, and social-to-sales analytics.
Supported Platforms​
OmniSocial AI integrates with three e-commerce platforms, each stored as an EcommerceStore record:
| Platform | Integration Type | Connect Endpoint | Store Model Value |
|---|---|---|---|
| Shopify | OAuth app | POST /ecommerce/shopify | SHOPIFY |
| WooCommerce | API key | POST /ecommerce/woocommerce | WOOCOMMERCE |
| EasyOrders | API key | POST /ecommerce/easyorders | EASYORDERS |
How to Connect​
- Go to Settings > E-Commerce
- Click Connect Store
- Select your platform (Shopify, WooCommerce, or EasyOrders)
- Follow the authorization flow:
- Shopify: You'll be redirected to Shopify to authorize the OAuth app
- WooCommerce / EasyOrders: Enter your store URL and API credentials
- Select which product catalog to sync
When you connect a store, an EcommerceStore record is created with the following fields:
| Field | Description |
|---|---|
platform | SHOPIFY, WOOCOMMERCE, or EASYORDERS |
storeName | Your store's display name |
storeUrl | The URL of your online store |
currency | Default currency for the store |
quickPostSettings | JSON configuration for rapid product post generation |
What Gets Synced​
Once connected, OmniSocial AI pulls your product catalog. Each product is stored as an EcommerceProduct:
| Field | Description |
|---|---|
platformProductId | The product's ID in your store platform |
title | Product name |
description | Product description |
price | Current price |
currency | Price currency |
imageUrl | Primary product image |
productUrl | Direct link to the product page |
status | ACTIVE, DRAFT_PRODUCT, or ARCHIVED_PRODUCT |
inventory | Current stock level |
Ongoing Sync​
Product data syncs automatically on a schedule. You can also trigger a manual sync at any time:
POST /ecommerce/:id/sync
Or in the UI: Settings > E-Commerce > Sync Now
Enable automatic sync to ensure your product posts always reflect current prices, inventory levels, and availability. Out-of-stock products are automatically flagged so you don't promote unavailable items.
Managing Your Store​
Once connected, you can manage your store via the following endpoints:
| Endpoint | Method | Description |
|---|---|---|
/ecommerce/:id | GET | Get store details |
/ecommerce/:id/products | GET | List synced products |
/ecommerce/:id/templates | GET | List product post templates |
/ecommerce/:id/templates | POST | Create a new post template |
/ecommerce/:id/sync | POST | Trigger manual product sync |
Order Tracking​
Beyond products, the system also tracks CommerceOrder data for revenue attribution. Each order captures UTM tracking parameters:
| UTM Field | Description |
|---|---|
utmSource | Traffic source (e.g., "instagram", "facebook") |
utmMedium | Marketing medium (e.g., "social", "paid") |
utmCampaign | Campaign name |
utmContent | Specific content piece (maps to post ID) |
utmTerm | Search term (if applicable) |
referrerUrl | The URL the customer came from |
landingPage | The first page the customer visited |
This data powers the Revenue Attribution system.
Make sure UTM parameters are preserved through your checkout flow. If your store uses redirects that strip UTM params, attribution may be incomplete. Test the flow by clicking a tracked link and verifying the UTM values arrive at checkout.
Next Steps​
- Set up Revenue Attribution to track which social posts drive sales
- Create AI Product Posts to auto-generate content from your catalog
- Configure Auto-Boost rules to promote high-converting product posts