Skip to content
Documentation

Install the chat widget on Shopify

Add the intoCHAT chat bubble to your Shopify store with the app embed or one script tag in theme.liquid, then connect your store so the agent can search your products.

On Shopify, the intoCHAT app adds the chat bubble as an app embed: you switch it on in the theme editor and never touch theme code. The bubble and product search also work without the app, from your store's public data and without an API key; then you paste one script tag into your theme instead. To let the agent look up orders, install the Shopify app.

Turn it on with the Shopify app (no code)

If you install the Shopify app, you don't need to edit your theme:

  1. On the agent's Share tab, under Website, click Turn on in your theme on the Your Shopify store card (the same button is on the Orders card of the Actions tab). Shopify opens your theme editor with intoCHAT chat bubble switched on under App embeds.
  2. Click Save. The bubble appears on every page of your store.

You can also find it yourself in Online Store → Themes → Customize → App embeds. The embed shows the agent you installed the app on; to show another agent, paste its ID in the embed's Agent ID setting. It stays in place when you update your theme, and goes away when you uninstall the app.

Without the app, paste the snippet instead, as below.

Copy the snippet

Open your agent's Share tab. On the Shopify card, click Copy Code. It is the same script as on the Bubble Chat card and already contains your agent ID:

<script src="https://www.intochat.ai/api/embed.js" data-chatbot-id="YOUR_AGENT_ID"></script>

Add it to your theme

  1. In your Shopify admin, go to Online Store → Themes.
  2. Next to your current theme, click ⋯ and choose Edit code.
  3. In the Layout folder, open theme.liquid.
  4. Paste the snippet just above </body> and click Save.
  5. Open your store. The chat bubble appears in the bottom corner of every page that uses this layout, with the colors and position from the Appearance tab.

Just above </body> is the recommended place, but the snippet also works in the <head> section of theme.liquid. If it ends up in the theme twice, only one bubble appears.

Let the agent search your products

  1. Open the Actions tab and choose Connect your website.
  2. Paste your store's address. intoCHAT detects Shopify and adds two actions: Search products, which returns up to five matches, and Get product details, which covers variants, prices and stock.
  3. Test it in the Playground: ask about a product, a price or whether something is in stock. Answers show product cards with an image, the price and a link to the product page.

Products are searched live while the visitor chats, so new products and price changes show up without retraining. This connection reads only public product data. It doesn't see orders, carts or customer data, and the agent can't check out in the chat; it points shoppers to the right page instead. Order lookups need the Shopify app.

If your store is password protected, the agent can't see its products. Remove the password under Online Store → Preferences and connect again. See Connect your store for details.

Install the Shopify app

The intoCHAT Shopify app gives your agent read access to your store's orders, so it can answer questions such as "Where is my order?". It is separate from the chat bubble and product search above, which keep working without it.

  1. Open your agent's Actions tab and find the Orders card.
  2. Enter your store's Shopify address: your-store or your-store.myshopify.com. You find it in your Shopify admin under Settings → Domains. Your own domain, such as yourstore.com, doesn't work here.
  3. Click Install on Shopify. Shopify opens your store's admin and lists the access intoCHAT asks for.
  4. Approve the install. Shopify sends you back to the Actions tab, which says whether it worked.

Only the account owner and admins can install the app, because it stores access to your store. In Shopify, you need permission to install apps. Each agent connects to one store; installing on another store replaces the agent's current store connection.

The Orders card is where you choose what the agent does with orders, such as taking return requests.

What access the app asks for

  • Read orders (read_orders): to look up an order's status, items, shipping and tracking when a shopper asks about it in the chat.

That is all. The app can't create, change, cancel or refund orders, and it doesn't ask for your products, customer list, payments or store settings. Shopify lets apps with this access read the last 60 days of orders, so the agent can't look up older ones.

Pay for intoCHAT through Shopify

Once your account has the app installed, your plan is billed through Shopify instead of by card. On Settings → Billing, choose Starter or Pro, monthly or yearly: Shopify opens your store's admin to approve the charge, and it appears on your Shopify bill. Starter's 7-day free trial works the same way. To change plans, choose another one and approve it in Shopify; to stop paying, choose Free. Prices are in US dollars, and Shopify converts them to your store's billing currency. A plan you already pay by card stays on your card.

You can also start from Shopify: opening intoCHAT from your Shopify admin signs you in (or lets you create an account) and installs the app on your most recent agent, or on a new agent for your store if you don't have one yet.

Uninstall the app

In your Shopify admin, go to Settings → Apps, open intoCHAT and choose Uninstall. Shopify tells intoCHAT straight away, and intoCHAT deletes the store connection and the return requests saved from chats with that store. The chat bubble and product search are not affected. To connect again, install the app from the Orders card.

intoCHAT renews the app's access on its own while the agent uses it. If the agent doesn't look up an order for 90 days, Shopify ends that access and the Orders card asks you to install the app again.

How intoCHAT handles your store's data

  • Stored: your store's address, the access you approved, and the app's access tokens, encrypted.
  • Not stored: orders and customer records. The agent reads an order from Shopify while it answers in the chat and doesn't keep a copy.
  • Return requests: if you let the agent take them, each request is saved with the shopper's email address and order number and sent to you.
  • Chat transcripts: what shoppers type is kept with your other conversations on the Activity tab, where you can delete a conversation.

Shopify passes privacy requests to the apps installed on your store, and intoCHAT handles them like this:

  • A customer asks for their data: intoCHAT emails you, the account owner, what it holds about them, so you can reply. Shopify asks you to answer within 30 days.
  • A customer asks to be erased: intoCHAT deletes their return requests for your store.
  • Your store's data is erased (Shopify asks 48 hours after you uninstall): intoCHAT deletes anything left for the store.

Train the agent on your store's content

On the Knowledge tab, add your store's address and pick your shipping, returns and FAQ pages. Upload size guides or policies as files, and add Q&A pairs for answers that must be worded exactly.

Troubleshooting

  • No bubble on the store. Make sure you edited the live theme, not a copy, and that the snippet sits above </body> in theme.liquid.
  • "Chatbot not found." in the browser console. The agent ID in the snippet is wrong. Copy it again from the Share tab.
  • "Connect your website" fails. Check that the address is your public storefront and that the store isn't password protected.
  • "Install on Shopify" says the address isn't valid. Use the .myshopify.com address from Settings → Domains, not your own domain.
  • "Shopify app wasn't installed". The message says why. If the install took more than 10 minutes, or you switched intoCHAT accounts in between, start again from the Orders card.

For more cases, see Troubleshooting. For what the agent can do in a Shopify store, see the Shopify integration page.

View as Markdown