Before you start
- A Shopify store you can sign in to as a staff member with permission to install apps.
- A Popcorn role that can manage integrations (Owner or Admin).
- Allow pop-ups for Popcorn: the authorization opens in a pop-up window.
Connect
1
Open Integrations
Go to Integrations and click Connect on the Shopify row.
2
Choose the store
A pop-up opens on Shopify. If you are signed in to several stores, Shopify asks which one to use.
3
Approve the app
Review the access the Popcorn AI app requests (products, orders, checkouts, draft orders, returns, customers, discounts and shipments) and approve it.
4
Wait for confirmation
The pop-up shows Connecting Shopify and then “Shopify is connected. This window closes by itself.” Back on Integrations, the row reads Connected and Popcorn shows Shopify connected. Your products are syncing.
What happens when you connect
- Popcorn records your store’s primary domain so campaign link buttons open on the domain your customers know.
- Popcorn creates the storefront access it needs to build checkouts.
- Popcorn subscribes to Shopify notifications for product creation, updates and deletion, variants selling out or coming back in stock, paid orders, customer creation and updates, and the app being removed from the store.
- A full product import and a full customer import start in the background. The Shopify row shows Resyncing products… until the product import finishes.
- Popcorn reads your store’s automatic discounts and how your customers paid on your checkout (see Checkout on Shopify).
- Active automated campaigns get their Shopify triggers re-registered, so Reconnect also repairs campaigns that stopped firing.
What syncs
Products- Title, description, images, tags, product link and status. A product is active in Popcorn only when its Shopify status is Active and it is on a sales channel the Popcorn AI app can check out through, so the agent offers only what your checkout sells. Each variant follows Shopify’s own “available for sale”.
- Price and compare-at price. A variant is on sale only when its compare-at price is higher than its price: Popcorn then shows the compare-at price struck through beside the price, on Products and in what the agent sends. A compare-at price equal to or lower than the price is ignored.
- Automatic discounts that take an amount or a percentage off products for every buyer, with no minimum, become the price the agent quotes, so it matches your checkout. Discounts that depend on the cart or the buyer (buy X get Y, a minimum, chosen customers, shipping or order discounts) are left to Shopify’s checkout. Popcorn reads the discounts again when they change and when a sale starts or ends. A store connected before Popcorn read discounts shows Allow discounts on its row; until you approve it, the agent quotes list prices.
- Variants, up to the first 100 variants per product.
- Stock is the quantity sellable on the Online Store sales channel. Point-of-sale and wholesale inventory are not counted. With Product quantities on, a product that syncs with 0 is marked inactive, as on any store. Otherwise Popcorn doesn’t hold back an active Shopify product because its stock reads 0; see Products the agent can’t sell.
- Name, phone number, email, tags and marketing consent. A customer who opted out of marketing is marked unsubscribed; a sync never re-subscribes anyone.
- Customers without a phone number are imported too.
- Each imported customer shows Shopify as its source on the customer profile. See customers.
Ongoing updates
To force a fresh import at any time, click Resync products on the Shopify row. See Connect your store for the resync limits.
If the Popcorn AI app is removed from your store, or Shopify stops accepting Popcorn’s access, the Shopify row shows Connection lost and your Owners and Admins get one email. Click Reconnect. See When a store’s connection is lost.
Shopify settings
Click the gear icon on the connected Shopify row to open Shopify settings (“Choose how your agent places Shopify orders.”). Change what you need and click Save; you see Shopify settings saved. Cancel closes the dialog without saving.Allow phone-only checkout
On by default. “Turn on if your Shopify store accepts orders with only a phone number. When off, your agent asks customers for an email before it creates the order.”Custom checkout fields
Turn on Custom checkout fields (“Collect extra details at checkout, like a gift message or sender name.”) to ask customers for more than the standard details. The answers are attached to the Shopify checkout the agent creates.1
Find fields
Click Find fields from abandoned checkouts. Popcorn reports “Found 2 new checkout fields” (with the number it found), No new checkout fields found or No checkout fields found in recent abandoned checkouts. If it can’t search, you see “Couldn’t find checkout fields. Try again.”
2
Review the list
Under Checkout fields, each field has a Required checkbox, an Enabled checkbox, What the agent asks the customer (a text field; Popcorn starts it with “Ask the customer for” followed by the field’s name), and an Answer type: Text, Number, Phone, Email, Yes or no, Date, Time or Date and time.
3
Save
Click Save. If the checkout fields don’t save but phone-only checkout did, you see “Phone-only checkout was saved, but checkout fields weren’t. Try again.”; if nothing saved, “Couldn’t save Shopify settings. Try again.”
Checkout on Shopify
When the agent completes a sale, Popcorn builds a Shopify cart with the customer’s details and the collected attributes, and sends the customer a checkout link. The link opens your store’s checkout on your store’s own domain. The order appears in Orders and waits for payment until Shopify reports it as paid; once paid, the order shows Shopify’s order number. See orders.- Payment: the customer chooses how to pay on your Shopify checkout page, so the agent doesn’t pick a payment method and Popcorn’s payment switches don’t apply. Settings → Payment shows How customers pay, read from your store’s checkout orders of the last 60 days when you connect and every hour after. Check the list once, add anything your checkout takes that recent orders don’t show, and click Confirm list: the agent tells customers these are all the ways to pay at your checkout. Until the list is read, the agent still sends the checkout link, where customers see every way to pay. See shipping and payment.
- Shipping: rates and delivery windows are handled inside Shopify checkout, so the order summary in the chat has no delivery line and Settings → Shipping offers no Sync from store. Use Add delivery coverage to list the countries and cities your agent can accept before sending a Shopify checkout. See shipping and payment.
- Cash on delivery orders stay awaiting payment until you mark them paid in Shopify.
Order tracking
When a customer asks about an order, the agent looks it up in Shopify by order number and checks that the customer’s phone number (or the email address on the order) matches; a mismatch is refused. If the customer gives only a phone number, or quotes Popcorn’s own order number (as on Orders, “P” and six digits), Popcorn finds the customer in Shopify by phone and returns their five most recent orders. Switch on Track orders on the agent’s Actions tab to use this; see agent capabilities.Events for automated campaigns
These Shopify events are available as triggers when you create an automated campaign:
Shipment Status Updated needs your store’s approval to share shipment updates. A store connected before Popcorn asked for it is told to reconnect Shopify in Integrations when it activates such a campaign.
Shopify sends Checkout Created before the shopper has typed a phone number, so a campaign on that event also follows the checkout’s updates and sends one reminder per checkout, to the phone the shopper typed. For abandoned-checkout messages, Popcorn checks whether that customer has placed an order since the checkout and skips the message if they have.
Related
- Connect your store: actions on the row, resync limits, one active store.
- Store health: see whether sync, checkout and tracking are healthy.
- Troubleshooting