Magento 2 Integration
The Magento 2 integration uses a downloadable Magento module that handles both the chat widget injection and the API bridge. The recommended path is a one-command auto-installer that installs the module and completes the OAuth handshake for you, with no credentials to copy by hand. A fully manual install is also available as an advanced fallback.
Quick Install (recommended)
On the Magento integration page in AIChatVault, go to the Install Connector step. You'll see a one-line command with a Quick Install badge — copy it and run it from your Magento root directory over SSH or your host's terminal (e.g. cPanel Terminal):
Copy the install command
php <(curl -sL https://www.aichatvault.com/installer/magento/<your-secret>). The URL is unique to your agent and pre-filled with your webhook secret — no need to edit it.Run it from your Magento root
app/code/, enables the module, runs setup:upgrade, and clears Magento's caches — all in one pass, typically under a minute.OAuth completes automatically
Connection complete
Advanced: manual installation
If you can't run the one-line installer (e.g. restricted shell access, or you manage deployments through Composer only), you can install the module and connect by hand instead:
Download the module
Install the module
app/code/AiChatVault/Chatbot/.Enable and run setup
- •
php bin/magento module:enable AiChatVault_Chatbot - •
php bin/magento setup:upgrade - •
php bin/magento cache:flush
Verify installation
Activate the integration and copy credentials
Enter credentials in AIChatVault
https://yourstore.com) and all four OAuth values, then click Connect Magento Store. AIChatVault verifies the credentials and starts a background product sync.Available actions
| Action | Description |
|---|---|
| Product Search & Recommendations | Searches the Magento catalogue and shows product cards with images, prices, and Add to Cart links. |
| Order Status Lookup | Retrieves order status, tracking info, and purchase history by order number. |
| View Cart | Displays the customer's current cart contents, quantities, and totals. |
| Browse Categories | Browses Magento categories to help the AI find relevant products when keyword search returns no results. |
| Update Customer Profile | Lets signed-in customers update their name or email through chat. |
| Update Billing Address | Lets signed-in customers add or update billing addresses through natural conversation. |
| Compare Products | Shows a side-by-side comparison of up to 4 products the customer is considering. |
| Check Return Eligibility | Checks whether an order is still within your configured return window. Governed by the Return Policy panel on the integration page (return window in days, and any excluded product tags). |
| Check Discount Code | Validates whether a discount or coupon code the customer mentions is currently active. |
| Get Cross-Sell / Related Products | Suggests related products after the customer shows interest in an item. |
Widget injection
The installed Magento module automatically injects the AIChatVault widget on all storefront pages. No manual theme editing is needed. The module reads your agent's slug and loads the correct widget configuration.
Product sync
A product sync runs automatically when you first connect. The integration page shows the synced product count and last sync timestamp. Click Sync Products to trigger a manual sync after catalogue updates.
Disconnecting Magento
Clicking Disconnect in AIChatVault removes the stored credentials and clears synced products from the knowledge base. To also remove the widget from your store, disable or uninstall the Magento module via php bin/magento module:disable AiChatVault_Chatbot.
Was this page helpful?