Shopify Connector

Input Requirements

To connect your Shopify store to Atri AI Search, you'll need to provide two key pieces of information:

Obtaining Your Access Token

Setting up your Shopify connection requires creating a private app within your store's admin panel. This process ensures secure access to your product data while maintaining control over what information is shared. The private app approach provides dedicated API credentials specifically for Atri AI Search, separate from your store's main operations.

Access Your Shopify Admin

Begin by logging into your Shopify admin panel and navigating to the 'Apps' section in the main menu. This is where you'll manage all applications connected to your store, including the private app you're about to create for search integration.

Create a Private App

Within the Apps section, look for 'App and sales channel settings' at the bottom of the page. Click this option, then select 'Develop apps' followed by 'Create an app'. This initiates the private app creation process that will generate your dedicated access credentials.

Configure App Permissions

Navigate to the 'Configuration' tab within your new app and configure the Admin API scopes. These permissions determine what data your search integration can access. For optimal functionality, you'll need to enable the following permissions:

• read_products (Products) - Access to product information and descriptions
• read_product_listings (Product listings) - Access to product catalog data
• read_inventory (Inventory) - Access to stock levels and availability

Generate and Secure Your Access Token

After saving your configuration, click 'Install app' to activate the private app. Once installation completes, you'll see the 'Admin API access token' displayed in your app dashboard. Copy this token immediately and store it securely, as it provides direct access to your store data and should be treated as confidential information.

How It Works

The Shopify connector establishes a secure connection to your store and systematically retrieves product information for indexing. This process transforms your Shopify catalog into a searchable database that powers both traditional keyword searches and AI-driven semantic discovery.

Initial Connection

Using your store URL and access token, Atri AI Search establishes a secure connection to your Shopify store through the Admin API. This connection leverages Shopify's robust API infrastructure to ensure reliable data access while maintaining the security standards expected for e-commerce operations.

Data Retrieval

The system performs comprehensive data retrieval, fetching product information including titles, descriptions, variants, pricing, inventory levels, and metadata. This process captures not just basic product details, but also the rich contextual information that makes search results more relevant and useful for customers.

Field Mapping and Index Creation

Product data undergoes automatic mapping to searchable fields, with intelligent detection of text fields for search and numeric fields for filtering. The system then allows you to configure these fields per your preference, followed by creating both keyword and semantic vector indices.

Information Retrieved

The Shopify connector retrieves comprehensive product information to create a rich search experience:

Auto-Refresh Capability

The Shopify connector supports automatic synchronization to keep your search results current with your store inventory. This intelligent monitoring system ensures that customers always see accurate product information, pricing, and availability without requiring manual updates to your search index.

Real-Time Updates and Inventory Synchronization

When products are added, modified, or removed from your Shopify store, the search index automatically updates within minutes. Stock levels, pricing changes, and product availability are continuously monitored and reflected in search results, ensuring customers never encounter outdated information during their shopping experience.

Webhook Integration and Batch Processing

The system utilizes Shopify webhooks to receive instant notifications of changes, ensuring minimal delay between store updates and search index updates. For efficiency, bulk changes are handled through intelligent batch processing that manages multiple product updates simultaneously while maintaining optimal performance.

Configuration Best Practices

To maximize the effectiveness of your Shopify search integration, consider these essential configuration practices:

• Ensure your access token has only the minimum required permissions for security
• Consider which product fields are most important for your search use case. You ideally want to configure text fields that describe the features and utility of your products in detail so that the system has full context.
• Set up appropriate filtering and faceting based on your product catalog structure
• Establish custom ranking rules to optimize search results based on your specific business objectives