> For the complete documentation index, see [llms.txt](https://docs.responso.com/responso-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.responso.com/responso-doc/en/integrations/integration-with-base.md).

# Integration with Base

The integration allows you to retrieve order information from Base, which is then assigned and displayed in the appropriate tickets in Responso.

## **Adding the integration**

The videos below will also help you through the steps.

1. **Log in to your Base account.**
2. From the left-hand menu, select the ***Integrations*** tab (plug icon), then click the ***Add integration*** button.
3. Type ***Responso*** in the search bar, then click the relevant tile.
4. Click the ***Activate*** button.
5. Close the window informing you that the integration has been added, hover over your account name in the top right corner, then click ***My account***.
6. Go to the API tab and in the ***API Tokens*** section click the ***Add API Token*** button.
7. Enter a name. Leave the permission level as Full. Click *Save*.
8. **Your token has been generated – copy it. Note: the API token is displayed and can be copied only once; once the window is closed, this will no longer be possible.**
9. **Log in to your Responso account.**
10. Click the ***Add channel*** button in the top right corner.
11. Select ***Base***.
12. In the window that appears, add the integration name and paste the API token copied earlier from Base. You can also decide whether Responso should display shipping labels for orders retrieved from Base and additional fields defined in Base (this option can also be set later).
13. Click ***Create***.

Your Base and Responso accounts are now integrated.

You can watch the integration process in the video below:

{% embed url="<https://responso.com/app/files/2022/07/bl-plugin.mp4?_=2>" %}
Activation of Responso Integration in Base
{% endembed %}

{% embed url="<https://responso.com/app/files/2022/07/BL-adding.mp4?_=1>" %}
Retrieve the API token from Base and add the integration in Responso
{% endembed %}

Your Base and Responso accounts are now integrated.

After successfully adding the Base account, order information from the past three months will begin to sync. Current orders are typically retrieved every 5 to 10 minutes.

{% hint style="warning" %}
To enable Responso to link customer messages with order information from Base, it is also necessary to integrate the email inbox that receives Base notifications with Responso.&#x20;
{% endhint %}

## Integration Features in Responso

### **Sidebar with Order Status Information**

After adding the Base integration, a collapsible ***Orders in Base*** tab will appear on the right side of the message view. If the Responso system has found related orders in Base for a given ticket, the information will be displayed here. Clicking on a given order will **open a new tab with that order in the Base panel**.

Responso also allows you to browse archived orders. If there are any archived orders associated with a given ticket, the *Orders in Base* tab will display the option to click ***Show orders from archive***.

![](https://responso.com/app/files/2022/07/image-1.png)

### Manual Status Change in Base from Responso

In the ticket view, on the right side, in the order information section, you can change the order status in Base by selecting the appropriate option from the drop-down list. This change made from within Responso will trigger the actions assigned to the selected status in Base. The list of available statuses is the same as the statuses in Base.

### Automatic Status Change for Returns in Base

Among the automatic actions available in Responso, you will find one that allows you to automatically change the status of an order in Base associated with a given ticket in Responso.

<figure><img src="/files/fHllbTQ88Og68vmBgLfx" alt=""><figcaption><p>Example workflow for automatic status change in Base.</p></figcaption></figure>

### **Downloading Labels for Orders and Returns**

In the ticket view, on the right side, in the order information section, we have added the option to download the label associated with a given order or return. You can also add the label as an attachment to a message to the buyer with a single click.

To enable this feature, go to the Base integration and click the toggle next to the *Show shipping labels for orders* option.

<div data-with-frame="true"><figure><img src="/files/3hNPPmibaPEsRuRMmhZk" alt=""><figcaption></figcaption></figure></div>

### **Adding a note to an order in Base**

Another feature enhancing the Responso and Base integration. You can now add a note to any order directly from Responso without having to log in to Base. The feature is available in the ticket view, in the order data section. The added content will appear in Base in the comments, under the "Order information" section.

## Integration Features **in Base**

### Receiving and Responding to Messages from Base

With the integration of Responso, you can extend the functionality of Base. After connecting the two platforms, you will have access to the Responso inbox directly within the Base panel. The Responso plugin will appear in the **Orders** tab on the left menu—no additional installation is required.

From within Base, you can browse the inbox, access tickets, respond to messages, and perform all other actions related to tickets. This means that from Base, you have access to all messages from various sources (all integrated with Responso).

{% hint style="info" %}
**Note:** For the Responso plugin in Base to work correctly, we recommend using Google Chrome or Mozilla Firefox. Logging in to Responso from Base using Google Chrome requires enabling third-party cookies. [Check here](https://support.google.com/chrome/answer/95647#third_party_temp) how to do it.
{% endhint %}

![](https://responso.com/app/files/2022/07/responso-in-bl-1024x496.png)

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

### Viewing Messages Related to a Specific Order

When navigating from the **Orders** list in Base to a specific order, you can view the Responso inbox window with messages filtered to show only those related to that particular order. This allows you to quickly access and manage all communications associated with the selected order.

<figure><img src="/files/0T4lJn2YX72asquwKVBL" alt=""><figcaption></figcaption></figure>

### Modifying the Default Filter

To make using Responso from within Base more convenient and tailored to your preferences, you can set a default filter for the inbox displayed in Base. This can be done in the **agent account settings** in Responso. By customizing the default filter, you can ensure that the inbox view in Base is aligned with your workflow and needs.

![](/files/dcfN7UMBuPCrDvOWcXE5)<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.responso.com/responso-doc/en/integrations/integration-with-base.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
