# Conversora Platform Documentation & Publications (llms.txt)

> Conversora is an autonomous AI commerce employee and CMS for independent merchants and modern commerce brands. It automates catalog management, storefront publishing, omnichannel Instagram & Facebook DM sales, order processing, and customer care on Cloudflare Workers edge runtime.

## Core Features & System Capabilities

- **AI Store Employee**: Autonomous conversational commerce operator with customizable guardrails (discount limits, business hours, human escalation thresholds).
- **Omnichannel Inbox**: Unified customer messaging across Instagram Direct Messages, Facebook Messenger, WhatsApp, and Telegram.
- **Visual No-Code Storefront Builder**: Responsive online store builder with custom themes, localized typography (Bengali & English), and block styling.
- **Catalog & Inventory Engine**: Complex multi-option variants, barcode/SKU tracking, low-inventory alerts, and Cloudflare R2 media optimization.
- **Orders & Fulfillment**: End-to-end lifecycle tracking, automatic branded PDF invoice generation, and courier delivery zone calculation.
- **Payment Infrastructure**: Stripe credit cards, local payment gateways (bKash, Nagad, Rocket, Bank Wire), and Cash on Delivery (COD).
- **Custom Domains & SSL**: Automated Cloudflare edge SSL certificate provisioning for custom domains.
- **Headless Commerce API**: REST endpoints, webhook subscriptions with HMAC signatures, and Meta MCP integration.

## Documentation Index & Direct URLs

