How do I connect my Shopify store?

What the Shopify connection gives you

When a visitor asks about a product, the agent queries your store at that moment: name, price, stock status, variants and product page. The catalog is never copied into Agenola, so price and stock never go stale.

The agent adds products from the chat to your store's own cart. Payment happens on Shopify's checkout page.

Visitors can also ask about their own order: once it is verified with the order number and the email or phone on the order, they see its status. Cancellation, return or address requests are added to the order's note.

When you connect, a store agent named “Shopify Agent” is created automatically, and your refund, shipping, privacy and terms texts are imported into the knowledge base.

Connecting step by step

1. Install Agenola from the Shopify App Store and approve the requested permissions on Shopify's install screen. The “Open in the Shopify App Store” button on Integrations → Shopify in the dashboard takes you there. You don't need to enter a store address.
2. In your Shopify admin, open Apps → Agenola. On the page that says “Last step: connect your Agenola account”, press “Connect”.
3. Agenola opens in a new tab. Sign in or create an account, then press “Connect” in the “Connect this store?” box. You see “Store connected.”
4. In the theme editor, open App embeds, turn on “Assistant” and press Save. The button position (bottom right or bottom left), the chat window (a small box in the corner or a large window in the center) and the agent's name are chosen there too.

Plan and billing

You choose a plan on Shopify's plan page and it is added to your Shopify bill; there are no free days and no free plan. The “Plan” card on the app's page in Shopify lets you see or change your plan at any time; without a plan, the app takes you to the plan page.

The app's page in the Shopify admin

It shows that the store is connected, the conversations visitors had with the agent, and links to the theme editor and your plan. You can open a conversation to read its transcript; to reply and manage them, open the Agenola dashboard.

The Shopify page in the dashboard

• “Edit the store agent” opens the agent in the editor, where you change the avatar, greeting and tone. Your changes reach the storefront when you click “Publish”.
• “Turn on the agent in the theme editor” opens Shopify's theme editor.
• “Get changes from your store”: changes to your policy texts come in automatically every day; press it if you don't want to wait.
• “Agent order actions” lets visitors cancel an order that hasn't shipped and request a return for shipped products. Both are off by default. The agent does them only after it verifies the order and the visitor explicitly confirms. When you turn on cancellation, you also set how many hours after the order it can be cancelled.

Your agents can use Shopify steps for searching and getting products; managing products, variants, collections and stock; discount codes, pages and the cart; orders (note, cancel, hold, refund) and customers.

Troubleshooting

• If the agent doesn't show on your storefront: turn it on in the theme editor and press Save.
• If the agent finds no products and your storefront is password protected: in your Shopify admin go to Online Store → Preferences → Password protection and turn it off. Development stores only lose the password on a paid plan.
• “The connection request expired”: open Apps → Agenola and press “Connect” again.
• “We can't read the store's permission”: open Apps → Agenola once; the permission is renewed.
• “Shopify didn't grant product read access”: remove Agenola under Settings → Apps, install it again from the App Store and accept the requested permissions.
• “This workspace has a plan paid on agenola.ai”: a Shopify store pays through Shopify. Cancel that plan on the Plan page first, or connect the store to a new workspace.
• If your policies don't show up, fill in Settings → Policies in Shopify and press “Get changes from your store”.

Disconnecting

Press “Disconnect” and confirm. The agent on the storefront stops immediately and the store's agent stays in the dashboard. To reconnect, open Apps → Agenola in Shopify and press “Connect”. If you remove the app from Shopify and install it again without disconnecting it in the panel first, the store returns to the same workspace by itself; if you disconnected it in the panel, press “Connect” again under Apps → Agenola.