Shopify Integration

Connect your Shopify store to give your AI agent real-time access to your product catalog. Your agent can search products, check inventory levels, and provide accurate availability information to customers.

What You Can Do

With Shopify connected, your AI agent can:

• Search products by name, description, or keywords
• Check inventory for specific products and variants
• View product details including pricing, options, and descriptions
• Report stock status accurately in customer responses

Connecting Your Store

Prerequisites

• A Shopify store with products
• Admin access to your Shopify store
• An Airmailer account

Step-by-Step Setup

1. Navigate to Products

   • Click Products in your dashboard sidebar

2. Enter Your Store Domain

   • Enter your Shopify store name (e.g., my-store or my-store.myshopify.com)
   • The domain will be automatically normalized

3. Start OAuth Flow

   • Click Connect Shopify
   • You'll be redirected to Shopify to authorize

4. Authorize Access

   • Review the requested permissions (read-only product access)
   • Click Install app to authorize

5. Connection Complete

   • You'll be redirected back to Airmailer
   • Your store is now connected and ready to use

Permissions

Airmailer requests minimal permissions:

| Permission | Description | |------------|-------------| | read_products | View products, variants, and inventory |

We only request read access—Airmailer cannot modify your products, prices, or inventory.

Using the Integration

Dashboard Search

Once connected, you can search your products directly from the Products page:

1. Enter a search term in the search box
2. View matching products with inventory status
3. Expand products to see variant details

AI Agent Queries

Your agent automatically uses Shopify data when relevant. Example customer interactions:

Customer: "Do you have the Blue Widget in stock?"

Agent response: "Yes! The Blue Widget is currently in stock with 47 units available. You can view it here: [link to product]"

---

Customer: "What colors does the Premium T-Shirt come in?"

Agent response: "The Premium T-Shirt is available in Black, White, Navy, and Heather Gray. All colors are currently in stock."

---

Customer: "Is the Large size available for the Winter Jacket?"

Agent response: "I checked our inventory and the Winter Jacket in Large is currently out of stock. We have Small and Medium available, or I can let you know when Large is back in stock."

Stock Status Indicators

The integration reports inventory using clear status labels:

| Status | Meaning | |--------|---------| | In stock | More than 10 units available | | Low stock | Between 1-10 units available | | Available to order | Out of stock but can be ordered (backorder enabled) | | Out of stock | No inventory and backorder disabled |

Disconnecting

To disconnect your Shopify store:

1. Go to Products in your dashboard
2. Click Disconnect next to your connected store
3. Confirm the disconnection

Disconnecting:

• Removes Airmailer's access to your Shopify data
• Revokes the access token
• Does not affect your Shopify store or products

You can reconnect at any time by going through the connection flow again.

Troubleshooting

Connection Failed

If the OAuth flow fails:

• Ensure you have admin access to the Shopify store
• Check that your store domain is correct
• Try clearing your browser cookies and reconnecting

Products Not Showing

If products don't appear in search:

• Verify products are published in your Shopify store
• Check that products have the "Online Store" sales channel enabled
• Try a different search term

Inventory Shows Incorrect

If inventory seems wrong:

• Inventory syncs in real-time with each query
• Check your Shopify admin for the source of truth
• Ensure inventory tracking is enabled for the product

Token Expired

Access tokens are automatically refreshed. If you see authentication errors:

• Try disconnecting and reconnecting
• Contact support if the issue persists

Best Practices

Optimize Product Data in Shopify

Help your agent find products by:

• Using descriptive product titles
• Adding relevant tags and keywords
• Writing clear product descriptions
• Keeping inventory levels accurate

Combine with Documents

Use Shopify for dynamic data and documents for static information:

| Use Shopify For | Use Documents For | |-----------------|-------------------| | Current inventory levels | Return policy | | Product availability | Shipping information | | Variant options | Size guides | | Pricing | Care instructions |

Set Agent Rules

Add rules to guide how your agent handles product queries:

When asked about product availability, always check
Shopify inventory before responding.

If a product is out of stock, suggest similar
alternatives or offer to notify when back in stock.

Security

Your connection is secured by:

• OAuth 2.0: Industry-standard authorization
• Encrypted tokens: Access tokens encrypted at rest
• HMAC verification: Webhook signatures validated
• Minimal scope: Read-only product access only

Next Steps

• Learn about AI agent capabilities
• Configure agent rules
• View integrations overview