Connect Shopify to B6AI
Connect your Shopify store so bots can answer order-status questions, look up products and inventory, and start refunds, end to end.
Overview
The Shopify integration connects your store so bots can answer the questions customers ask most, “where’s my order?”, “is this in stock?”, “can I get a refund?”, using live data from Shopify.
It turns your storefront’s support into self-service, right inside the conversation.
What you can do with Shopify
Once connected, your bots and agents can use Shopify inside conversations and automations. Typical uses include:
- Look up an order’s status by order number or customer email.
- Show product details, price, variants and availability.
- Check fulfillment and tracking information for a shipment.
- Create draft orders, or start a return/refund (with the right permissions).
- Surface a customer’s order history for context during a conversation.
- One-click install the B6AI chat widget on your storefront.
How the integration works
You connect with just your store domain — B6AI uses its own Shopify app, so there is nothing to create in Shopify and no API token to copy.
Clicking Connect sends you to Shopify to approve the permissions B6AI needs; Shopify then returns a secure access token that B6AI stores encrypted at rest.
B6AI calls the Shopify Admin API on your behalf, limited to the permissions you approved.
Prerequisites
Make sure all of the following are in place before you start. Each one is required, skipping any will cause the connection to fail later.
- A Shopify store where you can approve app permissions (staff or owner).
- Your store’s myshopify.com domain (yourstore.myshopify.com).
- The Enterprise Admin role in B6AI.
Generate your Shopify connection
B6AI authenticates with Shopify using your Shopify connection. Follow these steps exactly, each field you copy here is entered into B6AI later.
- Unlike most integrations, Shopify needs no app, API key or token from you — B6AI provides the Shopify app.
- The only thing you need is your store domain (yourstore.myshopify.com).
- The secure connection is created during Connect (next section), where you approve B6AI’s permissions inside Shopify.
Required permissions & scopes
Grant only the scopes below. Each one maps to a specific B6AI capability; requesting fewer reduces risk and speeds up any review your Shopify administrator performs. The table explains exactly what each scope allows and why it is needed.
| Scope / permission | What it allows | Why B6AI needs it |
|---|---|---|
| read_orders | Read orders | Answer order-status and order-history questions |
| write_orders | Create and update orders and draft orders | Create draft orders or adjust orders from chat |
| read_products | Read products and variants | Show product details, price and options |
| read_inventory | Read inventory levels | Tell customers whether an item is in stock |
| read_customers | Read customer records | Match a chat to a customer and their orders |
| read_script_tags, write_script_tags | Manage the storefront widget loader | One-click install/remove of the chat widget on your storefront |
Connect Shopify in B6AI
Now enter your credentials in B6AI. Signed in as an Enterprise Admin, open Settings → Integrations, find the Shopify card and click Connect, then complete the form. Every field is explained below.
- In B6AI, open Settings → Integrations and click Configure on the Shopify card.
- Enter your store domain (yourstore.myshopify.com).
- Click Connect — you’ll be redirected to Shopify.
- Review and Approve the permissions B6AI requests.
- You’re returned to B6AI and the store shows “Connected” — there is no token to copy.
{
"provider": "shopify",
"shop": "yourstore.myshopify.com",
"status": "connected"
}| Field | What it is | Example value |
|---|---|---|
| Store domain | Your full myshopify domain | yourstore.myshopify.com |
| API version | Optional — the Admin API version B6AI targets | 2025-01 |
Verify the connection
Confirm the integration is live before you rely on it in a bot.
- Confirm the Shopify card shows “Connected”.
- Run the test: it reads your store name and a recent order (details masked).
- Confirm the values match your Shopify admin.
Troubleshooting
If the connection fails or an action does not work, match the symptom below to its cause and fix.
| Symptom / error | Likely cause | How to fix it |
|---|---|---|
| Consent screen is missing a permission | You approved before a permission was added, or declined it | Reconnect the store and approve all requested permissions |
| “Please reconnect your store” / reconnect prompt | The connection expired or the app was uninstalled in Shopify | Open the Shopify card and click Connect again, then approve |
| redirect_uri is not whitelisted | A B6AI-side configuration issue — not something you set | Contact B6AI support |
| Order not found | Typo, or the customer used a different email | Search by email plus order number and confirm the store |
Limitations & rate limits
Keep these constraints in mind so your bots behave predictably at scale.
- Shopify rate-limits the Admin API (a leaky-bucket for REST; cost-based for GraphQL).
- Refunds and returns require the appropriate permissions and store settings.
- Some data and features require Shopify Plus.
Security best practices
- Grant only the scopes and permissions listed above, never request more “just in case”.
- Rotate your Shopify connection on a regular schedule, and immediately if you suspect exposure.
- Restrict the Enterprise Admin role (which manages integrations) to a small, trusted group.
- Prefer a dedicated service account or bot user over a personal login, so access survives staff changes.
- Review the integration’s activity in the B6AI Activity Logs periodically for unexpected calls.
- Disconnect the integration the moment a credential leaks; then rotate it in Shopify before reconnecting.
Recommendations
- Test against a sandbox or non-production Shopify account before connecting live data.
- Document which bots and flows depend on this integration so changes are predictable.
- Set a recurring reminder to review scopes and rotate credentials.
- Enable only the capabilities you actually use today; you can widen scopes later.