For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/integrations/eshops/shopify.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
Shopify
Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.
With Shopify connected, the agent recognises a customer from the number they call from, reads back their recent orders and order status, answers questions about your products, quotes your shipping rates and, if you allow it, creates an order or an unpaid draft order for you to review. Integrations - Catalogue - Shopify - Connect opens the connect dialog. One connection is shared by every agent in the company.
What you need before you start
Section titled “What you need before you start”The dialog offers two ways in. Use the first unless you have a reason not to.
- Install via Shopify (recommended). You only need the shop’s
myshopify.comdomain and a Shopify login that can install apps. Shopify shows its own approval screen; nothing has to be created in the store first. - Access token. For stores that prefer a custom app. In the store admin open Settings - Apps and sales channels - Develop apps, click Allow legacy custom app development, then Create an app (name it
Voice Logica). Under Configuration - Admin API integration - Configure enableread_customers,write_customers,read_orders,write_orders,read_products,write_productsandread_shipping(needed when the agent creates delivery orders), then Save. On API credentials click Install app and copy the Admin API access token (shpat_…). Shopify shows the token only once, so paste it into Voice Logica straight away. If you lose it, generate a new one from the same tab - the old token stops working once a new one is created.
Create the custom app in the store admin, not in the Shopify Dev Dashboard or Partners dashboard. Those give a Client ID and a shpss_… secret, which the token form does not accept.
What you enter
Section titled “What you enter”For Install via Shopify:
myshop.myshopify.com. The part before .myshopify.com is enough.For the access token form:
myshopify.com domain shown in the admin address.shpat_… token from API credentials.First setup
Section titled “First setup”-
Integrations - Catalogue - Shopify - Connect. Enter the Shop domain and click Install via Shopify. Approve the app in the Shopify window that opens. If you use a token instead, fill the form, click Test connection, then Connect.
-
Shopify appears under Connected. Customers and products start copying in the background straight away.
-
Open My Agents, pick the agent, then Skills - Tools & Workflows. Turn on Shopify and click Configure.
-
Pick the operations. Identify caller by phone is on by default. Add Get orders by customer and Search products for order and product questions. To take orders add Create order, Create draft order or both (with both, the agent drafts quotes and unconfirmed orders and creates a real order only when the caller commits). Add List shipping options or Pre-load shipping rates into the system prompt, because Shopify does not calculate shipping on orders created through the API.
-
If the agent can create orders, set Max order value and Max order lines. Use Custom order attributes for extra details the agent must collect; they appear on the Shopify order as order attributes.
-
Click Save in the settings window, then Save the agent.
-
Call the agent from a phone number saved on a Shopify customer (or use Try this agent). Ask “What’s the status of my last order?”. The agent should greet you by name and read back the order status. Then ask about a product by name.
What the agent can do
Section titled “What the agent can do”| Job | What happens on the call |
|---|---|
| Recognise the caller | Matches the caller’s number to a Shopify customer. Can also find a customer by name or email and remember the number for next time. |
| Order questions | Reads the caller’s recent orders or a single order: status, items, payment state. Pre-fetch recent orders on call start loads the last 10 orders before the agent speaks. |
| Product questions | Searches by title, tag or product type and reads one product’s details. |
| Take an order | Quotes shipping rates, then creates an order or an unpaid draft order (no stock reserved, no payment taken) within your limits. |
Customers and products are refreshed daily. On the Shopify card under Connected, Sync now refreshes them immediately and Sync to Skroutz rebuilds the product list the agent searches. Nothing is published to the Skroutz marketplace.
Troubleshooting
Section titled “Troubleshooting”Why does the Shopify test connection fail with my access token?
Check that the token starts with shpat_ and comes from a custom app created in the store admin. A shpss_… value is an app secret from the Dev Dashboard and does not work here. Also check that the Shop domain is the myshopify.com domain of the same store.
Why does Install via Shopify do nothing, or the window close without connecting?
The Shopify approval screen opens in a new window. Allow pop-ups for the Voice Logica app and try again. Make sure the shop domain is the myshopify.com one, not your public shop address.
Why does the Shopify card show Action needed and Reconnect?
The Voice Logica app was uninstalled from the store or its access was revoked. Click Reconnect and approve the app again. Until then the agent cannot read customers or orders.
Why do orders the agent creates in Shopify have no shipping line?
Shopify does not add shipping to orders created through the API. Turn on List shipping options or Pre-load shipping rates into the system prompt. With the token method, the custom app also needs the read_shipping scope.
Automations on order changes
Section titled “Automations on order changes”Start a workflow when an order is created, paid, shipped, delivered, cancelled or refunded — for example, have the AI agent call cash-on-delivery customers to confirm the order. See Shopify Event trigger.
