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

# Create Agent from Shopify

> Build a WhatsApp shopping assistant for your Shopify store in minutes

Connect your Shopify store to create an AI agent that knows your products, handles customer questions, and can check orders in real-time.

## What You Get

A Shopify-connected agent can:

* **Answer product questions** — Details, availability, pricing
* **Help with orders** — Check order status, shipping updates
* **Handle returns** — Explain your return policy, initiate return requests
* **Provide recommendations** — Suggest products based on customer needs
* **Share collection links** — Direct customers to relevant product pages

## Prerequisites

Before you begin:

* A Shopify store with products listed
* Admin access to your Shopify account
* A Wassist account ([sign up free](https://wassist.app/login))

## Step-by-Step Guide

<Steps>
  <Step title="Navigate to New Agent">
    From your [dashboard](https://wassist.app/agents), click **New Agent**.
  </Step>

  <Step title="Select 'Connect Shopify'">
    Choose the **Connect Shopify** option.
  </Step>

  <Step title="Enter Your Store URL">
    Provide your Shopify store URL:

    ```
    https://your-store.myshopify.com
    ```

    or your custom domain:

    ```
    https://www.yourstore.com
    ```
  </Step>

  <Step title="Authorize Wassist">
    You'll be redirected to Shopify to authorize Wassist. Grant the requested permissions so we can:

    * Read your product catalog
    * Access order information (for order status queries)
    * Read customer data (for personalized support)

    <Note>
      Wassist only reads data from your store. We never modify your products, orders, or customer records.
    </Note>
  </Step>

  <Step title="Wait for Sync">
    Wassist imports your:

    * Products and variants
    * Collections
    * Store policies (shipping, returns, etc.)
    * Store information

    This typically takes 2-5 minutes depending on catalog size.
  </Step>

  <Step title="Customize Your Agent">
    Review the generated agent and customize:

    * Adjust the welcome message
    * Add specific instructions for your brand voice
    * Configure which features to enable (order lookup, etc.)
  </Step>
</Steps>

## Agent Capabilities

<AccordionGroup>
  <Accordion title="Product Discovery" icon="magnifying-glass">
    Customers can ask natural language questions about your products:

    * "Do you have any red dresses under \$100?"
    * "What sizes is the Classic T-shirt available in?"
    * "Show me your best-selling items"

    The agent searches your catalog and returns relevant products with images and links.
  </Accordion>

  <Accordion title="Order Tracking" icon="truck">
    Customers can check their order status:

    * "Where is my order?"
    * "What's the status of order #1234?"

    The agent looks up order details and provides shipping updates.

    <Note>
      Customers must verify their identity (usually via the phone number they ordered with) before accessing order details.
    </Note>
  </Accordion>

  <Accordion title="Policy Questions" icon="file-contract">
    Your store policies are automatically imported:

    * "What's your return policy?"
    * "How long does shipping take?"
    * "Do you ship internationally?"
  </Accordion>

  <Accordion title="Collection Browsing" icon="layer-group">
    Direct customers to relevant collections:

    * "Show me your summer collection"
    * "What's new this week?"
  </Accordion>
</AccordionGroup>

## Configuring Order Lookup

To enable order status queries:

1. Go to your agent's **Tools** section
2. Enable **Order Lookup**
3. Configure verification method:
   * **Phone Number Match** — The customer's WhatsApp number must match the order
   * **Order Number + Email** — Customer provides order number and email

<Warning>
  Always require verification before sharing order details. This protects your customers' privacy.
</Warning>

## Keeping Products Synced

Your Shopify catalog updates automatically every 24 hours. For immediate sync:

1. Go to your agent's **Settings**
2. Click **Sync Now** under Shopify Integration

<Tip>
  Major catalog updates (new collections, sales events) should trigger a manual sync to ensure your agent has the latest information.
</Tip>

## Customizing Product Responses

Control how your agent presents products:

```
System Prompt Addition:

When showing products:
- Always mention if an item is on sale
- Include available sizes and colors
- Offer to check inventory for specific sizes
- End product recommendations with "Would you like me to send you the link to purchase?"
```

## Example Conversations

<Tabs>
  <Tab title="Product Search">
    **Customer:** I'm looking for a gift for my mom. She likes gardening.

    **Agent:** I'd love to help you find the perfect gift! We have several items that gardeners love:

    🌱 **Garden Tool Set** - \$45.00
    Premium stainless steel tools with ergonomic handles

    🌸 **Floral Apron** - \$28.00
    Water-resistant with deep pockets

    🪴 **Indoor Herb Kit** - \$35.00
    Grow basil, mint, and cilantro at home

    Would you like more details on any of these?
  </Tab>

  <Tab title="Order Status">
    **Customer:** Where's my order? I ordered 3 days ago.

    **Agent:** I'd be happy to check on that for you! I can see you're messaging from the phone number associated with a recent order.

    📦 **Order #1847**
    Status: Shipped
    Carrier: USPS
    Tracking: 9400111899223847562

    It's currently in transit and expected to arrive by Friday. Would you like me to send you the tracking link?
  </Tab>
</Tabs>

## SDK Alternative

Create a Shopify agent programmatically:

```typescript theme={null}
const agent = await client.onboarding.createFromShopify({
  shopifyUrl: 'https://your-store.myshopify.com',
});
```

## What's Next

<CardGroup cols={2}>
  <Card title="Add Custom Tools" icon="plug" href="/guides/configure-tools">
    Connect additional APIs like loyalty programs or reviews.
  </Card>

  <Card title="Set Up Monetization" icon="dollar-sign" href="/guides/monetization">
    Offer premium support tiers.
  </Card>

  <Card title="Deploy to WhatsApp" icon="rocket" href="/guides/deploy-agent">
    Go live with your shopping assistant.
  </Card>
</CardGroup>