Documentation
Getting Started
Everything you need to go from signup to your first AI-assisted sale.
Quick Start
Connect your store and go live with the Storefront Agent, the product you bought, in under 15 minutes. The GEO audit is optional and comes later.
Create your account
Go to vritantai.com/signup, enter your email, password, and store URL. Choose your platform (Shopify or WooCommerce).
No credit card required for the 14-day free trial.
Connect your store
Shopify. Go to your Shopify Admin, then Settings, then Notifications, then Webhooks. Add a webhook pointing to your VritantAI endpoint:
https://api.vritantai.com/api/v1/integrations/shopify/webhook
HMAC secret: (shown in your VritantAI dashboard → Settings → Integrations)WooCommerce. Install the VritantAI plugin from the .zip in your dashboard, then connect it with your API key:
- Download the VritantAI plugin .zip from your VritantAI dashboard (Settings, then Integrations, then Download WooCommerce plugin).
- In your WordPress admin, go to Plugins, then Add New, then Upload Plugin. Click Choose File, select the .zip you just downloaded, then click Install Now.
- Click Activate once the install finishes.
- In the WordPress sidebar, open WooCommerce, then VritantAI.
- Copy your API key from your VritantAI dashboard (Settings, then Integrations), paste it into the API key field, and click Save changes. The plugin verifies the key and subscribes the product webhooks for you.
A one-click install from the WordPress.org plugin directory is on the way and not yet available. Until that listing is published, the .zip upload above is the way to install the plugin.
Trigger your first catalog sync
Navigate to Data Hub in your VritantAI dashboard and click Sync Catalog. Product ingestion typically completes in 2 to 5 minutes for stores with fewer than 10,000 SKUs.
Go live with your Storefront Agent
In Settings, then Widget, copy your embed script and paste it into your storefront theme just before the closing </body> tag. Your catalog-grounded shopping agent is now live for customers. Full instructions are in the Storefront Agent section below.
Storefront Agent
Embed the catalog-grounded shopping agent on your storefront in minutes.
Ensure catalog sync is complete
The shopping agent is grounded in your catalog. Make sure at least one catalog sync has completed successfully in Data Hub before embedding the widget.
Copy your embed script
Go to Settings, then Widget, and copy your unique embed script:
<script
src="https://cdn.vritantai.com/widget.js"
data-api-key="vc_your_api_key_here"
data-theme="dark"
async
></script>Add to your storefront theme
Paste the script just before the closing </body> tag in your theme. The widget runs in a Shadow DOM and will not conflict with your existing CSS.
Test in sandbox
Go to Sandbox in your VritantAI dashboard to test the agent against your live catalog before your customers see it.
WhatsApp Commerce
Available on Convert Growth and Pro plans. Requires catalog sync to be complete. VritantAI uses Meta Embedded Signup, no Meta Developer account needed on your end.
Make sure your catalog is synced
The WhatsApp agent is grounded in your product catalog. Confirm at least one catalog sync has completed in Data Hub before connecting.
Connect via Meta Embedded Signup
Go to Settings, then Integrations, then WhatsApp and click Connect WhatsApp. A Meta popup will appear. Log in with the Facebook account that owns your WhatsApp Business Account.
Follow the steps in the popup to select your WhatsApp Business Account and phone number. VritantAI automatically discovers your account and subscribes the webhook. No manual configuration required.
Confirm the connection
After completing the popup, the settings page will show your connected phone number and WhatsApp Business Account ID. If you see these, the connection is live.
Set your welcome message
In Settings, then Widget, then WhatsApp, customise the opening message that greets new conversations. Make it specific to your store; mention your product category or a current promotion.
Test a full conversation
Use the Sandbox page to simulate a WhatsApp conversation from product enquiry through to checkout link generation. Verify that only real catalog SKUs appear in responses.
Conversation Intelligence
Turn agent conversations into product and copy insights.
Wait for conversation data to accumulate
Conversation Intelligence clusters become meaningful once you have at least 50 agent sessions. New stores typically reach this within 1 to 2 weeks of launch.
Review VOC clusters
Go to Analytics, then Conversation Intelligence, then VOC Clusters. Clusters are automatically labelled by intent theme (for example “size and fit”, “compatibility questions”, “price sensitivity”).
Act on SKU gap analysis
The SKU gap report surfaces queries that resulted in “no matching product” responses. These are your highest-value unmet demand signals. Consider adding these products or updating existing ones to match shopper language.
Use shopper language in your copy
The shopper language library extracts the exact terms and phrases your customers use. Copy these into your PDP titles, bullet points, and meta descriptions to improve both SEO and AI citation relevance.
GEO Optimisation (optional)
Optional. Once your storefront agent is live, improve your brand's visibility in AI-generated search results.
Submit your first GEO audit
Go to Discovery, then Audits, paste a product page URL, and click Run Audit. Your first scorecard will be ready in under 60 seconds.
Understand your GEO score
Your GEO score is a weighted composite: Schema Markup (50%), Page Performance (30%), Entity Coverage (20%). Scores above 80 indicate strong AI visibility.
Review the issue queue
Each audit surfaces a prioritised list of issues. Critical issues have the highest impact on citation rate and should be addressed first.
Add JSON-LD Product schema
VritantAI auto-generates a patch with the correct schema. Here's an example of the Product schema it produces:
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Brooks Ghost 16 Wide Running Shoe",
"description": "DNA LOFT cushioning, engineered mesh upper, 2E width",
"sku": "GHOST16-2E-BLK-105",
"brand": {
"@type": "Brand",
"name": "Brooks"
},
"offers": {
"@type": "Offer",
"price": "114.95",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
},
"image": "https://example.com/ghost16-black.jpg"
}Approve, deploy, and benchmark
Navigate to Discovery, then Audits, then [audit ID] and click Approve. VritantAI deploys the patch directly to your CMS via the Shopify GraphQL Admin API or WooCommerce REST API. Then run a benchmark under Discovery, then Citations: VritantAI queries Perplexity, ChatGPT, Gemini, Claude, and Copilot and reports citation rates per provider.
Hallucination Monitor
Detect and address fabricated claims about your brand before they reach customers.
Configure your sweep schedule
Go to Discovery, then Hallucination Monitor, then Configure. Set your preferred sweep frequency (daily or weekly) and the LLMs to query. All 5 providers are queried by default.
Define your query seeds
Add the product queries most likely to surface your brand. Examples: “best wide running shoes for men”, “[brand name] ingredient list”, “[product name] reviews”.
Review events as they arrive
Each sweep generates hallucination events with severity (Critical, Warning, Info), exact extracted claims, and a side-by-side comparison to your catalog ground truth.
Resolve or dismiss events
Mark events as Resolved once corrective action has been taken (for example, updated copy, patched schema). Dismiss low-severity events that are not actionable.