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.

PreviousIntegrationsNextMessenger Integration

Last updated