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

# Configure the Anam AI Shopping Assistant on Shopify

> Change the Shopify assistant's avatar, voice, instructions, abilities and call limits, style the launcher in the theme editor, and read call transcripts.

The assistant has two sets of settings:

* **Assistant settings** in the app, for what the assistant is, knows and can do, and your call limits.
* The **Video assistant** app embed in the theme editor, for how the launcher and call look on your store.

## Assistant settings

Open the app from **Apps** in your Shopify admin. Change a setting, then click **Save** in the bar at the top of the page. Your store picks up the change for the next call.

### Assistant

| Setting | What it does |
| - | - |
| **Name** | The assistant's name. Defaults to "Shopping assistant". |
| **Avatar** | The face shoppers see. The preview shows how it looks when a call starts. |
| **Voice** | The voice the assistant speaks with. |
| **Language model** | The model that writes the assistant's replies. |
| **Language** | The language shoppers speak, used for speech recognition. **Organization default** is English unless your Anam organization sets another. The assistant's replies are in English. |
| **Greeting** | What the assistant says first. Leave it empty for an automatic greeting that mentions the product on screen. |
| **What the assistant should know** | Your brand voice, best sellers, sizing advice and anything shoppers often ask. You don't need to add prices, stock or policies: the assistant reads them from your store. |

Avatar, voice and language model list the options available in your store's Anam organization. You can only choose them once Anam is connected.

Shoppers are always told they're talking to an AI. If your greeting doesn't say so, the assistant introduces itself as an AI first, for example "I'm Mia, an AI assistant."

#### Start from a Lab persona

If you built a persona in [Anam Lab](https://lab.anam.ai) in the store's organization, choose it under **Start from a Lab persona** and click **Copy from Lab**. The app copies the persona's avatar, voice, model, name and instructions, and saves them. You can change any of them afterwards. Later changes to the persona in Lab don't update the app.

### What it can do

All three are on by default.

| Setting | What it allows |
| - | - |
| **Add to and change the shopper's cart** | Adding products and changing quantities in the shopper's cart. |
| **Open product and collection pages** | Taking the shopper to another page. The call reconnects on the new page in a second or two. |
| **See the page and point at things on it** | Reading the page's buttons, links and headings, and highlighting them. It never reads what the shopper types into the page's forms. |

### Limits

| Setting | Default | Range |
| - | - | - |
| **Longest call (minutes)** | 10 | 1 to 60 |
| **Calls per day, whole store** | 500 | 1 to 100,000 |

**Calls per day** limits spending if someone abuses the launcher. It caps how many storefront calls start each day, not minutes or dollars. Each call can run up to **Longest call (minutes)**, so 100 storefront calls of up to 10 minutes cost at most $100 at $0.10 a minute. It resets at midnight UTC. Your bill can still go past that: a call that started before midnight keeps running, and calls made in Anam Lab or with another key on the store's Anam organization are billed through Shopify too.

A call usually counts once when it continues across pages. It counts again when it reaches its longest length and carries on, when it moves to a new page in its last minute, or when it moves pages twice within a few seconds.

The app also applies limits you can't change:

* Each visitor can start up to 6 calls in 10 minutes and 30 calls a day (UTC). The app recognizes signed-in customers by a one-way hash of their customer ID, and guests by a random ID stored in their browser.
* Your store's Anam organization runs up to 10 calls at the same time.

When a visitor or the store reaches its daily or per-visitor limit, the shopper sees "The assistant is busy. Please try again in a little while."

### Billing and Anam account

* **Billing** shows your plan status and your minutes of conversation in the last 30 days. **Manage plan** opens Shopify's plan page.
* **Anam account** shows which Anam organization the store is connected to, with a **Disconnect** button. See [Disconnect Anam](https://anam.ai/docs/integrations/shopify/troubleshooting.md#disconnect-anam).

## Theme editor settings

Open the app embed from **Online Store** > **Themes** > **Customize** > **App embeds** > **Video assistant**, or click **Open theme editor** in the app. Click **Save** in the theme editor after you change anything.

### Launcher

| Setting | Default | Notes |
| - | - | - |
| **Style** | Face and label | Or **Face only**. Phones always show the face only. |
| **Label** | Ask me anything | A line under it says it's an AI assistant. |
| **Assistant name** | Empty | Leave empty to use the name from the app's settings. |

### Placement

| Setting | Default | Notes |
| - | - | - |
| **Corner** | Bottom right | Or **Bottom left**. |
| **Distance from the side** | 20 px | 0 to 80 px. |
| **Distance from the bottom** | 20 px | 0 to 120 px. Raise it to clear a cookie banner, chat button or sticky **Add to cart** bar. |
| **Video size** | Regular | Or **Small** or **Large**. The video shrinks when it would cover the buy buttons. |

### Colors and shape

| Setting | Default | Notes |
| - | - | - |
| **Accent** | `#1f3d2b` | |
| **Text on accent** | `#ffffff` | |
| **Corner radius** | 18 px | 0 to 28 px. |
| **Use the theme's font** | On | |
| **Remove green-screen background** | Off | Works with avatars filmed on a solid green background. |

### During a call

| Setting | Default | Notes |
| - | - | - |
| **Show captions** | On | |
| **Let shoppers type as well as talk** | On | Adds a keyboard button to the call. Shoppers who block the microphone can always type. |

### Advanced

| Setting | Default | Notes |
| - | - | - |
| **App proxy path** | `/apps/anam` | Change it only if you renamed the app's proxy in your Shopify admin. See [Renamed app proxy](https://anam.ai/docs/integrations/shopify/troubleshooting.md#calls-fail-after-renaming-the-app-proxy). |

### Turn the assistant off

In the theme editor, open **App embeds**, switch off **Video assistant**, then click **Save**. To use the assistant with another theme, open that theme in the theme editor and turn it on there.

## Conversations

The app's **Conversations** page lists each call shoppers made on your storefront, newest first, with:

* when it started
* the shopper's first question
* the page it started on, and how many other pages it continued on
* its length

Click a conversation to read its transcript. The details panel shows the products the assistant added to the cart. Products a shopper added themselves from a product card aren't listed.

A call appears about a minute after it ends. A call that continues across pages shows as one conversation, unless it counted again as a new call (see [Limits](#limits)). The rest of it then shows as a separate conversation.

Anam keeps transcripts while the app is installed. Audio and video aren't recorded. You can also read the calls in the store's organization in Anam Lab. To have one conversation deleted sooner, email [support@anam.ai](mailto:support@anam.ai) with the date and time shown for it on the Conversations page.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.