Deploy on Shopify

Hilal Chatbot ships as a Shopify app. Install once, the chat widget appears on every storefront page, and the bot has access to product, order, and inventory context (with appropriate AI Actions enabled).

In this guide:

• Install from the App Store
• Authorize and link to your Hilal Chatbot account
• Pick which chatbot powers the storefront
• Configure storefront placement
• Uninstall

Step 1: Install from the Shopify App Store

In your Shopify admin, search the App Store for Hilal Chatbot and click Install. Shopify shows the permissions the app requests:

• Read product data — for the bot to answer “do you have X?”
• Read order data — for order-status questions (with AI Actions enabled).
• Storefront extension — to embed the widget.
• Optional write scopes for write-back actions like cancel/refund — only requested if you enable Shopify write-back actions (New).

Click Install app.

Screenshot: The Hilal Chatbot Shopify app installation confirmation.

Step 2: Authorize and link

After installation, Shopify redirects you into the Hilal Chatbot embedded app. Sign in with your Hilal Chatbot account (or create one) and approve the link between your Shopify store and your Hilal Chatbot organization.

The link is one-to-one: a Shopify store can be connected to one Hilal Chatbot organization at a time.

Step 3: Pick which chatbot powers the storefront

The embedded app shows your organization’s chatbots. Pick the one that should power this storefront. You can change this later from the Hilal Chatbot embedded app.

Step 4: Configure storefront placement

By default, the widget appears on every page of your storefront, in the position you set on the chatbot’s Appearance tab. To restrict where it appears:

• Theme blocks: in your Shopify theme editor, the Hilal Chatbot widget block is added to your theme. Drag it into specific templates only (e.g., product pages, FAQ).
• Custom rules: contact support for advanced URL-based exclusions.

Step 5: Verify

Open your storefront in an incognito window. The widget should appear on every page where the theme block is enabled. Send a test message — it should answer using your trained knowledge plus, if Shopify actions are enabled, real product/order data.

Step 6: Uninstall

To remove the app:

1. In your Shopify admin, navigate to Apps → Hilal Chatbot → Uninstall.
2. Shopify revokes the OAuth tokens automatically.
3. Optionally, in the Hilal Chatbot dashboard, remove the deployment row to clean up.

Uninstalling does not delete your Hilal Chatbot organization or its chatbots — those persist for re-install or use elsewhere.

Limitations

• Storefront-only embed. The widget appears on the public storefront, not inside the Shopify admin.
• Single-store-per-org. A Hilal Chatbot organization can connect to one Shopify store. Multi-store setups need multiple organizations.
• Theme compatibility. Most themes work out of the box. Older or heavily-customized themes may need manual block placement.

Troubleshooting

• Widget doesn’t appear after install. The theme block may not be enabled. In Theme editor → App embeds, toggle the Hilal Chatbot widget on.
• “Failed to authorize” during install. Pop-up blocker; allow myshopify.com and hilalsoftware.tools and retry.
• Storefront says “Connection error.” The app may have lost its OAuth. Reinstall from the Shopify App Store.

What’s next