### Getting Started
- [Quickstart Guide: Launch Your AI-Powered Store in 5 Minutes](https://conversora.io/docs/getting-started/quickstart-guide): A fast-track onboarding guide to configure your store brand, add your first inventory items, connect Meta social channels, and enable your autonomous AI sales employee.
- [Store Profile, Currency, Timezone & Team Members](https://conversora.io/docs/getting-started/business-profile-onboarding): Detailed guide to setting up your company profile, legal details, operating currency, local timezones, and inviting team members with role-based permissions.
- [Multi-Tenant Store Management & Instant Store Switching](https://conversora.io/docs/getting-started/multi-store-management): Learn how Conversora's multi-tenant architecture enables you to create, manage, and switch between multiple brand stores from a single unified console.
- [Conversora Architecture: Edge Computing, AI & Multi-Tenancy](https://conversora.io/docs/getting-started/architecture-how-it-works): An architectural deep dive into Conversora's global Cloudflare Workers edge runtime, multi-tenant database isolation, and real-time asynchronous queue pipelines.

### AI Store Employee & Memory
- [Conversora AI Employee: Autonomy, Capabilities & Operating Modes](https://conversora.io/docs/ai-employee/ai-operator-overview): Meet Aura, your autonomous retail sales employee that answers customer questions, recommends products, applies promotions, and takes orders 24/7 across social channels.
- [Training Your AI: FAQs, Document Uploads & Store Rules](https://conversora.io/docs/ai-employee/knowledge-base-training): Learn how to feed your brand's sizing charts, return policies, shipping guidelines, and custom business rules into your AI employee's semantic knowledge base.
- [AI Safety Guardrails, Discount Ceilings & Human Escalation](https://conversora.io/docs/ai-employee/guardrails-safety-thresholds): Protect profit margins and brand integrity with strict discount ceilings, sentiment-based escalation, and prohibited topic guardrails.
- [AI Assistant Memory, Fact Candidate Review & Cognitive Settings](https://conversora.io/docs/ai-employee/assistant-memory-learning): Discover how Conversora's long-term semantic memory remembers customer preferences and stages learned facts for merchant review.

### Omnichannel Social Inbox & Studio
- [Connecting Instagram DMs & Facebook Messenger](https://conversora.io/docs/omnichannel-inbox/connecting-meta-channels): Connect your official Instagram Business account and Facebook Page using Facebook Login for Business to enable automated messaging and unified inbox management.
- [Connecting Telegram Bot for Customer Support & Store Alerts](https://conversora.io/docs/omnichannel-inbox/connecting-telegram-bot): Create and connect a custom Telegram bot to handle customer conversations, receive instant order notifications, and alert staff of escalated chats.
- [Managing Conversations: Unified Inbox, Customer Context & Handoff](https://conversora.io/docs/omnichannel-inbox/autopilot-vs-manual-mode): Master the Omnichannel Inbox: view customer context, review AI drafts, and seamlessly take over conversations in real time with automated pausing.
- [AI Social Post Scheduler: Auto-Generate & Publish Content](https://conversora.io/docs/omnichannel-inbox/social-post-scheduler): Draft, schedule, and auto-publish marketing posts, product highlights, and carousel announcements across Instagram and Facebook with AI copy generation.

### Storefront & Website Builder
- [Visual No-Code Storefront Builder: Customizing Your Website](https://conversora.io/docs/storefront-builder/visual-canvas-editor): Design and customize your high-converting online storefront using Conversora's drag-and-drop visual layout editor with live mobile and desktop previews.
- [Theme Styling: Custom Colors, Typography & Brand Presets](https://conversora.io/docs/storefront-builder/theme-typography-colors): Personalize your storefront design with custom brand color palettes, Google font pairings, card styles, and accessible contrast ratios.
- [Creating Custom Pages: About Us, Contact, Policies & FAQs](https://conversora.io/docs/storefront-builder/custom-content-pages): Create and publish SEO-optimized policy pages, brand stories, contact forms, and custom landing pages with rich text formatting.

### Catalog, Variants & Media
- [Adding Products, Multi-Option Variants & SKU Tracking](https://conversora.io/docs/catalog-inventory/products-variants-skus): Manage your product catalog, build multi-option variant combinations (Size x Color), track physical inventory, and prevent overselling.
- [Organizing Catalog: Hierarchical Categories & Smart Collections](https://conversora.io/docs/catalog-inventory/categories-and-collections): Structure your catalog with intuitive multi-level category trees and dynamic automated collections based on price, tags, or popularity.
- [Media Asset Library: Cloudflare R2 Storage & Optimization](https://conversora.io/docs/catalog-inventory/media-asset-library): Upload, organize, and manage brand photography with zero egress fees and automated WebP edge compression powered by Cloudflare R2.

### Orders, Invoicing & Fulfillment
- [Order Processing Lifecycle: From Placed to Delivered](https://conversora.io/docs/orders-fulfillment/order-management-lifecycle): Master the complete order lifecycle: track incoming orders, transition fulfillment statuses, manage customer notifications, and handle cancellations or returns.
- [Automatic PDF Invoices & Printable Customer Receipts](https://conversora.io/docs/orders-fulfillment/invoicing-receipts): Generate legally compliant, branded PDF tax invoices, warehouse packing slips, and 80mm thermal receipts with automatic QR and barcode generation.
- [Courier Shipping Rates, Delivery Zones & Local Logistics](https://conversora.io/docs/orders-fulfillment/courier-shipping-zones): Configure delivery zones (Inside Dhaka vs Outside Dhaka), automated shipping rates, and seamless courier integrations with Steadfast, Pathao, and RedX.

### Payments, Discounts & Checkout
- [Setting Up Stripe & Credit Card Payments](https://conversora.io/docs/payments-checkout/payment-gateways-stripe): Accept international Visa, Mastercard, American Express, Apple Pay, and Google Pay with automated webhook reconciliation powered by Stripe.
- [Setting Up bKash, Nagad, Bank Wire & Cash on Delivery (COD)](https://conversora.io/docs/payments-checkout/local-payments-bdt): Enable popular Bangladeshi payment methods: automated bKash merchant checkout, manual Nagad/bKash TrxID verification, and Cash on Delivery.
- [Discounts, Promo Coupons & Digital Gift Cards](https://conversora.io/docs/payments-checkout/discounts-coupons-gift-cards): Create high-converting promotional coupon codes (percentage or fixed amount), set minimum order spends, and issue customer gift cards.

### Custom Domains & SSL
- [Connecting a Custom Domain (CNAME & A Records Setup)](https://conversora.io/docs/custom-domains/connecting-custom-domain): Connect your branded custom domain (e.g., yourbrand.com or store.yourbrand.com) with automated Cloudflare edge SSL certification and global CDN routing.
- [Troubleshooting Custom Domain DNS & SSL Issues](https://conversora.io/docs/custom-domains/domain-troubleshooting): Diagnose and resolve common DNS propagation delays, Cloudflare proxy conflicts, CAA record blocks, and SSL pending states.

### Notifications & Merchant Alerts
- [Customer Notification Templates: SMS, WhatsApp & Email Alerts](https://conversora.io/docs/notifications-alerts/customer-notifications-templates): Automate transactional customer alerts for order confirmations, fulfillment dispatches, tracking links, and delivery notices across SMS, WhatsApp, and email.

### Analytics, Live View & Strategy Lab
- [Analytics Dashboard: Live Traffic, Sales Funnel & UTM Attribution](https://conversora.io/docs/analytics-reports/live-feed-dashboard): Monitor real-time visitor sessions, Gross Merchandise Value (GMV), conversion funnels, and marketing campaign attribution.
- [Exporting Financial, Inventory & Sales Reports (PDF / CSV)](https://conversora.io/docs/analytics-reports/exporting-pdf-csv-reports): Export itemized sales spreadsheets, inventory audits, and branded PDF executive financial summaries for accounting and business reviews.

### Developer API, Webhooks & Meta MCP
- [Headless Commerce REST API & Webhook Subscriptions](https://conversora.io/docs/developer-api/headless-commerce-api): Integrate Conversora with custom mobile apps, external ERPs, point-of-sale systems, and warehouse barcode scanners using our secure REST API.
- [Model Context Protocol (MCP) Integration & AI Tool Hooks](https://conversora.io/docs/developer-api/meta-mcp-model-context-protocol): Expose your store's inventory, order management, and customer data to external AI agents using Anthropic's standardized Model Context Protocol (MCP).

### Troubleshooting & FAQs
- [Troubleshooting: Meta OAuth Reconnection & Permission Fixes](https://conversora.io/docs/troubleshooting-faqs/meta-token-reconnect): Learn how to resolve expired 60-day user tokens, Facebook Page password reset invalidations, and reconnect Instagram DMs in under 60 seconds.
- [Troubleshooting: AI Escalations & 'Needs You' Queue Management](https://conversora.io/docs/troubleshooting-faqs/ai-message-escalation-faq): Understand why Aura Bot escalates certain customer chats, how to prioritize the 'Needs You' queue, and best practices for human-agent handoffs.

## Company Publications & Engineering Blog

- [Introducing Conversora: The Autonomous AI Employee for Modern Commerce](https://conversora.io/blog/introducing-conversora-the-ai-employee-for-modern-commerce): Why we built an AI employee that finishes the day-to-day operational work—launching storefronts, closing social DMs, issuing invoices, and compounding memory.
- [Why Conversational Commerce Outperforms Traditional Storefront Funnels by 4x](https://conversora.io/blog/why-conversational-commerce-is-replacing-traditional-storefront-funnels): How meeting customers where they spend their attention—on Instagram DMs, Messenger, and WhatsApp—slashes abandoned carts and accelerates buyer decisions.
- [Engineering Deep Dive: Building Sub-50ms Multi-Tenant Storefronts on Cloudflare Workers](https://conversora.io/blog/how-we-built-sub-50ms-multi-tenant-storefronts-on-cloudflare-workers): Architecting Next.js 16, OpenNext, PostgreSQL Hyperdrive connection pooling, and strict tenantDb isolation for global edge performance.
- [Mastering Social Selling: The Complete Guide to Instagram & Facebook DM Automation](https://conversora.io/blog/mastering-social-selling-instagram-dm-automation-guide): Actionable playbook to turn comments, story mentions, and direct messages into repeat customers using automated social funnels.
- [Powering the Local Commerce Boom: Native Bangla AI, bKash & Cash on Delivery](https://conversora.io/blog/bangladesh-ecommerce-revolution-bengali-ai-and-local-payments): Why native Bengali NLP, Hind Siliguri typography, bKash/Nagad verification, and COD logistics are transforming South Asian digital commerce.

## Key Architectural Invariants
- Multi-Tenant Isolation: Every database query is scoped strictly by `tenantDb(storeId)`.
- Global Edge Delivery: Served via Cloudflare Workers with OpenNext for sub-50ms latency.
- Real-Time Webhook Processing: Deduplicated, idempotent event intake for Meta Graph API webhooks.