Zalo Integration

Step 1: Create an OA account

You need an OA account to use the functions on the OA API system.

If you don't have an OA account, you can create a new one here.

After clicking "here", you will be redirected to the link as shown above

Click Create a new Official Account

Select account type according to type of your business or organization

Click To choose

Click Register

The system displays the screen to declare information

Fill out information on this area

Click checkbox to agree the term of use and click Create an OA account

Click Confirm to register for an Official Account

A success or failure message will be returned, followed by Authentication start

Here there will be 3 types of authentication, upload the required documents

After uploading the required documents, OA will be in "Waiting for approval" status

Note*: After initialization, OA will undergo Zalo system approval before use. Expect activation in 1-7 working days.

Step 2: Create an app to link to OA

In order to use the functions of the OA API, OA will be accessed through a specific application that has been authorized to represent it. Depending on the type and purpose of the service required, an OA can authorize multiple applications.

To create an app, please access here and log in with your Zalo account.

After being transferred at the link above, click "Add new apps"

After clicking 'Add new apps', the user will be directed to the screen shown above, fill in the appropriate information and then click "Create an application ID"

Enter Contact Phone and Contact Email, then click Save changes

Click on toggle to activate the application

Click Agree to activate the application

The application is activated successfully

• Get Zalo App ID

Click to copy Application ID

At the Zalo Integration pop-up, paste the copied text into the Zalo App ID field

• Get App Secret Key

Click to copy Application Secret Key

At the Zalo Integration pop-up, paste the copied text into the App Secret Key

• Get OA ID

Access Zalo OA at here.

Click to 'Danh sách OA của tôi' to display the OA List

Copy OA ID to integrate Chatbot

At the Zalo Integration pop-up, paste the copied text into the OA ID

• Get Access Token

Click Application management

At Tool -> select API Explorer

Click and select the right app to integrate

At Type of access token, select OA Access Token

Click Get Access Token -> select your correct OA account

Tick on Agree to allow the application to manage Offcial Account -> click Allow

Click to copy Access Token

At the Zalo Integration pop-up, paste the copied text into the OA Access Token

• Get OA Refresh Token

Click to copy Refresh Token

At the Zalo Integration pop-up, paste the copied text into the OA Refresh Token

• Get Domain Authentication

Click on Profile -> Choose appropriate application

Click Domain Authentication on menu side-bar

At the Zalo Integration pop-up, click to copy Callback URL

Paste the copied URL into the Domain, delete the text behind, keep only the domain as shown -> click Accuracy

The system will display a pop-up -> click Verify now

The system displays a Authenticate pop-up -> at Upload HTML file to your website -> click to download file

At the Zalo Integration pop-up, click Browse Files

Downloaded file has been chosen

Back to screen https://developers.zalo.me/, the system display messege "Verify successfully" -> Click OK

• Update Webhook

Click to copy Callback URL

Click Change at Webhook screen

Paste the copied URL into the Webhook URL field -> click Update

The interface is displayed after updating the Webhook URL -> activating the items that need to be displayed

When you want to display messages in the form of images, audio, attachments, and stickers from conversations with users in Livechat, when integrating with Zalo, you need to activate the following Webhook permissions:

• To Display Link -> Activate Sự kiện người dùng gửi tin nhắn liên kết

• To Display text messages -> Activate Sự kiện người dùng gửi tin nhắn text

• To Display sticker -> Activate Sự kiện người dùng gửi tin nhắn sticker

• To Display gif -> Activate Sự kiện người dùng gửi tin nhắn gif

• To Display audio messages -> Activate Sự kiện người dùng gửi tin nhắn voice

• To Display attached files -> Activate Sự kiện người dùng gửi tin nhắn đính kèm file

Search for commands in Webhooks

Status after activating necessary categories

Activate Zalo

Click Save to complete the integration and fully integrate Zalo.