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

# Setup

# Connecting Shopify to ChatCrafterAI

Follow these steps to connect your Shopify store to ChatCrafterAI.

## Prerequisites

Before starting, ensure you have:

* A Shopify store (any plan)
* Shopify admin access
* API credentials ready

## Step-by-Step Setup in ChatCrafterAI

1. Navigate to **Agent Settings** → **Integrations**
2. Click **Add Integration** → Select **Shopify**
3. Enter your **Store URL** (e.g., mystore.shopify.com)
4. Paste your **Access Token**
5. Paste your **API Key**
6. Click **Connect**
7. Verify the status shows **Connected**
8. Click **Test Connection** to verify

## Getting Shopify Credentials

### Create Custom App

1. Log into your **Shopify Admin** dashboard
2. Go to **Settings** → **Apps and sales channels**
3. Click **Develop apps** → **Create an app**
4. Name it **ChatCrafterAI**
5. Click **Create app**

### Configure API Access

1. In your new app, click **Configure Admin API scopes**
2. Enable these permissions:
   * `read_products` - View product information
   * `read_orders` - View order information
   * `read_customers` - View customer information
   * `read_inventory` - Check stock levels
3. Click **Save**

### Get Access Token and API Key

1. Click **Install app** at the top
2. Confirm installation
3. Copy the **Admin API access token** (shown once - save it securely)
4. Go to **API credentials** tab
5. Copy the **API key**

### Paste into ChatCrafterAI

1. Return to ChatCrafterAI integration setup
2. Paste **Access Token** in the first field
3. Paste **API Key** in the second field
4. Enter your store URL (format: yourstore.shopify.com)
5. Click **Connect**

## Store URL Format

Your store URL should be in this format:

* **Correct:** `mystore.shopify.com`
* **Incorrect:** `https://mystore.shopify.com` (no protocol)
* **Incorrect:** `mystore.com` (use Shopify subdomain)

## Verification

After setup, verify the connection works:

1. Open **Chatlab** (ChatCrafterAI testing environment)
2. Send test message: "What products do you have?"
3. Agent should return list of products from your store
4. If error appears:
   * Verify credentials are copied exactly (no spaces)
   * Check API permissions are enabled correctly
   * Ensure store URL format is correct

## Troubleshooting Setup

**Connection failed?**

* Verify access token is valid (not expired)
* Check API key matches the custom app
* Ensure all required permissions are enabled
* Confirm app is installed in your store

**"Unauthorized" error?**

* API scopes may be missing - add required permissions
* Access token might be incorrect
* App might not be installed properly

**Products not showing?**

* Verify products exist in your Shopify store
* Check products are published (not draft)
* Ensure inventory tracking is enabled

## Security Notes

* Store access token securely - it provides read access to your store data
* Use dedicated custom app for ChatCrafterAI (don't share credentials)
* You can revoke access anytime by uninstalling the app in Shopify
* ChatCrafterAI only requests read permissions (cannot modify your store)

## Next Steps

Now that Shopify is connected, learn about [Available Actions](./actions) your agent can perform.