Skip to main content


Zalo is an instant messaging application that allows you to send text messages, create and join group chats, and share photos, videos, and audio. This app was developed by VNG Corporation, a Vietnamese technology company. It is supported on both iOS and Android devices.

Businesses can use Zalo to communicate with their customers, respond quickly to customer inquiries, provide customer support, promote their brand by sending promotional offers, and host virtual meetings with colleagues and customers.

In this article, you will learn:

Create Zalo official account

  1. Go to Zalo website and click Create Official Account now.

  2. Choose the account type that you wish to create. Click Enterprise as the account type.

  3. Click Register to proceed further.

  4. Select the required subcategory, enter your business details, and click Create an OA account.

  5. Verify the information that you provided and click Confirm to register your official account.

  6. After registering for an OA account and submitting the authentication profile, Zalo OA BQT will verify the account information and respond within 7 working days.

Setup Zalo channel using developer portal

To set up a Zalo channel using the developer portal, use this link. Once your channel is set up in the developer portal, you can get the OA server key and Access token ID to connect your bot to the Zalo channel.

To setup Zalo channel using developer portal, follow these steps:

  1. Login to the developer portal using the URl

  2. Select your Official Account and click Link.

  3. You need to enable all the required permissions.

Configure Webhook on Zalo channel

After connecting to your official account on the developer portal, you need to setup a Webhook on the Zalo. Enter the Webhook URL shared by the product team to test your bot on the Zalo channel.

To configure Webhook on Zalo, follow these steps:

  1. Click on Webhook, and enter the URL shared by the product team.

  2. You can enable all the required permissions based on your requirements.

  3. Copy the OA Secret Key.

  4. Navigate to Settings tab and copy the App id.

  5. Select API Explorer from the Tools drop-down.

  6. Select OA Access token from the Access token type drop-down.

  7. Select your account from the Lay Access Token.

  8. Agree to allow the application to manage the Official Account and click Allow.

  9. Copy the Access token.

Add DNS TXT record to verify Webhook URL domain

In order to verify the Webhook URL domain, you need to add Zalo DNS TXT to's domain.

To verify the Webhook URL domain, follow these steps:

  1. Select Domain Authentication and enter a domain based on the bot region, for example, or Click Accuracy.

  2. If your domain is not verified, click Verify now.

  3. Copy the content value to establish the connection between the Zalo channel and your bot on the platform.

  4. Once your bot is connected to Zalo, open the following link and keep it active for 10–20 minutes in a browser window:<botID>

    To create the above URL, follow these steps:

    1. Expand Upload an HTML file to your website drop-down and copy the highlighted query path.

    2. Enter the domain (for example, that you have specified during the verification and paste the copied query parameter (zalo_verifierVzQC6wkaBK1jshzBv_ibOnRbZKpwcbmMDpG.html).

    3. Append your bot ID as a Parameter (bot=<botID>) to the URL.

  5. Go back to Domain Authentication, enter your domain in the input field to verify your domain, and click Accuracy.

  • Your domain will be successfully verified.


Connect Zalo channel to your bot

To connect the Zalo channel on the platform, follow these steps:

  1. On the left navigation bar, click Extensions.

  2. Click Channels > Messaging > Zalo.

  3. Enter the OA server key, Refresh token, App ID, and Zalo DNS TXT that were copied from the developer portal, and then click Save

  4. Your Zalo channel will be successfully connected.


If you don't use your bot for 3 months, the "refresh token" will expire. You'll get an email asking you to manually reset the "refresh token" in the Zalo developer portal. Once you reset it, a new "refresh token" will be created. You can add this token to our platform to reconnect your bot

Test your bot on Zalo

After configuring Webhook, you can test your bot on the Zalo channel and you can start responding to the user queries.

To test your bot on Zalo, follow these steps:

  1. Navigate to your Official Account

  2. Click Manage > Account Management > account information. In this section, you can see the QR Code.

  3. Scan the QR Code to chat with your bot. Click on message to start testing with your bot.

  4. Once you have tested your bot, the configuration of the Zalo channel for your business is completed.