Shopify

Shopify

Shopify Integration Guide - Admin API (6 Steps ~ 2 minutes)

The steps below outline exactly how Asa can connect to your Shopify account using a custom app with Admin API access. This setup is necessary to train Asa on your products (including metafields), articles, blogs, pages, and policies.

Step 1: In your Shopify dashboard, go to Settings > Apps and Sales Channels > Develop Apps, then click Create App.

image
icon

Note: If you can’t access the Develop Apps section in your Shopify dashboard, it may be due to restricted permissions preventing custom app creation. Check Shopify’s guide for activating custom app development.

If you’re still having trouble, feel free to reach out to us at help@alphablocks.ai —our team is happy to assist you promptly!

Step 2: Name your app “Asa Integration”, then click Create App.

image

Step 3: Navigate to the “Configuration” tab and click “Configure” next to Admin API Integration. Select the required scopes listed below, then click “Save.” Click Install App.

icon

[Scopes used: read_legal_policies, read_metaobject_definitions, read_metaobjects, read_online_store_pages, read_product_feeds, read_product_listings, read_products, read_content]

Step 4: Navigate to “API Credentials”, then under “Admin API Access Token,” click “Reveal Token Once.” Copy the token and store it securely.

icon

Important Note:

Please store the Admin API Access Token securely, as it is only revealed once, because the token provides API access to sensitive store data. After revealing the access token, write down or record the token somewhere secure so that you can refer to it again. You will need to provide it on the Asa Dashboard in the next step.

At Alphablocks, we take the security of client information very seriously and implement strict security measures when handling access tokens. Rest assured, you can trust us as a developer to share this token with as we can only access the specific scopes you granted in the previous step—nothing more.

If you have any concerns, feel free to reach out to us at help@alphablocks.ai. Our team is happy to assist you promptly!

image

Step 5: Return to your Asa Dashboard, go to Add Content, navigate to the Integrations tab, and click Connect under Shopify. Enter the required details as instructed, then click Connect again.

Admin API Access Token: You noted this from the previous step. Copy + Paste it in the correct text input field

Storefront Public URL: This is your main storefront/website url (For eg: https://example.com, https://acme.com, etc.)

Shopify Subdomain: Navigate to Settings > Domains, then select the subdomain that ends with ”.myshopify.com”. If you have multiple such domains, choose the one that matches the URL in your browser: https://admin.shopify.com/store/[your-shopify-subdomain]/settings/domains. Take note of just the part before ”.myshopify.com” and Copy + Paste it in the correct text input field.

image

Step 6: Upon clicking “Connect” in previous step, a dialog box should automatically open to select products, blogs, pages, or policies. If it doesn’t, click the icon next to “Connected” under Shopify ( ), select the desired items for Asa to train on, and click “Add Content” to proceed.

image

Training all the products, blogs, pages or policies that you selected will take a couple minutes. Meanwhile, to verify that the integration is set up correctly, go to “Trained Content” in the sidebar. Then, under the “Integrations” tab, check if the selected products, blogs, pages, or policies are appearing one by one and being trained as expected.