# Adobe Commerce (Magento 2)

*Last updated: May 15, 2026*

Connect Adobe Commerce to let Aissist read store data and run commerce actions.

Adobe Commerce is the integration.

Actions use Adobe Commerce during conversations.

With Adobe Commerce, Aissist can work with:

* customers and orders
* invoices, shipments, and returns
* products and inventory
* actions like password reset, address updates, and order cancellation

<details>

<summary>Create the Adobe Commerce integration</summary>

#### Step 1: create an access token

Follow Adobe’s guide for [integration tokens](https://developer.adobe.com/commerce/webapi/get-started/authentication/gs-authentication-token/#integration-tokens).

Allow at least these scopes:

* **Read Store**
* **Read Customer**
* **Read Invoices**
* **Read Orders**
* **Read Returns**
* **Read Shipments**
* **Read Credit Memos**
* **Write Orders**

Optional scopes:

* **Read Integration**
* **Read Inventory**
* **Read Product**

{% hint style="warning" %}
Enable **Allow OAuth Access Tokens to be used as standalone Bearer tokens** under **Stores → Configuration → Services → OAuth → Consumer Settings**.
{% endhint %}

#### Step 2: add the integration in Aissist

1. Go to **Workspace → Integrations**.
2. Click **Add Integration**.
3. Choose **Adobe Commerce**.
4. Enter:
   * a name for the integration
   * the Adobe Commerce store URL
   * the store code
   * the access token

Example:

* Name: My Magento Store
* Store URL: `https://yourstore.com`
* Store Code: `default`
* Access Token: paste your token

{% hint style="info" %}
The default store code is usually `default` unless your setup uses a custom value.
{% endhint %}

<figure><img src="/files/kkj16FoTe5nmsinZnKrk" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Default actions</summary>

The Adobe Commerce integration includes default actions for common workflows.

Use them when the built-in Adobe Commerce methods already match your workflow.

You can choose whether each action runs:

* at the start of a session
* during an interaction
* in both places

Each default action includes predefined descriptions and parameters.

Create custom actions only when you need store-specific logic.

</details>

<details>

<summary>Custom actions</summary>

You can also create custom Adobe Commerce actions.

If you do, turn off overlapping default actions to avoid conflicts.

#### Create a custom action

1. Select the integration then go to **Actions**.
2. Click **Add Action**.
3. Choose a method.
4. Give the action a clear name and description.

Available methods include:

* `getOrder`
* `getCustomer`
* `getCustomerOrders`
* `getInvoice`
* `resetPassword`
* `cancelOrder`
* `updateOrderAddress`

#### Configure the action

You can:

* choose whether it runs inbound or outbound
* customize parameters for your store logic

Use parameter descriptions that match your store rules.

Example store-specific guidance:

> order\_id: order IDs start with an `E` followed by 8 digits
>
> store\_code: use the Adobe Commerce store code, such as `default`

You can also add instructions for how Aissist should summarize large action responses.

<figure><img src="/files/VJRIH98slKsb6FjNrTug" alt=""><figcaption></figcaption></figure>

</details>

### Next step

After setup, test your Adobe Commerce actions in [Action Debugger](/integrations/action-debugger.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.aissist.io/integrations/adobe-commerce-magento-2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.