> For the complete documentation index, see [llms.txt](https://alhena.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alhena.gitbook.io/docs/integrations/ecommerce/platforms/integrating-alhena-ai-with-solidus.md).

# Solidus

Integrate Alhena with Solidus to provide AI-powered customer support with real-time order and product information.

## Prerequisites

* A Solidus store with admin access
* A Solidus API key

## Getting Your API Key

1. Log in to your Solidus admin panel
2. Navigate to your API settings
3. Generate or copy your API key

## Setup

### Step 1: Enable Solidus in Alhena

1. In Alhena, go to **Settings > Integrations**
2. Find **Solidus** and click **Enable**
3. You'll be taken to the Solidus configuration page

### Step 2: Connect Your Store

1. **Store URL** - Your Solidus store URL (e.g., `https://mystore.com`)
2. **API Key** - Your Solidus API key

Click **Connect** to complete the setup.

***

## Enabled Agents

When you connect your Solidus store, the following agents are enabled:

| Agent                      | Description                                                                |
| -------------------------- | -------------------------------------------------------------------------- |
| **Order management agent** | Handles order inquiries, tracking, and order-related customer support      |
| **Product expert agent**   | Provides detailed product information, specifications, and recommendations |

You can configure these agents in **AI Settings > Agents**.

***

## Recommended: Add Your Store to Training

After connecting, we recommend adding your Solidus store's domain to your training URLs so Alhena can learn from your product pages and help articles. See [Training on Websites](/docs/ai-configuration/data-sources/websites.md) for more information.

***

## Disconnecting

To disconnect your Solidus store:

1. Go to **Settings > Integrations > Solidus**
2. Click **Disconnect**
3. Confirm the disconnection

This will disable the Solidus-connected agents and revoke access to your store data.
