> ## 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.

# Troubleshoot the Anam AI Shopping Assistant on Shopify

> Fix a Shopify assistant launcher that doesn't show or calls that don't start, understand call limits, and disconnect or uninstall the app.

## The launcher doesn't show on my store

The launcher shows only when all four setup steps are done. Open the app in your Shopify admin. If a **Setup guide** shows, it lists what's left. Check each of these:

* **Plan.** The store has an active plan. If the plan ended, the launcher hides until you choose a plan again. A cancelled plan keeps working until the end of its billing cycle, and the **Billing** section says when it ends.
* **Anam connection.** The **Anam account** section says the store is connected. Disconnecting hides the launcher.
* **Avatar, voice and language model.** All three are chosen and saved.
* **App embed.** **Video assistant** is on under **App embeds** in your **live** theme, and you clicked **Save** in the theme editor. Turning it on in another theme doesn't change the live one.

If **Video assistant** doesn't appear under App embeds at all, an earlier setup step isn't done. The embed stays hidden in the theme editor until it is.

If the app shows a **Store not updated yet** banner, your store hasn't picked up a change yet. Reload the app page to try again.

## Calls don't start

Calls don't start in the theme editor preview. Open your online store in a separate tab to test.

If the shopper sees **The assistant is unavailable right now.**:

* Check the **Billing** section. If it says "We couldn't check your plan with Shopify, so conversations are paused", reload the page. Contact support if it continues.
* If you renamed the app's proxy, see [the next section](#calls-fail-after-renaming-the-app-proxy).

If the shopper sees **The assistant is not set up yet.**, finish the setup guide in the app.

If the shopper sees **The assistant is busy. Please try again in a little while.**, a call limit was reached. See [Call limits](#call-limits).

## Calls fail after renaming the app proxy

The assistant starts calls through Shopify's app proxy at `/apps/anam` on your store. Shopify lets you change that path for an app. If you changed it, the launcher still shows but calls fail.

To fix it, open **Video assistant** in the theme editor. Under **Advanced**, set **App proxy path** to the new path, such as `/apps/assistant`. Click **Save**.

## Call limits

| Limit | Value | Can you change it? |
| - | - | - |
| Longest call | 10 minutes by default, 1 to 60 | Yes, **Longest call (minutes)** |
| Calls per day for the whole store | 500 by default | Yes, **Calls per day, whole store** |
| Calls per visitor | 6 in 10 minutes, 30 a day | No |
| Calls running at once | 10 | No |

Daily limits reset at midnight UTC. A call usually counts once when it continues across pages. It counts again if it reaches its longest length and carries on, moves to a new page in its last minute, or moves pages twice within a few seconds. See [Limits](https://anam.ai/docs/integrations/shopify/settings.md#limits).

If real shoppers hit the store's daily limit, raise **Calls per day, whole store**. It caps how many storefront calls start, not minutes or dollars, and every minute of a call is billed: 100 storefront calls of up to 10 minutes at $0.10 a minute cost at most $100. Calls that run past midnight UTC, and calls made in Anam Lab on the store's Anam organization, are billed on top. See [Limits](https://anam.ai/docs/integrations/shopify/settings.md#limits).

## Microphone and sound

* **The shopper blocked the microphone.** The call carries on by text and shows "Microphone blocked. You can type to me instead." To talk instead, the shopper allows the microphone for your store in their browser settings.
* **The browser blocks sound until a tap.** Some browsers don't play sound until the shopper taps, for example on iOS when a call continues on a new page. The assistant shows **Continue the call**. The shopper taps it to hear the assistant.

## The assistant adds the wrong product after moving to another page

Shopify themes load each page in full, and the assistant reads the new page each time. A theme that swaps pages in place without a full load, using a library such as Swup or Barba, keeps the call going but keeps the details of the first page. Asking it to "add this" then adds the first page's product. Use a theme that loads each page.

## Conversations don't show

* A call appears about a minute after it ends.
* **Anam isn't connected**: connect Anam on the **Assistant settings** page to read conversations.
* **Couldn't read conversations**: Anam refused the store's connection. On **Assistant settings**, click **Disconnect**, then **Connect Anam** again.

## Disconnect Anam

On **Assistant settings**, under **Anam account**, click **Disconnect**. The app:

1. Ends calls in progress and bills them.
2. Removes the app's access to the store's Anam organization.
3. Hides the launcher on your store.

While disconnected, the store's organization can't start calls, including from Anam Lab, and the Conversations page can't read transcripts. To reconnect, click **Connect Anam**. If you're an owner or admin of the store's organization, Anam offers it again, with its personas and transcripts.

## Uninstall the app

Uninstall from **Settings** > **Apps** in your Shopify admin. When you uninstall, the app ends calls in progress, bills them and removes its access to your Anam organization.

48 hours later, Shopify asks Anam to delete your store's data. Anam then:

* erases the shopper information linked to your store's calls, including transcripts, IP addresses, location and page details
* closes the Anam organization created for your store
* deletes the app's copy of your settings

If you reinstall the app within those 48 hours, your data isn't deleted.

Your Anam login isn't deleted. Anam keeps limited records it needs for billing, security or legal reasons, such as call times and lengths. See the [privacy notice](https://anam.ai/ai-shopping-assistant-privacy) for details.

To turn the assistant off without uninstalling, switch off **Video assistant** under **App embeds** in the theme editor and click **Save**.

## FAQ

> [accordion] Which themes does it work with?
>
> Themes that load each page in full, which is how Shopify themes work by default. The assistant is an app embed, so you don't edit theme code. It adds a launcher to a bottom corner of every page of your online store. A theme that swaps pages in place keeps the call going but loses track of the current product; see [The assistant adds the wrong product after moving to another page](#the-assistant-adds-the-wrong-product-after-moving-to-another-page).

> [accordion] Which languages does the assistant speak?
>
> English. The **Language** setting sets the language the assistant listens for.

> [accordion] Does the call continue through checkout?
>
> No. Going to checkout ends the call. When the shopper comes back to the store, they start a new call.

> [accordion] Can I connect my existing Anam organization?
>
> No. The app connects only to an organization created for the store, because Anam bills its other organizations directly and this store's calls are billed through Shopify. You can build personas in the store's organization in Anam Lab and copy them into the app with **Copy from Lab**.

> [accordion] Can I add an Anam persona to Shopify without the app?
>
> Yes. [Add the Anam Widget to Shopify](https://anam.ai/docs/embed/widget/shopify.md) by editing your theme. Widget calls are billed by Anam on your Anam plan, not through Shopify.

> [accordion] Where do I get help?
>
> Email [support@anam.ai](mailto:support@anam.ai).


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