Documentation
Connect your Shopify store and let autonomous agents handle the rest. The entire setup takes under 30 minutes.
Shopify Connection
Connect your store in under 5 minutes
Forge
AI-generated storefronts from a prompt
Resolve
Autonomous customer support
Pulse
Subscriptions, billing, churn prevention
Supply
Stock alerts and auto PO drafts
Ledger
Real P&L with ad spend and COGS
Shopify Store Connection
Three things to connect: your store URL, a theme access password, and an API token. The whole process takes about five minutes.
Store URL
Your Shopify store URL — find it in Settings → Domains. Looks like yourstore.myshopify.com.
Theme Access Password
Install the Shopify Theme Access app from the App Store and generate a password. This lets Forge read and modify your theme safely.
Admin API Token
In Settings → Apps → Develop apps, create a new app called "Optonomous" with the scopes below, then install and copy the access token.
| Scope | Purpose |
|---|---|
read_products write_products | Storefront generation and catalog management |
read_orders | Support, profitability, and inventory signals |
read_inventory | Stock level monitoring and forecasting |
read_customers | Subscription management and churn analysis |
read_fulfillments | Delivery tracking for support and disputes |
Forge
Describe what you sell and Forge builds a conversion-optimized Shopify storefront. No code, no templates, no developer needed.
How it works
Describe your product
Tell Optonomous what you sell, who your customer is, and the brand vibe you want. One paragraph is enough.
Niche analysis
Forge benchmarks top stores in your category — layout patterns, copy structures, pricing psychology, upsell mechanics.
Full storefront generated
Homepage, product pages, bundles, upsell flows, checkout optimization, and trust elements — all ready to publish.
Iterate with prompts
"Make the hero more urgent." "Add a comparison table." "Switch to dark mode." Each version improves on the last.
What gets generated
Hero, social proof, featured products
Optimized copy and imagery layout
"Save more" and tiered offers
Post-purchase one-click upsells
Trust badges, urgency, optimization
Meta tags and structured data
Resolve
Monitors your support inbox, classifies customer intent, drafts replies in your brand voice, and auto-sends when confidence is high.
Setup
Connect your Gmail support inbox via OAuth. Resolve samples your last 20 replies to learn brand voice, then you set an auto-send confidence threshold (default 90%) and choose which intents auto-reply versus queue for your review.
Supported intents
Auto-send vs. queue
Tickets above your confidence threshold are sent automatically. Everything else goes to Slack and the dashboard for review — you can approve, edit, or reject any draft before it's sent.
Pulse
Full subscription engine — billing, payment processing, failed payment recovery, and churn prevention. PCI DSS Level 1 compliant.
Setup
Connect your Shopify store and payment processor (Stripe, or existing ReCharge/Loop). Configure subscription plans — pricing, frequency, trial periods — and set your failed payment retry rules.
Failed payment recovery
When a payment fails, Pulse retries automatically across a 7-day window. Average recovery rate: 60–70%.
Churn prevention
Pulse detects churn signals across the entire platform — cancel intent in support emails (via Resolve), repeated skips or pauses, multiple tickets in a short window, or payments failing after retries. When a signal fires, a save flow triggers automatically: pause offer, discount, product swap, or personal outreach.
Supply
Computes days-of-cover for every SKU, alerts on stock-outs before they happen, and drafts purchase orders automatically.
days_of_cover = on_hand_qty ÷ avg_daily_sales (30d rolling)
Runs every 6 hours, checking every SKU against your thresholds
Thresholds
Slack alert + auto-drafted PO email to your supplier
Dashboard warning + PO recommendation
No action needed
AI generates promo copy to move excess
Chargeback Protection
Real-time chargeback prevention and recovery through Disputely. Taps into Visa RDR, Ethoca, and CDRN alert networks.
How it works
Customer files a dispute
The cardholder contacts their bank to dispute a charge.
Alert intercepted
Card network fires a real-time alert to Disputely before the chargeback is finalized.
Auto-deflection
Disputely auto-refunds qualifying disputes to prevent them from becoming chargebacks.
Evidence compiled
If it escalates, Disputely compiles evidence and submits. Because Optonomous holds your support transcripts, order data, and fulfillment timeline, the evidence package is richer than standalone.
Ledger
See real profit — not just revenue. Connect ad accounts, set COGS, and get true margin per order, per product, per channel.
Data sources
true_profit = revenue − ad_spend − cogs − shipping − fees − returns − chargebacks
Available at store, channel, product, and order level. Updated in real-time.
Security & Privacy
Scoped Access
Limited to theme code, products, orders, inventory, customers, and fulfillments. We cannot view finances, analytics, or staff accounts.
Safe Editing
Theme changes happen on a duplicate. Your live store is never modified. Gmail is scoped to read + send on the support inbox only.
Encryption
TLS 1.3 in transit, AES-256 at rest. API tokens stored in an encrypted vault and never logged.
Compliance
PCI DSS Level 1 compliant for subscription billing. SOC 2 Type II in progress. GDPR-compliant data handling.
Data Retention
90-day retention after disconnection. Full deletion on request at any time.
Transparency
All agent actions are logged in your dashboard. Full audit trail for every automated decision.