Adobe Commerce (Magento 2)

Introduction

Aissist can seamlessly connect with Adobe Commerce (Magento 2), allowing it to access key store data like orders, shipping, returns, and inventory.

Adobe Commerce - Setup at a glance

Step	Action	Details
1	Generate Access Token in Adobe Commerce	Follow Adobe’s guide to create a token. Make sure required read scopes are selected (Store, Customer, Orders, etc.).
2	Allow Standalone Token Usage	Enable your OAuth token to be used as a Bearer token for API access.
3	Add Integration in Aissist	In Workspace → Integration, click Add Integration, select Adobe Commerce, and input your store URL, store code, and access token.
4	Use Default Smart Actions	Default Smart Actions (like order lookup and customer search) are ready to use. You can control when they trigger (session start, interaction, or both).
5	Create Customized Smart Actions (Optional)	Build custom actions like getOrder, getCustomer, or getCustomerOrders for more specific workflows.

---

⚡ Quick Tips

• ✅ Always save your access token securely after creation.

• ✅ Default store code is usually "default" unless customized.

• ✅ Customize Smart Actions to better align with your business needs!

🚀 How to Set Up Adobe Commerce Integration

Step 1: Generate Your Adobe Commerce Access Token

Follow Adobe’s official guide: Create an Integration and Access Token

✅ When setting up the token, make sure you allow at least the following scopes:

• Read Store

• Read Customer

• Read Invoices

• Read Orders

• Read Returns

• Read Shipments

• Read Credit Memos

• Read Integration (optional)

• Read Inventory (optional)

• Read Product (optional)

• Write Orders

📢 Important: You must also allow the token to be used as a standalone Bearer Token by setting the Stores > Configuration > Services > OAuth > Consumer Settings > Allow OAuth Access Tokens to be used as standalone Bearer tokens option to Yes

---

Step 2: Connect Adobe Commerce to Aissist.io

1. Log into your Aissist.io account.

2. Go to Workspace → Integration from the side panel.

3. Click "Add Integration" and select Adobe Commerce.

4. In the setup window, enter:

   • Integration Name

   • Adobe Commerce Store URL

   • Store Code (default is "default")

   • Access Token you created in Step 1

🔵 Example Setup:

• Name: My Magento Store

• Store URL: https://yourstore.com

• Store Code: default

• Access Token: (paste your token here)

🧠 Default Smart Actions with Adobe Commerce Integration

When you set up the integration, several Smart Actions are automatically ready for use.

• You can control when each Smart Action is triggered:

  • At the beginning of a session

  • During user interaction

  • ✅ It’s completely fine to enable both options for a specific action!

Each default Smart Action includes a predefined description and parameters to get you started easily. If needed, you can customize these actions to better fit your business needs

🛠️ Creating Customized Smart Actions

The default Smart Actions cover most needs, but you can also build your own custom Smart Actions for specific workflows.

Here’s how:

1. From the Aissist dashboard, go to Workspace → Action.

2. Click "Add Action" and then choose your Adobe Commerce integration.

3. In the Smart Action Builder window, fill in:

   • Choose a method from the list

   • Input Action Name and Description

   • Associate with Sub-Agents: You can link the action to a Sub-Agent for specific scenarios.

   • Decide When to Run: Choose to run the action at the beginning of a session or during the interaction — or even enable both.

   • Select Action Trigger to be inbound, outbound or both

     • Inbound means a user's input message triggers this action

     • Outbound means Aissistant's reply triggers this action

     • Both means both direction can trigger this action

   • Customize Parameters: You can add specific details about your shop’s setup. Example:

     “Our order IDs start with an 'E' followed by 8 digits” “Order IDs are usually 10 digits long”

   • Returning and Summarizing Information

     You can also add instructions to explain the type of information the action returns. If the response contains a lot of data, you can guide Aissistant to summarize it and extract only the important details needed for user responses

🛒 Currently supported methods:

• getOrder: Retrieve complete order details using an Order ID.

• getCustomer: Retrieve customer information using their email.

• getCustomerOrders: Retrieve a customer’s full order history using their email.

• getInvoice: Retrieve a customer's invoice using an Order ID and email.

• resetPassword: Reset user's email password

• cancelOrder: Cancel a user's order

• updateOrderAddress: Update the order address

This allows you to tailor Aissistant’s capabilities to exactly what your business needs!

---

By connecting Adobe Commerce to Aissist, you can give your AI powerful access to order, customer, and inventory data — all while preparing for even more automation in the near future! 🚀

After setting up the Adobe Commerce integration and actions, you can use the Action Debugger to test and verify that everything is working correctly.