# 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**.

<details>

<summary>Adobe Commerce - Setup at a glance</summary>

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

***

## ⚡ 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!

</details>

<details>

<summary>🚀 How to Set Up Adobe Commerce Integration</summary>

#### Step 1: Generate Your Adobe Commerce Access Token

Follow Adobe’s official guide:\
[**Create an Integration and Access Token**](https://developer.adobe.com/commerce/webapi/get-started/authentication/gs-authentication-token/#integration-tokens)

✅ 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)

<figure><img src="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2FTCDJFQbtWaeWkLvs2Jj3%2FScreenshot%202025-04-26%20at%202.37.45%20PM.png?alt=media&#x26;token=fba95010-034d-471a-88cc-048c910f05ec" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>🧠 Default Smart Actions with Adobe Commerce Integration</summary>

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

</details>

<details>

<summary>🛠️ Creating Customized Smart Actions</summary>

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!

<figure><img src="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2FJCrem0UwduIVYI5Cald7%2Fscreencapture-console-aissist-io-workspace-actions-8b865f4a-cb01-4271-b46f-91089dcb397b-2025-04-26-14_44_33.png?alt=media&#x26;token=69769d40-261d-4a95-ac84-d23d688231a5" alt=""><figcaption></figcaption></figure>

***

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! 🚀

</details>

After setting up the Adobe Commerce integration and actions, you can use the [**Action Debugger**](https://doc.aissist.io/integrations/action-debugger) to test and verify that everything is working correctly.