# Set up the shopping assistant

The drawer's Chat tab answers shoppers' questions from your own products, policies and answers. Here's how to switch it on, what it knows, and how to make sure a message for your team reaches you.

Source: https://onecounter.app/guides/assistant/

The shopping assistant lives in the drawer's **Chat** tab. Shoppers ask in their own words, in their own language, and it answers from your store: your products and stock, your policies and pages, your Help answers and your rewards program.

## Switch it on

1. In the theme editor, open **App embeds → One Counter** and tick **Chat** under **Tabs**. It's off by default.
2. Select **Save**.
3. Open your store, open the drawer's **Chat** tab and ask a question you know the answer to.

If the reply says *the assistant isn't fully set up on this store yet*, it hasn't been switched on for your store. Email support@onecounter.app.

## What it knows

| It reads | Notes |
| --- | --- |
| Your store policies | Shipping, refund and contact first. Add them in Shopify admin under **Settings → Policies**. |
| Your Online Store pages | Published pages with text, like an About or Size guide page. |
| Your Help answers | See [write your Help answers](https://onecounter.app/guides/help-faq/). |
| Your products | It searches your catalogue live and links every product it names. |
| Stock | Only *in stock*, *low stock* or *out of stock*, never how many. |
| The page the shopper is on | On a product or collection page, so "does this come in a 10?" just works. |
| Your rewards program | Your earning rules and quick ways to earn. A signed-in shopper also gets their own points and recent orders. |
| Your bestsellers | From the last 60 days of orders. |

It refreshes what it knows from your policies, pages and Help answers every hour. To refresh it sooner, open **Apps → One Counter: Drive Loyalty → Settings** and select **Read again** on the **What the concierge knows about your store** card. That card also shows what it read, and nudges you if you have no refund or shipping policy.

## Teach it more

For anything that isn't in a policy, a page or a Help answer, add an entry in **Content → Metaobjects → One Counter Chat Knowledge**, with a **Title / question** and an **Answer / content**. It's used within five minutes. Treat everything you give it as public: it may repeat any of it to a shopper.

## What it won't do

- Make things up. If the answer isn't in what it knows, it says it isn't sure and points to **Need a human?**
- Guess a web address, or name a product without linking it.
- Tell shoppers how many of something you have.
- Offer discounts, refunds or exceptions.
- Chat about things unrelated to your store.
- Buy for a shopper. It can show product cards with an **Add to cart** button, but only the shopper's tap adds anything.

## Where "Need a human?" messages go

Under the chat is **Need a human?**. It opens a short form (**Your email**, **How can we help?**, **Send to the team**), and the shopper is told the team will reply by email.

One Counter emails each message, with the chat so far, to your store's contact email: the one in Shopify admin under **Settings → General**. Reply to that email and your answer goes straight to the shopper. There's nothing to set up.

- A Klaviyo flow on **Concierge Escalation Requested** ([connect Klaviyo](https://onecounter.app/guides/klaviyo/)) runs on the signed-in shopper's own profile, so it suits an auto-reply ("We've got your message"). It doesn't replace the email to your contact address.
- If you use Gorgias, messages open tickets there instead of the email.

The **Where Need a human? messages go** card in the app's **Settings** shows which applies and the address it uses. Send yourself a test through the form before you switch the chat on.

## How many conversations

Each plan includes a number of new conversations a month: **Core 100**, **Growth 300**, **Scale 1,000**. Only a new conversation counts; follow-ups in the same chat don't. **Home** shows how many you've used this month. Past the limit, the chat tells shoppers to use **Need a human?** for the rest of the month. Tapped Help-answer buttons still get their answers.

## Seeing conversations

For a signed-in customer, the last messages of their chats are saved to their customer record in Shopify admin. Your test chats count towards your monthly conversations, so keep testing short.
