ZOA Configuration & Binding

Step 1: Obtain Zalo App Information

Prepare the ZOA (a Zalo Official Account that has completed business verification):
https://oa.zalo.me/manage/oa

Create a Zalo App in the Zalo Developer platform:
https://developers.zalo.me/apps

1. Log in to Zalo Developer platform

2. Select the corresponding Zalo App

3. Obtain the information: Zalo App ID & App Secret Key
   → These will be required later when performing embedded binding in NXLINK

4. Turn on In Operation in the upper-right corner.

Step 2: Authorize the ZOA with the Zalo App

Relationship between Zalo App and ZOA:

• One Zalo App can authorize and manage multiple ZOAs (as long as they have been authorized)

• One ZOA can be authorized to only one Zalo App

Authorization path:
https://developers.zalo.me/apps
Tool → API Explorer

Steps:

1. Select the corresponding Zalo App

2. Choose OA Access Token

3. Select the OA that needs to be bound

4. You will be redirected to the Zalo authorization page → Click Confirm to complete authorization between ZOA and Zalo App

5. You may check the authorization status on the OA platform:
https://oa.zalo.me/manage/oa

Step 3: Bind the ZOA with the Zalo App

A ZOA can be bound to only one Zalo App

Path:
https://developers.zalo.me/apps
Official Account → OA Management

1. Confirm that the OA has been successfully authorized to this Zalo App

2. Select the corresponding OA

3. Click Link to complete the binding

Step 4: Configure Domain Authorization & Webhook in the Zalo App

To obtain Domain, URL Prefix, and Callback URL, please contact the NXLINK team.

Domain Authentication

1. Enter the domain provided by NXLINK in the Domain Authentication section

2. Click Authentication to verify

3. Confirm that the authorized domain appears in the list below

URL Prefix Authentication

1. Enter the URL Prefix provided by NXLINK

2. Click Authentication to verify

3. Confirm that the authorized URL Prefix appears in the list below

Callback URL

Path: Official Account → General settings

1. Click Update

2. Enter the URL provided by NXLINK

3. Click Save to apply the configuration

Webhook URL

Path: Webhook

Configure the Webhook URL provided by NXLINK in the Webhook settings.

Step 5: Bind NXLINK with the ZOA

Relationship between ZOA and Tenant:

• One OA ID can only be bound under one NXLINK Tenant ID

Steps:

1. Go to Channel Settings → Zalo → Bind ZOA

2. Enter the customer's Zalo App ID and App Secret Key

3. A Zalo authorization page will appear → Select the OA ID under this App and click Confirm to complete binding.

(It’s recommended to keep the default permission settings; no changes are needed.)

4. After binding, return to the NXLINK page to view the bound ZOA ID
→ You may also click Unbind to remove the binding from the current tenant