Skip to main content
This documents the v1 product. It is kept for integrations already running on it. If you are building something new, start with the Quickstart.

​
Overview

With the Shopify integration, a voice agent can handle customer support, order tracking, inventory questions and sales assistance for your store. Customers talk to the voice agent to check order status, find products, apply discounts and get support right away.

Order Management

Voice agents can check order status, process returns, and handle shipping inquiries automatically.

Product Assistance

Help customers find products, check inventory, and provide detailed product information through voice.

Customer Support

Handle common support requests like account issues, discount codes, and general store policies.

Sales Automation

Upsell, cross-sell, and guide customers through the purchase process with product recommendations.

​
Required Permissions

Your voice agent needs these Shopify API permissions:

​
Essential Scopes

  • read_customers: access customer information for personalized support
  • read_products: provide product details and inventory status
  • read_orders: check order status and history
  • write_orders: process order changes and cancellations
  • read_discounts: apply available discount codes
  • write_discounts: create promotional codes for customers

​
Optional Scopes (based on your use case)

  • read_inventory: check inventory in real time
  • read_shipping: calculate shipping rates
  • write_customers: update customer information
  • read_returns: handle return requests

​
Setup Guide

​
Part 1: Create Shopify Private App

  1. Access Shopify Admin Log in to your Shopify admin dashboard.
  2. Navigate to Settings Click the Settings option in the bottom-left corner of your admin panel. Shopify admin dashboard
  3. Open Apps and Sales Channels Select Apps and sales channels from the settings menu. Settings menu
  4. Access App Development Click Develop apps in the top navigation bar. Apps and sales channels
  5. Create New App Click the Create an app button to start the setup process. Develop apps button
  6. Configure App Details Enter your app name and select the app developer, then click Create app. Create an app
  7. Set API Permissions Click Configure Admin API scopes to set up the required permissions. App configuration
  8. Select Required Scopes Enable the necessary permissions listed above. At minimum, select:
    • read_customers
    • read_products
    • read_orders
    • write_orders
    • read_discounts
    • write_discounts
    Add any optional scopes your use case needs, then save your changes. Configure API scopes
  9. Install the App Click Install app to activate the app in your store. Install app Install app confirmation
  10. Copy Access Token After installation, copy the generated access token and keep it secure. You’ll need it to connect to Voice Agents. Access token

​
Part 2: Connect to Voice Agents Platform

  1. Access Voice Agents Dashboard Log in to your Voice Agents platform and navigate to the integrations page. Voice Agents dashboard
  2. Complete Shopify Connection Click the Connect button next to Shopify, then:
    • Enter your store domain (without https:// or http://)
    • Paste the access token from step 10
    • Click Connect to finalize the integration
    Connect Shopify

​
What’s Next?

Once you connect the store, your voice agent can start handling these requests right away:
  • Order inquiries: “What’s the status of my order #1234?”
  • Product questions: “Do you have this item in stock?”
  • Customer support: “How do I return an item?”
  • Sales assistance: “What’s your best-selling product?”