> For the complete documentation index, see [llms.txt](https://docs.eesel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eesel.ai/use-cases/e-commerce-sales-rep.md). # E-commerce Sales Rep Set up an AI chatbot for ecommerce on Shopify, Magento or WooCommerce. It recommends products, checks stock and looks up orders before and after a sale. An AI chatbot for ecommerce is an AI sales assistant that answers shoppers on your store and in your helpdesk. eesel's agent reads your products, storefront pages, blog and policies, recommends products, checks live stock, and shows items as cards a shopper can add to their cart. After a sale it looks up orders, checks tracking, starts returns, fixes shipping addresses, refunds and cancels. It works with Shopify, Magento and WooCommerce stores.

An online store with the eesel chat open, where a customer asks for a refurbished iPhone 13 and the agent replies with two matching products shown as cards, each with condition and price — A customer asks for a product. Your teammate checks live stock and answers with the actual items, prices and condition.

**Works with:** [Shopify](/integrations/e-commerce/shopify.md), [Magento](/integrations/e-commerce/magento.md), [Chat Bubble](/integrations/chat-surfaces/chat-bubble.md), [Gorgias](/integrations/helpdesks/gorgias.md), [Zendesk](/integrations/helpdesks/zendesk.md). ## Set up your AI sales assistant Open the chat in your dashboard and say what you want to set up. The steps below are what that conversation covers. {% stepper %} {% step %} ### Connect your store Ask your agent to connect Shopify. It lays out the two ways to connect and asks for your store name. The store name is the part before `.myshopify.com`.

The dashboard chat where the user asks to connect Shopify and the agent explains Quick start and Full connection, then asks for the store name — The agent explains the two ways to connect and asks for your store name.

* **Quick start.** A read of your public storefront, with no sign-in. It searches products and shows product cards with **Add to Cart**. It cannot look up orders and it has no write actions. * **Full connection.** Orders, customers, products, tracking and refunds, read from Shopify directly. For a full connection your agent posts a link. A person approves this in the browser.

The dashboard chat where the user gives the store name and asks for a full connection, and the agent posts a Connect link for the store to open in the browser — The agent posts a connect link for your store.

Start with either one. Moving from Quick start to a full connection later loses nothing you have already read in. {% endstep %} {% step %} ### Add the chat bubble Ask your agent for a chat bubble on your storefront. It reads your site, then sets the colour, the welcome message and the starter questions.

The agent reports the bubble it set up and the preview link.

The Chat Bubble settings page shows the same fields. [Chat Bubble](/integrations/chat-surfaces/chat-bubble.md) has the full settings and the embed steps.

The Chat Bubble settings page in the eesel dashboard, showing the Configuration heading, the Messages and content section with Welcome Message, Title and Agent name fields, and Open preview and Copy code buttons at the top right — The top of the settings page, with the Messages and content fields.

{% endstep %} {% step %} ### Brief it on how you sell and support Tell it which products to steer toward, your returns window, what needs a person, and any discount codes it can use. Upload the procedure documents your team already works from. Correct it as you test and it saves the rules to its own instructions. Say it in the chat and the agent writes it into its instructions.

The dashboard chat where the user tells the agent which questions to answer directly and which to escalate to a person, and the agent saves the rule — The brief given in chat, saved to the agent's instructions.

The saved rules sit on the Instructions page, where you can read or edit them.

The Instructions page showing the handover process and the customer query rules the agent saved — The Instructions page with the saved brief.

{% endstep %} {% step %} ### Tell it which actions it can take Tell it in chat what it may do in your store. **Integrations > Shopify** shows the same settings, with **Actions** grouped as Read and Write.

The Shopify integration page in the eesel dashboard showing Connected with the store name, the Pages, Products, Blog Articles and Policies sources with document counts, and the Read and Write action groups — The Shopify integration page, with the Read and Write action groups.

{% endstep %} {% step %} ### Give it a way to escalate Tell your agent what to do when a shopper needs a person. Here it is asked to create a [Gorgias](/integrations/helpdesks/gorgias.md) ticket, collect a name and email first, and tag the ticket.

A dashboard chat where the user asks for chat bubble handover that creates a tagged Gorgias ticket after collecting contact details, and the agent lists the five steps it wired up — Ask for the handover rule in plain words and the agent writes it out.

It saves the rule to its own instructions and links the page. It also checks the details it guessed, such as the inbox address it will send tickets to.

The same chat scrolled down, where the agent asks the user to confirm the Gorgias inbox address it used and then links the instructions page — It confirms the inbox address it used and links your Instructions page.

Open that link to read or edit the saved rule.

The Instructions page showing the saved Chat bubble handover rule as five numbered steps, including the Gorgias ticket create and tag commands — The handover rule on your Instructions page, where you can edit it yourself.

Your agent can also hand a chat to another live chat widget, such as Zendesk Messenger or Freshchat. See [Chat Bubble](/integrations/chat-surfaces/chat-bubble.md). Test it in the bubble. A shopper asks for a person, and your agent asks for a name and email address.

The chat bubble on the live site where a visitor asks to talk to a real person about a damaged item, and the agent says it will escalate to the team and asks for a name and email address — The agent taking the escalation and asking for a name and email address.

It creates the ticket and confirms the number in the chat.

The same chat where the visitor gives a name and email address, and the agent confirms it created a ticket with its number and says the team will be in touch at that address — The agent confirming the ticket number to the visitor.

The ticket lands in your helpdesk with the tag you asked for.

A Gorgias ticket opened from a chat bubble handover, showing the visitor's email address as the requester, a summary of the conversation as the first message, and a handover tag in the ticket details panel — The handover ticket in the helpdesk, tagged.

{% endstep %} {% step %} ### Put it where your customers are Open the Chat Bubble settings page, scroll to the **Install** section and press **Copy code**.

The bottom of the settings page showing the Hand over to another live chat widget provider dropdown reading Select a provider, and the Install section with the code snippet and a Copy code button — The handover provider dropdown and the Install section.

Paste the snippet before the closing body tag in your theme. On Shopify that file is `theme.liquid`.

The Shopify code editor with theme.liquid open, the eesel loader snippet pasted at the end of the file on the lines before the closing body tag — The snippet pasted into the Shopify theme layout file.

Connecting alone does not start your agent. It needs an automation first. Ask in chat to turn on the bubble automation, then a shopper gets product cards in the bubble.

A storefront home page with the eesel chat bubble open, where a shopper asks for a beginner recommendation and the agent replies with advice and starts a product carousel below it — The chat bubble answering a recommendation question from the live catalogue.

[Chat Bubble](/integrations/chat-surfaces/chat-bubble.md) has the steps for other platforms. {% endstep %} {% endstepper %} {% hint style="info" %} **From Claude Code, Cursor or a terminal.** The same setup works as commands: `eesel login`, then `eesel init chat-bubble --site https://your-store.com` to put the bubble on the store and start it reading the site, and `eesel integrations connect shopify` for the store itself. The approval is a human step: print the link for a person, wait for the connection status to change, and do not retry the link. Full command reference: [The eesel CLI](/apis-and-developer-resources/cli.md). Step-by-step: [Set up from Claude Code or the terminal](/getting-started/set-up-from-a-coding-agent.md). {% endhint %} *** ## What your agent can do ### Sell | It can | What that looks like | | --------------------------------- | ---------------------------------------------------------------- | | **Search your products** | Finds products matching what the shopper described | | **Check real stock and variants** | Size, colour, product code, price, and whether it is available | | **Read product details** | Specs and custom fields, not only title and price | | **Show products as cards** | Matching items shown as a carousel in chat, with **Add to Cart** | | **Show the cart** | Displays the shopper's live cart as a card in the chat bubble | ### Support | It can | What that looks like | | ----------------------------- | --------------------------------------------------- | | **Look up an order** | By identifier, or by searching a customer's history | | **Check fulfilment** | Where the parcel is and which carrier has it | | **Find a customer** | Profile and past orders from their email address | | **Start a return** | Creates the return on the order | | **Update a shipping address** | Changes the delivery address on an order | | **Refund an order** | Full or partial | | **Cancel an order** | For anything that has not shipped yet | You stay in control the whole way. Adjust your AI agent's access to knowledge and its action permissions to your liking. See [Actions and Approvals](/instructions-and-memory/actions-and-approvals.md). ### Answer from your store's own content Your storefront is also knowledge: products, pages, blog and policies. A returns window question is answered from your policy page. Add your help center and past tickets and the same agent handles policy, order and product questions in one conversation. ## Example use cases * **Pre-sales assistant on your storefront.** Sizing, stock and comparisons while someone is still deciding. * **Order status.** The most common ticket in e-commerce, answered from live data. * **Returns and refunds.** The whole flow within your policy. * **Peak season cover.** Handles the routine volume spike so your team works the tickets that need judgement. ## FAQ

How do I add an AI chatbot to my Shopify store?

Ask your agent in the dashboard chat to connect Shopify and add a chat bubble, then paste the snippet it gives you into your theme's `theme.liquid` file. Turn on the bubble automation and shoppers can start chatting. See [Set up your AI sales assistant](#set-up-your-ai-sales-assistant) and [Shopify](/integrations/e-commerce/shopify.md).

Does the AI sales assistant work with Magento?

Yes. It does the same job on a Magento store. See [Magento](/integrations/e-commerce/magento.md) for the setup.

Can the AI chatbot recommend products and check stock?

Yes. It searches your catalogue for what the shopper described, checks live stock, variants and prices, and shows matching items as cards with **Add to Cart**.

Can it look up orders and process refunds?

Yes, on a Full connection. It finds orders, checks tracking, starts returns, updates shipping addresses, refunds and cancels.

What is the difference between Quick start and Full connection?

Quick start reads your public storefront with no sign-in, so it can search products and show product cards but cannot look up orders or take actions. A Full connection adds orders, customers, tracking and refunds, read from your store directly. Moving from Quick start to a Full connection later loses nothing you have already read in.

How much does an ecommerce AI chatbot cost?

Each chat conversation is 1 credit, however many messages the shopper sends, and there is no seat fee. Every new workspace starts with a 7-day free trial with 100 credits. See [Pricing](/pricing/overview.md) for the plans.

Can the chatbot hand a shopper over to a person?

Yes. Tell it when a shopper needs a person and it can collect their name and email and create a ticket in your helpdesk, such as Gorgias. It can also hand the chat to another live chat widget, such as Zendesk Messenger or Freshchat. See [Chat Bubble](/integrations/chat-surfaces/chat-bubble.md).

## Related pages * [Shopify](/integrations/e-commerce/shopify.md) for full setup, sources and every available action * [Magento](/integrations/e-commerce/magento.md) for the same job on a Magento store * [Chat Bubble](/integrations/chat-surfaces/chat-bubble.md) for putting your agent on your storefront * [Gorgias](/integrations/helpdesks/gorgias.md) for the ticket side of the job * [Actions and Approvals](/instructions-and-memory/actions-and-approvals.md) for choosing what your agent may do * [Integrations overview](/integrations/overview.md) for how sources, triggers and actions fit together * [Set up from Claude Code or the terminal](/getting-started/set-up-from-a-coding-agent.md) * [Use eesel from Claude and other assistants](/apis-and-developer-resources/use-eesel-from-claude-and-other-assistants.md) and [Use eesel from ChatGPT](/apis-and-developer-resources/use-eesel-from-chatgpt.md) to work with your agent from an AI assistant --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.eesel.ai/use-cases/e-commerce-sales-rep.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.