Get started with Zalo OA on HexaSync

This guide explains how to connect Zalo Official Account (Zalo OA) to HexaSync to create a Zalo OA Connector App on HexaSync Automation Engine. When you are done, you can check the user and message data pulled from Zalo OA directly on HexaSync.

This setup is also the preparation step for solutions such as integrating Zalo OA with Freshchat or integrating Zalo OA with Zendesk.

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 Zalo account with admin permission on the Zalo OA you want to connect. If you do not have an OA yet, follow the guide to creating a Zalo Official Account (in Vietnamese).
• A verified Zalo OA on the Tăng trưởng (Growth) or Toàn diện (Comprehensive) plan. According to the Zalo OA plan benefits table (in Vietnamese), linking an app to an OA through the API requires one of these two plans.

Note: The access and event groups depend on the permissions Zalo shows at the time you authorize. Check the permission list before you confirm.

Part 1: Authorize the Zalo OA 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 Zalo OA connection

1. Open the Zalo OA authorization page on HexaSync.
2. Select the Zalo OA Connector App you want to set up.
3. On the Check connection details screen, check the status of Zalo OA.
4. When the status shows Not connected, select Connect.

Step 3: Choose the guide language

1. On the Choose your language screen, select Tiếng Việt or English.
2. Select Submit to continue.
3. The following screens use the language you selected.

Step 4: Confirm the app used to connect

1. On the Choose an app to connect to Zalo OA screen, check which app is selected.
2. By default, HexaSync shows [Zalo OA] HexaSync Connector, provided by Beehexa.
3. Select Continue to use this app.
4. If you need to use a different app, select Use a different app before you continue.

In this guide, [Zalo OA] HexaSync Connector is the app that Zalo authorizes; the Zalo OA Connector App is where you manage the connection, tasks and data on HexaSync.

Step 5: Authorize access to the Zalo OA

1. After you continue, you are taken to the Zalo authorization screen.
2. Check which Zalo OA is selected.
3. Check the list of API usage permissions and event permissions that the app requests.
4. Read and agree to the terms shown on the Zalo screen.
5. Select Cấp quyền (Authorize) to allow the app to access the Zalo OA.

Zalo describes this mechanism as authorizing a Zalo App to call APIs and receive events. See also the Zalo OA documentation on creating an app and authorizing it (in Vietnamese).

Step 6: Check the connection status

1. After the authorization succeeds, you are taken back to HexaSync.
2. Check that the Zalo OA status has changed to Connected.
3. Check the credential that was just created for the connection.
4. If you need to authorize again, select Re-authorize.
5. Select Create Zalo OA Connector to continue.

Step 7: Name the Zalo OA Connector App

1. At the step that creates the Zalo OA Connector App, the interface shows the Enter Profile Name screen.
2. In the Name field, enter a name that makes the Zalo OA Connector App easy to recognize.
3. Check the text in the Description field.
4. Select Continue to finish the creation process.

The name should clearly tell each Connector App apart if you manage several Zalo OA connections.

Step 8: Finish the Zalo OA Connector App

Open the Zalo OA Connector App you just created and check Tasks. The configuration in this guide has two tasks:

• Messages for Zalo OA message data.
• Users for Zalo OA user data.

Part 2: Check the Zalo OA data on HexaSync

Step 1: Check Metrics

1. Open Metrics in the Zalo OA Connector App.
2. In the Messages group, check Total Messages and the Outbound and Inbound counts.
3. In the Users group, check Total Users.

These figures help you confirm that the Zalo OA data has been recorded on HexaSync.

Step 2: Check the Messages data

1. Open Tasks.
2. Select the Messages task.
3. Open Data.
4. Check the message data fields that are shown, for example:

message_id
user_id
direction
type
message
time
source

Step 3: Check the Users data

1. Go back to Tasks.
2. Select the Users task.
3. Open Data.
4. Check the Zalo OA user records, including user_id, the data status and the Last Seen time.

Part 3: Frequently asked questions

How do I connect Zalo OA on HexaSync?

The process has eight steps: sign in to HexaSync, open the Zalo OA authorization page and select Connect, choose the guide language, confirm the [Zalo OA] HexaSync Connector app, authorize access to the Zalo OA on the Zalo screen, check the Connected status and select Create Zalo OA Connector, name the Zalo OA Connector App, then open the Connector App and check the tasks, Metrics and data.

Which types of data does HexaSync get from Zalo OA?

In the configuration described in this guide, the Zalo OA Connector App has two main tasks, Messages and Users. You can check the message records and the user_id of users in the matching task.

Does HexaSync send or write data back to Zalo OA?

Not in the configuration described in this guide. The default configuration is read-only, to get data for monitoring and for processes on the HexaSync side. Always check the permission list on the Zalo screen before you authorize.

Why connect Zalo OA on HexaSync?

When you are done, you can check the user and message data pulled from Zalo OA on HexaSync. This connection is also the preparation step for solutions such as Zalo OA with Freshchat and Zalo OA with Zendesk.

What conditions does a Zalo OA need to meet to connect?

The Zalo OA needs to be verified and on the Tăng trưởng (Growth) or Toàn diện (Comprehensive) plan to link a third-party app through OpenAPI. Plan policies and benefits can change; check the current Zalo OA pricing (in Vietnamese) before you set up.