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 and customers) 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, paid orders, and customer creation and updates.
- A full product import and a full customer import start in the background. The Shopify row shows Resyncing products… until the product import finishes.
- 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.
- Price and compare-at price. When a compare-at price exists, Popcorn stores it as the regular price and the current price as the discounted price.
- 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.
- 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.
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 Shopify checkout link. The order appears in Orders and waits for payment until Shopify reports the order as paid. See orders.- Payment: the customer pays in Shopify checkout. The payment methods your agent can offer follow what you turn on under Settings → Payment; a new workspace starts with Cash on delivery on. If no method is on, the agent doesn’t create the order and hands the conversation over.
- Shipping: rates and delivery windows are handled inside Shopify checkout, so Settings → Shipping → Sync from store says “Shopify sets shipping rates and delivery windows at checkout. Add delivery coverage in Popcorn AI yourself.” Use Add delivery coverage to list the countries and cities your agent can accept before sending a Shopify checkout. See shipping and payment.
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, Popcorn finds the customer in Shopify 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:
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