Assisted Buying

Assist your customers remotely by using the Assisted Buying feature.

Here you can find an overview of the Emporix Assisted Buying, along with its features and benefits.

• Looking for Management Dashboard guides? Check out the Sites and Customers guides.

• Looking for related API documentation? Check out the Site Settings Service, Customer Service, Orders Service and Returns Service.

Purpose

Assisted Buying is a feature focusing on providing faster and better customer support. Whenever customers have any issues with orders or just ask to act on their behalf, merchant employees can address their requirements in a convenient way.

Overview video

Features

Feature	Description
Activation on site level in Management Dashboard	Easy activation done by adding a relevant storefront URL to site settings.
Acting on behalf of the customer	The feature allows an employee to log in as a customer and perform specific actions on a storefront, for example: creating an order, returns or quotes.

Enabling and using the assisted buying

To enable the feature, you need to provide a storefront URL for each site where assisted buying should work. This can be done in the Management Dashboard UI, in Site Settings.

To see the details, check the Assisted Buying in Sites guide.

After enabling the feature for a specific site, you can now log in as a customer and perform the requested actions on their behalf.

The Assisted Buying functionality works only if the logged in user is a member of the support group.

1. In Management Dashboard, go to Customer Management -> Customers and choose the customer on behalf of whom you want to log in to the storefront.

2. In the Details view, open the Assisted Buying dropdown list and choose the site.

When you choose the site that you want to use, it opens a new browser tab with the storefront. You can now do any purchases that were requested by the customer.

Storefront implementation

When you log in to the configured storefront site, you're invoking the following request to authenticate as a customer:

Please note that the employee token is required to complete this request to assure that an authorized person logs in as a customer. The endpoint doesn't work with API key.

curl --location --request POST 'https://api.emporix.io/customer/{TENANT}/login' \
--header 'Authorization: Bearer 4eqtOqb8TUhWPz65m3sRa9PY4UWG' \
--header 'Content-Type: application/json' \
--data-raw '{
  "email": "",
  "password": ""
}'

The response includes the following details:

{
    "accessToken": "wOxp8G6vLiz3S2QYJMzRglFRRprI",
    "saasToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIwNjI0ODM3NiIsImV4cCI6MTY5Nzk1NjcyOX0.HYksa0G9LUXEfRx6DvFsugtcuv2FvC7QDbSQ51Aqr50",
    "expiresIn": 2591999,
    "refreshToken": "VmjmyVumjt5AD1WfN7nAp5kmfzcJAcgS",
    "refreshTokenExpiresIn": 86399
}

This information is visible in the URL and attached as query parameters, like in this example:

Storefront URL configured in Management Dashboard for the site:

https://storefront.emporix.io?tenant=MyTenant&clientId=StorefrontApiKey

URL of the storefront after you open the site:

 https://storefront.emporix.io?tenant=MyTenant&clientId=StorefrontApiKey&customerToken=wOxp8G6vLiz3S2QYJMzRglFRRprI&customerTokenExpiresIn=2591999&saasToken=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIwNjI0ODM3NiIsImV4cCI6MTY5Nzk1NjcyOX0.HYksa0G9LUXEfRx6DvFsugtcuv2FvC7QDbSQ51Aqr50

Set the values in your storefront and use them when making the https calls.