Get started with Sapo OmniAI on HexaSync

This guide explains how to connect Sapo OmniAI to HexaSync to get data from a Sapo store. The data is used to assess the quality of product and inventory data, and to check the data before you connect to another system.

Before you start

• A Beehexa account to access HexaSync Automation Engine. If you do not have one yet, sign up on the same page.
• A Sapo account with the store owner role for the store you want to connect.
• The Store URL of the Sapo OmniAI store, in this format:

hexasync-demo-store.mysapo.net

Note: A Store URL that ends in mysapogo.com belongs to Sapo Omni V2, not Sapo OmniAI. Sapo defines Sapo Omni V2 and Sapo OmniAI (V3) as two separate platforms with no direct upgrade path. If you use Sapo Omni V2, see the official guide to Sapo Omni V2 (in Vietnamese) and contact Sapo to choose a suitable option.

Part 1: Authorize the Sapo OmniAI connection on HexaSync

Step 1: Sign in to HexaSync

Go to HexaSync Automation Engine and sign in with your Beehexa account.

Step 2: Start the Sapo OmniAI connection

1. Open the Sapo OmniAI authorization page on HexaSync.
2. On the Check connection details screen, select Connect in the Sapo OmniAI row.

Step 3: Confirm the HexaSync Connector app

Select Continue to confirm that you want to use the HexaSync Connector app.

Step 4: Enter the Sapo Store URL

1. Enter the Store URL of the Sapo OmniAI store you want to connect, for example hexasync-demo-store.mysapo.net.
2. Select Continue.
3. Check the API permissions that the app requests.
4. Continue to the Sapo OmniAI store to authorize the installation of the HexaSync Connector app.

Step 5: Authorize access to the Sapo OmniAI API

1. On the Sapo authorization screen, check the list of permissions that the HexaSync Connector app requests.
2. Select Cài đặt (Install) to allow the app to be installed.
3. When HexaSync shows the message that the connection succeeded, select Create Sapo OmniAI Connector.

Sapo also recommends that users check the access permissions before installing an app. The authorization process with a Store URL and the permission request screen are described in the guide to installing apps on Sapo OmniAI (in Vietnamese).

If Sapo reports insufficient permissions

If HexaSync shows the message HexaSync Could Not Verify The Stored Credential, check whether the Sapo account you are using is the store owner, then try to authorize again.

Step 6: Finish the Sapo OmniAI Connector on HexaSync

1. After the Sapo authorization succeeds, continue with the step that creates the Sapo OmniAI Connector.
2. Open Connector Apps to check the connector you just created.
3. HexaSync starts getting data from the connected store. Checking the data and showing the results can take up to 30 minutes; the results are sent to the administrator.

Part 2: Re-authorize the Sapo OmniAI connection

If you have already created a Sapo OmniAI Connector and need to re-authorize the store, follow these steps.

Step 1: Open Settings in the Sapo OmniAI Connector

Open the matching connector in Connector Apps, then select Settings.

Step 2: Select Re-authorize

In Settings, find the Sapo credential and select Re-authorize. Only the owner of the credential can re-authorize.

Step 3: Confirm the Sapo Store URL again

Follow the instructions on the screen to confirm the Store URL and re-authorize, in the same way as when you connect a new Sapo OmniAI store.

Part 3: Frequently asked questions

Does this guide apply to a Sapo Store URL that ends in mysapogo.com?

No. The mysapogo.com suffix belongs to Sapo Omni V2; this guide applies to Sapo OmniAI, which Sapo also calls version V3.

Which Sapo account should I use to authorize the connection?

Use the store owner account of the store you want to connect. If HexaSync shows HexaSync Could Not Verify The Stored Credential with the message You do not have enough permissions, check the role of the account, then authorize again.

How do I connect Sapo OmniAI on HexaSync?

The process has six steps:

1. Sign in to HexaSync.
2. Select the Sapo OmniAI connection.
3. Confirm the HexaSync Connector app.
4. Enter the Sapo Store URL.
5. Authorize the HexaSync Connector to access the Sapo OmniAI API.
6. Create the Sapo OmniAI Connector.

Which data does HexaSync get from Sapo OmniAI in this flow?

Within the permissions shown when you install the app, the HexaSync Connector gets product, inventory, order and customer data to check data quality and prepare for the connection.

Does HexaSync write or change data on Sapo OmniAI automatically?

Not in the flow described in this guide. The HexaSync Connector only reads the data groups listed above, under the permissions the user approves. Always check the permission list on the Sapo screen before you install.