> ## Documentation Index
> Fetch the complete documentation index at: https://docs.woopilot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart Guide

> Connect your WooCommerce store to WooPilot AI in 3 simple steps

# Connect Your Store in 60 Seconds ⚡

Getting started with WooPilot AI requires zero API key generation, zero complex webhook configurations, and zero manual database entries. Everything is handled via a secure, 1-click QR handshake.

```mermaid theme={null}
sequenceDiagram
    autonumber
    actor Merchant as Store Owner
    participant WP as WordPress Plugin
    participant Bot as Telegram Bot (@WooPilotAIBot)
    participant Core as Cloud Core Orchestrator

    Merchant->>WP: 1. Install & Activate Plugin
    WP-->>Merchant: Generates One-Time QR Code (TTL 10m)
    Merchant->>Bot: 2. Scans QR Code with Smartphone
    Bot->>Core: Authenticates Handshake Token
    Core->>WP: Introspects DB Schema & HPOS Status
    Core-->>Bot: Generates Welcome Express Audit
    Bot-->>Merchant: 3. Delivers Retina PNG Dashboard in Telegram!
```

***

## Step 1: Install the WordPress Connector Plugin

1. Download the latest official connector archive:
   [Download Plugin ZIP](https://download.woopilot.xyz/connect-woopilot-assistant.zip)
2. In your WordPress Admin Panel, navigate to **Plugins $\to$ Add New $\to$ Upload Plugin**.
3. Upload the `connect-woopilot-assistant.zip` archive and click **Activate Plugin**.

<Note>
  **Requirements:** WordPress 6.0+, WooCommerce 8.0+, PHP 8.0+, and MySQL 5.7+ (or MariaDB 10.3+). High-Performance Order Storage (HPOS) is fully supported out of the box.
</Note>

***

## Step 2: Scan the Secure Pairing QR Code

1. In your WordPress admin sidebar, navigate to **WooCommerce $\to$ HUB Co-Pilot**.
2. A dynamic, one-time pairing QR code with a 10-minute validity timer will appear on your screen.
3. Open the camera on your smartphone or Telegram app and scan the QR code.
4. Telegram will launch our official bot (`@WooPilotAIBot`) with your encrypted pairing token.
5. Tap **Start** in the Telegram chat.

***

## Step 3: Receive Your Instant Store Express Audit! 🎁

Immediately upon pairing, WooPilot AI conducts an automated, zero-cost express audit of your store and delivers a Retina PNG visual dashboard directly to your Telegram chat:

* Total revenue and order count for the current period.
* Average Order Value (AOV) and top-selling product categories.
* Active WooCommerce HPOS operational status.

***

## Step 4: Try Your First Commands

Simply type or voice-record your query in natural language:

### 1. Financial & Sales Queries

```text theme={null}
"Show yesterday's sales summary with top 3 products and average check"
"Compare this week's revenue to last week and highlight differences"
```

### 2. Catalog & Inventory Reconnaissance

```text theme={null}
"Find all products with stock < 5 units and calculate their total value"
"Show orders in pending payment status for the last 48 hours"
```

### 3. Safe Bulk Modifications

```text theme={null}
"Apply a 10% discount on all winter jackets with stock > 10 units"
"Create a 15% promo coupon for VIP customers valid for 7 days"
```

<Tip>
  When you request store changes, WooPilot AI will generate a **Visual Diff Staging Table** in the Telegram Mini App before touching your live site. You inspect the before/after values and approve with 1 click.
</Tip>


## Related topics

- [Introduction](/introduction.md)
- [WooAuto: The 24/7 Autopilot](/wooauto/overview.md)